Record on a Mac

Before you start: the Klipeo Mac app on macOS 14 or later, with Screen Recording and Accessibility allowed for Klipeo. Missing access opens a checklist with an Enable button beside each permission.

Record

Where the take goes depends on where you pressed Record: into the open edit, back to the composer as an attachment that stays on your Mac until you send, or into Downloads/Klipeo Recordings. See where the take lands.

If it does not record

• The checklist keeps showing Enable Screen Recording. Press Reopen Klipeo to finish so macOS applies it. If it is still off, open System Settings → Privacy & Security → Screen Recording and switch Klipeo off and on.
• You denied the camera or microphone earlier. macOS will not ask again. Turn it on in System Settings → Privacy & Security → Camera or Microphone.
• Phone is disabled. Connect an unlocked, trusted iPhone or iPad by USB, or an Android phone with USB debugging on.
• Recording stopped unexpectedly. Klipeo finalizes the take when it can and offers the recoverable recording. An unreadable movie is never imported as a finished take.

Reference

The sections below cover every control in the Mac recorder.

The Record window

In the Mac app, the Record button in the editor header, Record → Record screen on the projects home, the native editor's Record button, and Record Screen… in the menu bar (Shift+Cmd+2) all open the Record window. This landscape source-and-device window opens centered over the main app. Drag its title bar to move it, or use the red close button to close it. Click a source to start it, or press 1 to 4. Esc closes the window.

After you pick Display, an area, or a window, a landscape card appears near the selected source with your Camera, Microphone, and System audio choices and a Record button. Set up the screen and check your framing in the camera bubble, change a device if you need to, then press Record or Return to start the countdown. Press the close button or Esc to go back to the window.

Cancelling the area overlay, the window picker, the ready bar, or the countdown brings the window back, so you can pick another source.

The source cards are Display and Window on the first row, then Area and Phone. Teleprompter, Camera, Microphone, System audio, auto zoom, and countdown are all in the Record window. Click a device row to choose a device; its On or Off pill toggles it without opening the menu. Klipeo remembers each choice for your next take.

Mac recordings preserve the source's native pixel dimensions, including Retina resolution, at up to 60 fps. Encoding rounds dimensions to even pixels without upscaling or silently reducing a large source to Full HD. Bitrate scales with resolution. Quality and frame rate depend on the source and available hardware; unsupported encoder dimensions show an error. Protected content may be hidden by macOS.

For USB iPhone and iPad capture, System audio means the connected device's sound. The selected Mac microphone can be recorded alongside it. Devices that provide fewer than 60 fps show their available rate before recording. Keep the device unlocked and connected. Android capture has the sound limitation described above.

• Camera and Microphone list the devices on this Mac by name, with None to leave one out. The On or Off control turns it off, and turns it back on with the last device you picked.
• System audio records your Mac's sound, or choose None.
• Auto zoom is Off, Follow cursor, or 3D motion. With it on, zoom regions are placed from your clicks and typing when the take lands; 3D motion also tilts the frame toward where you work.
• Countdown is off, 3, 5, or 10 seconds. It starts at 3.
• Hide desktop icons clears the desktop for the take and restores it after.
• Teleprompter takes the script you write with Write or Edit.
• Show recordings in Finder opens Downloads/Klipeo Recordings.

Display and Window use the macOS capture picker. Area opens a drawing overlay directly and records only the confirmed rectangle. Pressing Return before drawing an area never starts full-display recording. Recorder controls are excluded from capture; Klipeo's main window remains available to record.

Turning on Camera or Microphone, or choosing a device, requests its native consent prompt if access has not been decided. Already allowed devices do not prompt again. If you previously denied access, macOS cannot repeat the prompt. Enable access manually in System Settings > Privacy & Security > Camera or Microphone. The recorder keeps your device choice; Mac Settings → Recording has Allow access or Open Settings for each device.

Screen Recording and Accessibility must both be allowed before the Mac recorder opens. Missing access opens the permission checklist instead. Choose Enable Screen Recording or Enable Accessibility for a floating guide with the running Klipeo.app icon to drag into the permission list. Status refreshes while the checklist, guide, or recorder is open and again before capture. After you turn on Screen Recording, Reopen Klipeo to finish restarts Klipeo so macOS applies it. If Screen Recording is still off after that, the row goes back to Enable Screen Recording: open Settings and switch Klipeo off and on again.

The recorder is a separate macOS window, centered over the main window when opened. Drag its native title bar to move it, and use the red close button to close it. The permission list stays in Recording permissions, outside the source and recording-settings layout.

Mac Phone capture requires a connected USB iPhone, iPad, or ready Android device. The disabled source shows Phone not connected when no device is ready. USB and Android previews open in a landscape window with controls beside the preview. USB iPhone and iPad capture requests camera access, and microphone access when recording an audio input.

Android phones

To record an Android phone from the Mac app, install Android platform tools (brew install android-platform-tools, or Android Studio), turn on USB debugging in the phone's Developer options, plug it in, and tap Allow on the phone. The Phone card then finds it when no iPhone is connected. The window previews the phone with a screenshot about twice a second; the take itself is the phone's full screen recording, without the phone's sound. The phone writes frames only while its screen changes, so a take where nothing moves cannot be saved.

The teleprompter

Open Teleprompter from the launcher to paste a script. In the Mac app, switch on Teleprompter in the Record window and choose Write or Edit to type the script and pick its scroll speed. The pad scrolls the text while you record, at a speed you set, with Pause scrolling and Resume scrolling controls and larger or smaller text. Drag the pad by its bar to move it, and drag any corner to resize it. On a browser that supports it, the pad opens in its own small window that stays on top of everything you are recording.

