Open-Source Desktop Screen Recorders: Setup, Recording and Fixes

An open-source screen recorder lets you capture your desktop, a window or a region, with source code that anyone can inspect. Popular options include OBS Studio for Windows, macOS and Linux, ShareX for Windows, and SimpleScreenRecorder, Kooha and vokoscreenNG for Linux. This guide uses OBS Studio as the main example because it runs on all three desktop platforms. The same ideas apply to the others, but their settings are named and arranged differently.

Before you start

Most open-source desktop recorders encode and save video on your own computer. They do not need an account or a cloud service. Do not assume this, though. Check whether the version you install contacts a server, for example for update checks, crash reports or optional plugins. Also check whether any add-on you install uploads files. Download the recorder from the project's official release channel or your operating system's package manager. Avoid unofficial bundles, which may be modified.

• A supported operating system version. Check the project's release notes for the minimum version.
• Enough free disk space. Screen recordings grow quickly at high resolution and frame rate.
• On macOS, permission for the app to record the screen and, if needed, the microphone.
• On Linux, find out whether your session uses Wayland or X11. Many recorders capture Wayland desktops through the PipeWire screen-sharing portal, so the right portal package must be installed.
• A microphone or headset set as the system input, if you want to record narration.

Step-by-step instructions

The steps below follow OBS Studio. Menu names can change between releases. If an item is not where described, check the documentation for your installed version.

• Install OBS Studio and open it. If the auto-configuration wizard appears, choose the option to optimize for recording rather than streaming. You can rerun or ignore the wizard later.
• In the Sources panel, click the plus button and add a capture source. Display or screen capture records a whole monitor. Window capture records one application. On Linux with Wayland, choose the PipeWire-based screen capture source and pick the screen or window in the system dialog that appears.
• Check the audio mixer. Desktop audio captures system sound and the microphone source captures your voice. Mute or remove whichever you do not need, and speak briefly to confirm the microphone meter moves.
• Open Settings, then the Output section. Set the recording path to a folder with enough space. Choose a recording format. MKV is more likely to survive a crash or power loss than a plain MP4 file. Some newer versions also offer a hybrid MP4 option designed for the same purpose.
• In the Video section of Settings, check the base and output resolution and the frame rate. A lower output resolution or frame rate produces smaller files and reduces load on slower computers.
• If a hardware encoder for your graphics card is listed in the Output settings, try it first. It usually puts less load on the processor than software encoding. If you see problems, switch back to the software encoder.
• Click Start Recording, do your task, then click Stop Recording. The file is saved to the recording path you set.

Every setting above can be changed again later. To keep a known-good setup, create a separate profile before you experiment. Then you can switch back without re-entering everything. If you prefer a simpler tool, SimpleScreenRecorder, Kooha and vokoscreenNG on Linux and ShareX on Windows follow a similar sequence: choose an area, choose audio inputs, set the output file, then record.

Check the output

• Open the recording folder and confirm the file exists and its size is not near zero.
• Play the file in a separate media player, not only the recorder's preview, and watch the whole clip from start to finish.
• Check that the right screen or window was captured, and that text is readable at the resolution you chose.
• Listen for both desktop audio and microphone audio if you recorded both, and check that the speech stays in sync with the picture.
• If you recorded to MKV but need MP4 for editing or sharing, use the recorder's remux feature. In OBS Studio it is in the File menu. Remuxing changes the container without re-encoding, so quality is not affected.

Some editors and websites accept only certain formats or codecs. If a file plays locally but is rejected elsewhere, check that destination's supported formats before re-encoding. Re-encoding can reduce quality and takes extra time.

Common problems and next steps

Black screen in the preview or the recording. On macOS, the app usually lacks screen recording permission. Grant it in the operating system's privacy settings and restart the app. On Windows laptops with two graphics processors, display capture can show black if the recorder runs on a different GPU from the one driving the screen. Try assigning the app to the other GPU in the Windows graphics settings. On Linux with Wayland, older X11-only capture methods often show nothing. Use a PipeWire-based source and make sure the desktop portal is installed and running.

No sound, or only one audio source. Check that the correct input and output devices are selected in the recorder's audio settings and that the meters move. Desktop audio capture on macOS depends on the OS version and the recorder version. Some setups need a separate virtual audio device. Check the documentation for your version before installing extra drivers.

Choppy video or dropped frames. Lower the output resolution or frame rate. Try a hardware encoder if one is available. Close other demanding applications. Record to a local drive rather than a network or slow external drive.

Files that will not open after a crash. Plain MP4 files are often unreadable if recording stops unexpectedly. Switch to MKV or a crash-resistant format for future recordings, and remux to MP4 afterwards.

Choosing a different tool. If OBS Studio feels too complex for quick captures, try a lighter recorder. On Linux, Kooha and SimpleScreenRecorder suit simple full-screen or window recordings. On Windows, ShareX combines screenshots and region recording. Check each project's current release notes for platform support and licence terms before you rely on it.