A professional cross-platform screen recording application built with Electron that records your screen without the native cursor, tracks mouse movements separately, and provides a powerful post-processing studio for creating polished, cinematic screen recordings.
demo.mp4
CineScreen supports the following platforms:
- macOS ARM64 (Apple Silicon) - M1, M2, M3, and later
- Windows x64 - Windows 10/11 (64-bit)
- Native cursor-free recording - Records screen without the system cursor for clean footage
- Separate mouse tracking - Tracks mouse movements independently with high precision
- Region recording - Record specific screen regions
- Configurable quality - Choose from low, medium, or high quality settings
- Custom frame rates - Adjustable recording frame rate
- MKV format - Uses Matroska format for reliable interrupted recordings
- Real-time preview - See your changes instantly before rendering
- Timeline editing - Navigate through your recording with frame-accurate controls
- Keyframe support - Add and edit cursor keyframes for precise control
- Metadata export - Export recording metadata for external processing
- Size control - Adjustable cursor size (10-200px)
- Multiple shapes - Choose from arrow, pointer, hand, crosshair, and more
- Color customization - Full color picker for cursor styling
- Glide effect - Smooth cursor gliding with critically damped spring physics
- Directional motion blur - Cinematic motion blur in the direction of cursor movement
- Animation styles - Preset styles: slow, mellow, quick, or rapid
- Frame offset - Fine-tune cursor timing synchronization
- Static cursor hiding - Automatically hide cursor when not moving
- Click animations - Visual feedback on mouse clicks with smooth scaling
- Smart zoom - Automatic zoom tracking that follows your cursor
- Zoom levels - Adjustable zoom from 1.5x to 3.0x
- Smooth transitions - Physics-based zoom animations with spring dynamics
- Dead zone - Prevents jitter when cursor barely moves
- Auto-zoom on clicks - Automatically zoom in on click actions
- Motion blur - Apply motion blur to zoom/pan movements
- Advanced physics - Fine-tune tension, friction, and mass for perfect feel
- High-quality rendering - Uses Sharp for pixel-perfect frame processing
- FFmpeg integration - Professional video encoding with H.264
- Click detection - Automatic click event detection and visualization
- Smooth interpolation - Critically damped spring physics for smooth cursor and zoom motion
- Effects system - Easing functions (linear, easeIn, easeOut, easeInOut) and animation effects
- Consistent preview/export - Same rendering logic for preview and final export
- Electron - Cross-platform desktop framework
- TypeScript - Type-safe development
- FFmpeg - Video encoding and processing
- Sharp - High-performance image processing
- Vite - Fast build tool for renderer process
- Koffi - FFI bindings for Windows native APIs
- Native Swift - Mouse button state tracking (macOS only)
- Go to the Releases page on GitHub
- Download the latest
.dmgfile from the assets section - Open the downloaded DMG file
- Drag CineScreen to your Applications folder
- Launch CineScreen from Applications
Note: On first launch, macOS may warn you that the app is from an unidentified developer. To allow it:
- Right-click (or Control-click) the app and select "Open"
- Click "Open" in the security dialog
- Or go to System Settings > Privacy & Security and click "Open Anyway" next to the warning message
- Go to the Releases page on GitHub
- Download the latest
.exeinstaller or.zipfile from the assets section - Run the installer or extract the ZIP file
- Launch CineScreen from the Start Menu or extracted folder
- Node.js 18+ and npm
# Install dependencies
npm install
# Run in development mode (with hot reload)
npm run dev
# Build all components
npm run build
# Start the built application
npm run start
# Package for macOS (creates DMG and ZIP)
npm run package:mac
# Package for Windows (creates NSIS installer and ZIP)
npm run package:win
# Clean build artifacts
npm run cleannpm run dev- Start development with hot reload for main, preload, and renderernpm run build- Build all TypeScript and native componentsnpm run build:native- Build Swift native module (macOS only)npm run start- Run the built Electron appnpm run package:mac- Create distributable macOS packagenpm run package:win- Create distributable Windows package
Before running npm run package:win on Windows, you need to enable Developer Mode to allow symbolic link creation:
- Open Windows Settings → Privacy & security → For developers
- Turn ON Developer Mode
If you encounter the error Cannot create symbolic link: A required privilege is not held by the client, run the following command and try again:
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\electron-builder\Cache\winCodeSign" -ErrorAction SilentlyContinue
npm run package:winAlternatively, run your terminal as Administrator.
- Grant Permissions - On first launch, grant necessary permissions (see below)
- Configure Output - Set your desired output path for recordings
- Start Recording - Click "Start Recording" to begin capturing
- Stop Recording - Click "Stop Recording" when finished
- Open Studio - Use the Studio editor to customize cursor, zoom, and effects
- Render - Export your final video with all post-processing applied
CineScreen requires the following macOS permissions:
- Screen Recording - Required to capture screen content
- Accessibility - Required for precise mouse movement tracking
These permissions are requested automatically on first launch. You can also grant them manually in System Settings > Privacy & Security.
CineScreen may require administrator privileges for certain features. No additional permissions are typically required.
- macOS 10.15 (Catalina) or later
- Screen Recording permission
- Accessibility permission
- Windows 10 (64-bit) or later
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request.