Warning

This is very much in beta and might be buggy here and there (but hope you have a good experience!).

 

Docsie Screen Recorder

A free screen recorder built on OpenScreen, with Docsie ecosystem enterprise extensions.

Download

Latest release: Docsie Screen Recorder

Platform	Download
macOS (Apple Silicon)	docsie-screen-recorder-mac-arm64.dmg
macOS (Intel)	docsie-screen-recorder-mac-x64.dmg
Windows (installer)	Docsie.Screen.Recorder.Setup.exe
Windows (portable)	Docsie.Screen.Recorder.exe
Linux (AppImage)	Docsie.Screen.Recorder-Linux.AppImage
Linux (.deb)	Docsie.Screen.Recorder-Linux.deb

Checksums: SHA256SUMS.txt

---

Docsie Screen Recorder is the public Docsie fork of OpenScreen. The goal is simple:

• keep a strong free recorder and editor available in the open
• build Docsie-specific enterprise features around documentation, workflows, AI, and the broader Docsie ecosystem

This is not trying to erase the upstream project. The recorder/editor foundation comes from OpenScreen, while Docsie-specific extensions are being layered on top with a separate enterprise boundary.

Docsie Fork

This repository is the public Docsie Screen Recorder fork used for local recording, editing, and Docsie's existing Video-to-Docs workflow.

• Public fork repo: LikaloLLC/docsie-screen-recorder
• Upstream source: siddharthvaddem/openscreen
• Current desktop auth notes: DOCSIE_DESKTOP_AUTH.md
• Current editor/integration notes: CLAUDE.md
• Mixed-license notes: LICENSING.md
• Release process: RELEASING.md

Docsie Quick Start

Recommended local runtime:

• Node 22.22.1
• npm 10.9.4

Install and run locally:

npm install
npm run dev

Build the macOS app:

npm run build:mac

Build a Mac App Store package:

npm run build:mas

Validate or upload the Mac App Store package after creating the app record in App Store Connect:

APPLE_ID="<apple-id>" APPLE_APP_SPECIFIC_PASSWORD="<app-specific-password>" npm run mas:validate
APPLE_ID="<apple-id>" APPLE_APP_SPECIFIC_PASSWORD="<app-specific-password>" npm run mas:upload

Set up macOS release signing after exporting the Docsie Developer ID Application certificate as a .p12:

npm run signing:setup -- --p12 /path/to/DeveloperIDApplication.p12 --apple-id "<apple-id>"

Set up Mac App Store signing after Apple issues Mac App Distribution and Mac Installer Distribution certificates:

npm run signing:setup:mas -- --app-cer /path/to/mac_app.cer --installer-cer /path/to/mac_installer.cer --apple-id "<apple-id>"

Useful output paths after a mac build:

• Apple Silicon app bundle: release/<version>/mac-arm64/Docsie Screen Recorder.app
• Intel app bundle: release/<version>/mac/Docsie Screen Recorder.app
• DMGs: release/<version>/*.dmg
• Mac App Store package: release/<version>/mas-arm64/Docsie Screen Recorder-Mac-App-Store-arm64-<version>.pkg

Create a new patch release:

npm run release:patch

That bumps the app version, commits it, pushes the branch, and pushes a fresh release tag. The tag triggers the GitHub Actions release workflow, which builds Windows, Linux, and macOS installers on native runners and publishes them to GitHub Releases. Optional S3 mirroring is documented in RELEASING.md.

macOS Permission Flow

If the app opens but shows Screens (0) and Windows (0), check the source picker's macOS status line. If the status is not granted, macOS screen capture permission is still blocked:

1. Launch the app once.
2. In the source picker, click Open Settings.
3. Enable Docsie Screen Recorder in System Settings -> Privacy & Security -> Screen & System Audio Recording.
4. Click Restart App, or fully quit the app.
5. Reopen it.

If the status is granted but the picker still has no sources, macOS has stale capture state for the running process or permission was granted to a different app copy. Use the Running: path shown in the picker to confirm the executable, then restart the app. If it still fails, remove and re-add Docsie Screen Recorder in Screen & System Audio Recording.

Official release DMGs are expected to be Developer ID signed and notarized. If Gatekeeper blocks an unsigned local test build, remove quarantine and retry:

xattr -dr com.apple.quarantine "release/<version>/mac-arm64/Docsie Screen Recorder.app"

Licensing Model

This fork is not relicensing the inherited upstream project.

• The root project and inherited OpenScreen code remain under the upstream MIT License.
• New Docsie-only enterprise work should go under enterprise/ and is intended to follow enterprise/LICENSE.md.

This is the same general repository pattern used by mixed-license/source-available projects: keep the original open-source base intact, and place separately licensed commercial extensions behind a clear directory boundary.

Core Features

• Record specific windows or your whole screen.
• Add automatic or manual zooms (adjustable depth levels) and customize their durarion and position.
• Record microphone and system audio.
• Crop video recordings to hide parts.
• Choose between wallpapers, solid colors, gradients or a custom background.
• Motion blur for smoother pan and zoom effects.
• Add annotations (text, arrows, images).
• Trim sections of the clip.
• Customize the speed of different segments.
• Export in different aspect ratios and resolutions.

Installation

For the Docsie fork, use the packaged builds under release/<version>/ in this repo or the releases attached to the private fork.

If you are developing locally, prefer the Docsie Quick Start section above instead of the packaged installers.

macOS

Current release builds should be Developer ID signed and notarized. If you are testing an unsigned local build and macOS Gatekeeper blocks the app, you can bypass this by running the following command in your terminal after installation:

xattr -rd com.apple.quarantine /Applications/Docsie\ Screen\ Recorder.app

Note: Give your terminal Full Disk Access in System Settings > Privacy & Security to grant you access and then run the above command.

After running this command, proceed to System Settings > Privacy & Security to grant the necessary permissions for Screen & System Audio Recording. Once permissions are granted, fully quit and relaunch the app.

Linux

Download the .AppImage file from the releases page. Make it executable and run:

chmod +x Openscreen-Linux-*.AppImage
./Openscreen-Linux-*.AppImage

You may need to grant screen recording permissions depending on your desktop environment.

Note: If the app fails to launch due to a "sandbox" error, run it with --no-sandbox:

./Openscreen-Linux-*.AppImage --no-sandbox

Limitations

System audio capture relies on Electron's desktopCapturer and has some platform-specific quirks:

• macOS: Requires macOS 13+. On macOS 14.2+ you'll be prompted to grant audio capture permission. macOS 12 and below does not support system audio (mic still works).
• Windows: Works out of the box.
• Linux: Needs PipeWire (default on Ubuntu 22.04+, Fedora 34+). Older PulseAudio-only setups may not support system audio (mic should still work).

Built with

• Electron
• React
• TypeScript
• Vite
• PixiJS
• dnd-timeline

---

I'm new to open source, idk what I'm doing lol. If something is wrong please raise an issue 🙏

Documentation

Repo-specific docs:

• CLAUDE.md
• DOCSIE_DESKTOP_AUTH.md
• LICENSING.md
• RELEASING.md

Upstream background docs: OpenScreen Docs

Contributing

Contributions are welcome! If you’d like to help out or see what’s currently being worked on, take a look at the open issues and the project roadmap to understand the current direction of the project and find ways to contribute.

License

This repository uses a mixed-license structure.

• The inherited OpenScreen codebase and default root code remain under the MIT License.
• Docsie-only enterprise code under enterprise/ is intended to follow enterprise/LICENSE.md.

Read LICENSING.md before moving code across those boundaries.