Recording the Emulator Screen

Klive can capture the emulator display (plus audio) as a video file. This is ideal for sharing gameplay clips, building tutorials, or demonstrating your retro programs to the community.

Quick-Start: Record in Three Steps

1. Configure — Use Machine › Recording to choose your format, quality, and frame rate before you start (settings are locked while recording).
2. Arm — Click the Record button (⏺) in the toolbar, or choose Machine › Recording › Start Recording. The button turns gold — the recorder is now armed and waiting for the machine to run.
3. Play — Start or continue the machine. Recording begins automatically the moment the machine runs. The Record button turns red while capturing.

To finish, click the Record button again (or stop the machine). The video file is written to disk immediately.

Understanding the Record Button

The Record button shows the recorder’s current status by changing colour:

How it flows:

1. Click the gold Record button → the button turns gold (armed). Now the recorder is ready.
2. Start or run the machine → the button turns red (recording). Frames are being captured.
3. Pause the machine (for debug) → the button turns orange (paused). Recording pauses too.
4. Resume the machine → the button turns red again. Recording continues seamlessly.
5. Stop the machine or click the button again → back to default. The video file is saved.

Configuring the Recording

All options live under Machine › Recording. They can only be changed while recording is idle.

Output Format

Quality

Quality is expressed as a CRF (Constant Rate Factor) value passed to FFmpeg. Lower CRF = higher quality = larger file.

Frame Rate

When Half is selected, both video frames and audio samples are sub-sampled together so audio and video remain in perfect sync.

Pausing and Resuming a Recording

You can pause a recording independently of the machine:

• Machine paused (debug step, Pause button): the recorder automatically suspends. It resumes the moment the machine runs again.
• Manual pause/resume (via Machine › Recording › Pause Recording / Continue Recording): pause the capture while the machine keeps running. Use this to skip sections you don’t want in the output.

During a pause the output file stays open — no data is lost, and the resume is seamless.

Audio Recording

Stereo audio from the emulated machine (beeper, AY, SID, …) is captured automatically at the emulator’s native sample rate (typically 44.1 kHz). Audio and video are muxed into the same file.

If the machine produces no sound, the video will contain silence — that is normal.

Where Files Are Saved

Klive writes each recording to:

~/KliveExports/video/recording_YYYYMMDD_HHMMSS.{mp4|webm|mkv}

The filename is generated from the date and time the recording started. Navigate there in Finder / Explorer, or open a terminal and run:

open ~/KliveExports/video        # macOS
explorer %USERPROFILE%\KliveExports\video   # Windows

Tips

• Set options before arming — format, quality, and fps are locked while the recorder is armed or recording.
• Arm before starting — clicking Record while the machine is already running starts capturing immediately (no armed state shown because the machine is already live).
• Lossless for editing — if you plan to edit or re-encode the clip, use lossless quality and MKV for the smallest lossless file.
• Keep recordings short — native 50 fps recordings generate a lot of data. For long game sessions, use Half fps + Best compression.
• Check FFmpeg version — older FFmpeg versions may not support all codecs. FFmpeg 5.x or later is recommended.

Codec Reference