Mac App Reference

The detail behind Mac & Mobile Apps.

Windows and links

Only Klipeo's own pages open in the app window. Any other site, including a sign-in or consent page when you connect an app, YouTube, TikTok, or GitHub, opens in your default browser, and the app comes back to the front when the connection finishes.

The native editor

The Mac app is not the web editor in a frame. Every navigation to an /editor/ URL is intercepted and opens the native editor instead. Adding ?desktopNative=0 to the URL is the only way to get the web editor back.

The native editor is capability gated by an explicit allowlist. It covers composition settings, tracks, video, image and audio clips, static text titles, trimming, track controls, transforms, crop, opacity, blend modes, retiming, groups, markers, bookmarks, guides, proxy media, and Vibe patches. It plays keyframes on a video or image clip's position, size, rotation, scale, and opacity, with every easing the web editor offers, and all twenty clip transitions: fades, slides and the push, wipes, the iris, zooms, the spin, and the stylized washes. It also draws screen recording zooms, including auto zooms that follow the cursor, and the recording frame: padding, rounded corners, drop shadow, and a wallpaper that is a color, a linear or radial gradient, or an image. Keyframes on any other property (such as volume or color), keyframes or transitions on an audio clip or a title, effects, masks, subtitles, animated text (typewriter, karaoke, and entrance animations), adjustment layers, the cursor overlay, keystroke badges, zoom motion blur, the zoom spotlight, the frame inset, device mockups, window frames, film grain, and shadow overlays are not on the list, so a composition that uses any of them opens in the web editor instead.

The native editor draws a title the way the web export does, including its box, the outline and shadow text effects, and underline or strike-through. Roboto, the default title font, ships with the app. Any other font must be installed on the Mac in the title's weight and style. A title in a font the Mac does not have, with a character its font lacks, or with right-to-left text opens in the web editor. To add a title at the playhead, click Add title in the Text tab, or in Inspect with nothing selected. Inspect edits a title's text, size, color, and alignment; the other text styles are in the web editor.

In the native inspector, a diamond beside position, size, rotation, scale, and opacity adds or removes a keyframe at the playhead, and the arrows beside it jump to the previous or next keyframe. Changing an animated value keys the playhead. The Transitions section sets a clip's in and out transition and its length, and Cmd+T adds a cross fade at the selected clip's cuts, or at the cut nearest the playhead when nothing is selected.

The native timeline measures time in timecode, HH:MM:SS:FF. At 29.97 and 59.94 fps it uses drop-frame timecode, written HH:MM:SS;FF. To jump to a point, click the large timecode above the track headers, type a timecode or a frame count, and press Return. Escape leaves the playhead where it was.

Clicking a media item makes it the source clip; double-clicking it opens it in the viewer's Source tab, where you mark In and Out points and play it on its own. Insert, Overwrite, Replace, Place on Top, and Append edit the marked range into the timeline using DaVinci Resolve's three-point rules. See Source viewer and three-point editing.

Track headers target edits the way DaVinci Resolve's do:

• The V or A badge on a video or audio track is its destination control. Click it to patch that source to the track. The blue V badge and the green A badge mark where Insert, Overwrite, Append to track, and Paste put video and stills, and audio. With no track patched, V1 and A1 are the destinations.
• The target icon at the end of each header is Auto Track Select. When it is on, an insert, a ripple delete, or the Spacer tool on another track also moves this track, so it stays in sync. A ripple delete leaves a track in place when a clip on it overlaps the removed time. Turn Auto Track Select off to keep a music bed or a title where it is. The track an edit lands on always moves.

Both settings are saved with the composition, and the web editor keeps them.

What the Mac app adds

What the Mac app adds over the browser:

• Notifications when work finishes while Klipeo is closed or in the background: an export is ready or failed, or the agent finished or stopped. Click one to open that project. macOS asks once for permission; turn them off in System Settings › Notifications › Klipeo.

• Native screen recording. Every Record button opens a Choose what to record window with a card per source, your cameras and microphones by name, and a button for each macOS permission still missing. The recorder captures the screen, a window, or an area you draw, and writes a sidecar file with the exact cursor position, every click, keyboard shortcuts, and where the text caret is while you type. The editor reads that file, so auto-zoom follows your real cursor and your typing, and click effects land on the right frame. The macOS pointer is left out of the video and drawn by the editor, at the size and style you choose. A native teleprompter scrolls your script while you record and stays out of the recording. See Screen Recording.

• A Hide desktop icons switch in the recorder settings, for a clean desktop in a demo.

• DaVinci Resolve-style playback in the native editor: J, K, and L shuttle in either direction at up to 8x, the viewer can play in reverse and loop between the in and out points, and Play In to Out is in the Playback menu. See Keyboard shortcuts.

