Download OpenScreen
Download the latest installer for your platform from the GitHub Releases page. Look for the appropriate file:- macOS:
.dmgfile - Windows:
.exeinstaller - Linux:
.AppImagefile
macOS Installation
Bypass Gatekeeper (if needed)
Since OpenScreen doesn’t have a developer certificate, macOS Gatekeeper may block the app from opening. To bypass this restriction, run the following command in Terminal:
Grant permissions
After running the command, navigate to System Preferences > Security & Privacy and grant OpenScreen the necessary permissions:
- Screen Recording - Required to capture your screen
- Accessibility - Required for keyboard shortcuts and app detection
Troubleshooting macOS Issues
App won't open after installation
App won't open after installation
Make sure you’ve run the
xattr command to remove the quarantine flag and granted Full Disk Access to your Terminal app.Screen recording permission not working
Screen recording permission not working
Go to System Preferences > Security & Privacy > Privacy > Screen Recording and ensure OpenScreen is checked. You may need to restart the app after granting permissions.
Windows Installation
Windows Defender or your antivirus software may show a warning since the app is not signed. You can safely proceed with the installation.
Linux Installation
Grant permissions (if needed)
Depending on your desktop environment, you may need to grant screen recording permissions. The specific steps vary by distribution:
- GNOME: Settings > Privacy > Screen Sharing
- KDE Plasma: System Settings > Workspace Behavior > Screen Locking
- Other: Consult your desktop environment’s documentation
Linux Troubleshooting
App fails to launch with sandbox error
App fails to launch with sandbox error
If you encounter a sandbox error, run OpenScreen with the
--no-sandbox flag:Missing dependencies on older distributions
Missing dependencies on older distributions
Some older Linux distributions may be missing required libraries. Install these packages:Debian/Ubuntu:Fedora/RHEL:
System Requirements
To run OpenScreen smoothly, your system should meet these minimum requirements:Minimum Requirements
- CPU: Dual-core processor (2 GHz or faster)
- RAM: 4 GB
- Storage: 200 MB free space
- Graphics: Hardware acceleration support
Recommended for 4K Recording
- CPU: Quad-core processor (3 GHz or faster)
- RAM: 8 GB or more
- Graphics: Dedicated GPU with hardware encoding support
- Storage: SSD with 1 GB+ free space for recordings
OpenScreen automatically adjusts recording quality based on your hardware capabilities. If your system can’t maintain 4K@60fps, it will fall back to lower resolutions while keeping quality as high as possible.
Verifying Installation
After installation, verify that OpenScreen is working correctly:- Launch the application
- Check that the source selector window appears
- Select a screen or window to record
- Click the record button to start a test recording
- Stop the recording and verify the video editor opens
Updating OpenScreen
OpenScreen doesn’t have automatic updates yet. To update:- Check the releases page for new versions
- Download the latest installer for your platform
- Install the new version (it will replace the old one)
Your project files and custom settings are preserved during updates.