In the Mac app, the script moves to a native pad near the top of the recorded screen when recording starts, and the recording leaves that pad out. It starts at the first line, which sits on the blue reading mark, and scrolls at 1×, 2×, or 3×. Pausing the recording pauses the script, and resuming picks it up again; a script you paused yourself stays paused. Back to the top restarts it, drag the text to scroll by hand, and change the text size and the pad's opacity at the bottom: click − or +, hold one to keep stepping, or drag the number sideways (hold Shift for bigger steps). Klipeo remembers the opacity for your next take.

Point at the recording island under the notch to open it, and it also shows the script right beside the camera, where your eyes stay close to the lens. The recording leaves the island out too. Its own controls play or pause that copy, send it back to the top, and make the text smaller or larger. The teleprompter button beside Stop hides the pad or shows it again.

While it records

With a camera on, a live camera bubble appears while the Record window is open and stays available beside the selected source, so you can check your framing. Turning Camera off hides the bubble immediately and releases the camera session before disposing its preview. You can turn it off while the camera is starting. Drag the preview to move it. Open the camera shape menu to choose Circle, Rounded square, or Rectangle. Mirror video starts on for both the preview and the recorded camera track; turn it off from the same menu. Drag the bright bottom-right resize grip to change its size. A dim caption below the preview shows its dimensions and frame rate. Focus the resize grip and use the arrow keys to resize with the keyboard. Klipeo remembers the shape, size, and position. When recording from inside the editor, the camera clip stays full-frame on its own track above the recording. Its final bubble position, size, and shape are applied in the editor; moving the preview during a take does not create a camera movement animation.

The flat recording bar near the top of the display stays above your apps and clear of the Dock. It shows the timer and, when you record a microphone, a live level meter. Drag the bar by its timer.

• Pause and Resume hold and continue the take.
• Restart throws the take away and records the same source again, after the countdown if you set one, without asking for the area or window again.
• Discard throws the take away.
• Stop saves the take. A recording started from Home or a project chat returns as an attachment preview beside your prompt. Choose Start editor when ready. A recording started inside the editor imports into that edit.

After the first three seconds, Restart and Discard ask you to press again. The bar, the camera bubble, the countdown, and the teleprompter are left out of the recording.

From Stop to the editor

Video attachments decode an early frame for their thumbnail, even while paused. The screen recording keeps its saved cursor data and auto-zoom choice through chat import. A paired camera clip overlays the same screen interval and is muted; the screen movie owns microphone and system sound.

Every take stays on your Mac, in Downloads/Klipeo Recordings. Where it lands depends on where you pressed Record:

• From Home or a project chat, the take comes back to that composer as an attachment, with any camera clip beside it, in the tab you recorded from. If that chat has closed, Klipeo opens Home and attaches the take there. Nothing else opens; write your prompt and choose Start editor when ready. The take's preview appears at once and reads Attaching while its bytes come in. The take stays on your Mac until you send: only then does it upload, so the agent can see it (see Sending a take to Vibe).
• From the editor, the take lands in the edit you have open instead of a new one.
• From the menu bar with no chat or editor open, the take stays in the folder and Klipeo offers to show it in Finder so you can add it to a chat.

When the take goes to an editor, a small bar takes the recording bar's place: Saving your recording, then Opening the editor. The editor plays the take straight from your Mac and keeps its own copy with the project, so there is no upload to wait for. Cancel stops opening the editor and shows the recording in Finder.

Takes are recorded at your screen's full size, which is heavy to scrub. Right after a take is saved, the Mac app makes a light editing copy of it (1920 pixels wide, a keyframe every half second, about 30 MB a minute) in a hidden .Klipeo Proxies folder inside Klipeo Recordings. The editor switches its preview and timeline to that copy as soon as it is ready, without a reload. Export always uses the full-quality original. Videos you add to the editor any other way get the same kind of copy; see What plays, and what you export.

You can record without a network connection. The take is saved to the folder as usual, but the editor is served by Klipeo, so a take headed for a new edit waits: Klipeo posts a Recording saved offline notification and opens the take in the editor by itself once your Mac is back online.

The editor then opens in front of the app you recorded, with zoom regions placed from the Auto zoom choice in the Record window and Show cursor on.

Klipeo waits for a usable screen frame before starting the timer. If capture or encoding stops unexpectedly, Klipeo attempts to finalize the take and offers the recoverable recording. An unfinished or unreadable movie is not imported as a successful take.

Pick a saved recording

In the Mac app, Record → Choose recording lists the saved movies in Downloads/Klipeo Recordings, including file size, duration, and pixel dimensions. Search the local list, select a recording to attach it to the open chat from your Mac, or choose Show recordings in Finder. Every take saved there is listed; none of them has to be in the cloud library. The Mac Record menu never asks you to install the Chrome extension.

Sending a take to Vibe

A Mac take you attach on Home or in a project chat stays on your Mac until you send the request. (A Chrome take uploads as soon as it is attached.) When you do, the editor opens, and the chat shows Uploading your file (size) so the agent can see it while the take uploads; large takes go up in parts, up to your plan's upload limit (50 MB free, 300 MB paid). The edit starts when the upload finishes. If the upload fails, your request and the take wait in the composer so you can send again. A take you never send to the agent never uploads, and it joins Recordings only once it has been uploaded.

The editor itself plays the take from your device, so a long recording does not need to upload before you can cut it.