webadderall
3615e09e2c
Replaces single hardcoded avc1.640033 with a 5-step fallback chain (High 5.1 → Main 5.1 → Baseline 5.1 → Main 3.1 → Baseline 3.1). Each codec is tried with hardware acceleration first, then software. The final error message now includes which codecs were attempted, the output dimensions, and a suggestion to lower the quality setting.
Recordly
Language: EN | 简中
Create polished, pro-grade screen recordings.
Recordly is an open-source screen recorder and editor for creating polished walkthroughs, demos, tutorials, and product videos. Contribution encouraged.
FAQ: What are the changes between this and the upstream project? A: Recordly adds a full cursor animation/rendering pipeline, native macOS and Windows screen recording system, zoom animations faithful to Screen Studio, cursor loops, audio tracks, and more major tweaks.
Note
Huge thank you to tadees for supporting the project! This donation directly helps cover the Apple Developer fees to get Recordly signed and notarised for macOS. Support the project
What is Recordly?
Recordly lets you record your screen and automatically transform it into a polished video. It handles the heavy lifting of zooming into important actions and smoothing out jittery cursor movement so your demos look professional by default.
Recordly runs on:
- macOS
- Windows
- Linux
Linux currently use Electron's capture path, which means the OS cursor cannot always be hidden during recording.
Features
Recording
- Record an entire screen or a single window
- Jump straight from recording into the editor
- Microphone or system audio recording
- Chromium capture APIs on Windows/Linux
- Native ScreenCaptureKit capture on macOS
- native WGC recording helper for display and app-window capture on Windows, native WASAPI for system/mic audio, and more
Smart Motion
- Apple-style zoom animations
- Automatic zoom suggestions based on cursor activity
- Manual zoom regions
- Smooth pan transitions between zoom regions
Cursor Controls
- Adjustable cursor size
- Cursor smoothing
- Motion blur
- Click bounce animation
- macOS-style cursor assets
Infinite Loops
- Toggle to make cursor return to original position at end of video/GIF for clean loops
Editing Tools
- Timeline trimming
- Speed-up / slow-down regions
- Annotations
- Zoom spans
- Project save + reopen (
.recordlyfiles)
Frame Styling
- Wallpapers
- Gradients
- Solid fills
- Padding
- Rounded corners
- Blur
- Drop shadows
Export
- MP4 video export
- GIF export
- Aspect ratio controls
- Quality settings
Screenshots
Installation
Download a build
Prebuilt releases are available here:
https://github.com/webadderall/Recordly/releases
Homebrew (Cask)
Recordly is distributed as a GUI app, so Homebrew support is done via cask.
For users:
brew tap webadderall/tap
brew install --cask recordly
Build from source
git clone https://github.com/webadderall/Recordly.git recordly
cd recordly
npm install
npm run dev
macOS: "App cannot be opened"
Recordly is not signed. macOS may quarantine locally built apps.
Remove the quarantine flag with:
xattr -rd com.apple.quarantine /Applications/Recordly.app
Usage
Record
- Launch Recordly
- Select a screen or window
- Choose audio recording options
- Start recording
- Stop recording to open the editor
Edit
Inside the editor you can:
- Add zoom regions manually
- Use automatic zoom suggestions
- Adjust cursor behavior
- Trim the video
- Add speed changes
- Add annotations
- Style the frame
Save your work anytime as a .recordly project.
Export
Export options include:
- MP4 for full-quality video
- GIF for lightweight sharing
Adjust:
- Aspect ratio
- Output resolution
- Quality settings
Limitations
Linux Cursor Capture
Electron’s desktop capture API does not allow hiding the system cursor during recording.
If you enable the animated cursor layer, recordings may contain two cursors.
Improving cross-platform cursor capture is an area where contributions are welcome.
System Audio
System audio capture depends on platform support.
Windows
- Works out of the box
Linux
- Requires PipeWire (Ubuntu 22.04+, Fedora 34+)
- Older PulseAudio setups may not support system audio
macOS
- Requires macOS 12.3+
- Uses ScreenCaptureKit helper
How It Works
Recordly is a desktop video editor with a renderer-driven motion pipeline and platform-specific capture layer.
Capture
- Electron orchestrates recording
- macOS uses native helpers for ScreenCaptureKit and cursor telemetry
- Windows uses native WGC for screen capture
Motion
- Zoom regions
- Cursor tracking
- Speed changes
- Timeline edits
Rendering
- Scene composition handled by PixiJS
Export
- Frames rendered through the same scene pipeline
- Encoded to MP4 or GIF
Projects
.recordlyfiles store the source video path and editor state
Contribution
All contributors welcomed!
Areas where help is especially valuable:
- Smooth cursor pipeline for Linux
- Webcam overlay bubble
- Localisation support, especially Chinese
- UI/UX design improvements
- Export speed improvements
Please:
- Keep pull requests focused and modular
- Test playback, editing, and export flows
- Avoid large unrelated refactors
See CONTRIBUTING.md for guidelines.
Community
Bug reports and feature requests:
https://github.com/webadderall/Recordly/issues
Pull requests are welcome.
Donations & Sponsors
• Tadees
Email youngchen3442@gmail.com for other inquiries or DM me via @webadderall
License
Recordly is licensed under the MIT License.
Credits
Acknowledgements
Originally built on top of the excellent OpenScreen project.
Created by
@webadderall