• A source viewer with its own In and Out points, and Resolve's edit keys: F9 Insert, F10 Overwrite, F11 Replace, F12 Place on Top, and Shift+F12 Append. Q switches the viewer between the source clip and the timeline.

• Keyboard trimming: V selects the nearest edit point, U picks its side, , and . trim it a frame at a time, and E extends it to the playhead. The Trim tool (T) picks ripple, roll, slip, or slide from where you grab a clip, and Dynamic Trim (W) trims the edit with J, K, and L. See Trimming from the keyboard.

• Local Vibe engines without the bridge. The app finds Claude Code, Codex, Gemini CLI, OpenCode, Cursor, Grok, and Devin on your Mac and runs them with your own subscription. See Engines & Models.

• A This Mac group in Settings (⌘,): your agents and their sign-in state, the macOS permissions the recorder needs, how much disk the media cache uses (with Clear buttons per kind and a "not opened in 7, 30, or 90 days" clean up), and the installed app version. The same pages open natively with Klipeo › Mac Settings… (Option-Command-,), even before the web app loads.

• A real window with its own Dock icon and menu bar. Closing the window hides it and keeps your pages loaded; click the Dock icon to bring it back as it was. Quit with Cmd+Q. The next launch reopens the page you were on, at the same window size and position, in full screen if you left it there. Sign-in pages are never reopened.

• Menu bar shortcuts: Cmd+N creates a project, Cmd+1 to Cmd+9 open the app pages in order (Home, Templates, Mini Apps, Brand Design, Social, Projects, Recordings, Connectors, Marketplace), Cmd+F opens search, Cmd+, opens Settings, and Cmd+[ and Cmd+] go back and forward. Cmd+W closes a tab, or hides the window when only one tab is open.

• File › Open Recent and the Dock icon's menu list the last 10 projects and compositions you opened.

• Notifications and Dock progress. An export shows a progress bar on the Dock icon. When an export or a Vibe run finishes while Klipeo is in the background, a notification says so and the Dock icon counts it until you come back. macOS asks for permission the first time. A native editor export's notification has Show in Finder and Share… buttons, and its Export menu has Share… too.

• Spotlight. Projects and compositions you open in the app show up in Spotlight by name, and choosing one opens it in Klipeo. Signing out removes them.

• Links for Shortcuts and launchers. Use them with the Shortcuts Open URL action: klipeo-desktop://record opens the Record window, klipeo-desktop://recent reopens the last project or composition you opened, and klipeo-desktop://open?path=/projects/12 opens any Klipeo page.

• Files from Finder. Drag them onto the media panel or the composer, as in a browser, or copy them in Finder and press ⌘V in the composer. A file dropped anywhere else does nothing.

Updates and offline use

The app checks for a new version every few hours and installs it with Install Update or Klipeo → Check for Updates…. Web-only changes arrive with the web deploy: a window left open picks up a new deploy on its next page change, without a manual reload. The Swift code and the native editor change only with an app update.

The app needs the internet to load your projects. When it can't reach Klipeo, it shows You're offline and reloads the page on its own once your Mac is back online; Try again (⌘R) does it right away. A page that is already open keeps showing your projects and chats from the last visit while you're offline and refreshes them when the connection returns. Creating, renaming, moving, or deleting a project or chat needs a connection, and says so if you try it offline. If a page stops responding and WebKit ends it, the app reloads that page once on

Android app details

Android's Back button closes an open sheet, dialog, or menu first, then goes back through the pages you opened. On Home, Back leaves the app. While you type, the composer and chat box stay above the keyboard. The composer's Camera tile lets you take a photo or record a video with your phone's camera app.

Klipeo links open in the app. When you tap a klipeo:// link, or a project, editor, invitation, or settings link on klipeo.com that Android hands to the app, Klipeo opens that page once you are signed in. If you need to sign in or finish setting up your account first, the page opens right after.

Downloads work inside the app. When you download an export, a render, a mini-app result, subtitles, a transcript, a timeline file, or a file Vibe made, the app copies it to your phone and opens the share sheet, where you can save it or send it to another app. A notice at the bottom of the screen shows progress for a large file. The app saves video, audio, image, subtitle, text, PDF, timeline, Lottie, and project files up to 1 GB. If a notice says a file can't be saved, open Klipeo in your phone's browser and download it there.

The introductory tour includes native demonstrations that remain available when the embedded web demonstrations cannot load. After Google or another provider returns to the app, Klipeo checks the session before opening your account. If that check fails, the sign-in sheet shows a message so you can try again. Android uses the native Google account picker. On a phone without Google Play services, Google sign-in continues in your browser instead. If this build's Google sign-in configuration is unavailable, the sheet explains the problem without opening a second login in the browser.