whatisgithub

What is cursorlens?

blueberrycongee/cursorlens — explained in plain English

Analysis updated 2026-05-18

509TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A free, open source macOS and Linux screen recorder and video editor for making product demos, built as a no-cost alternative to paid tools.

Mindmap

mindmap
  root((CursorLens))
    What it does
      Records screen
      Edits video
      Exports demos
    Recording features
      Camera overlay
      Mic recording
      Cursor effects
    Tech stack
      Electron
      React
      TypeScript
    Audience
      Creators
      Developers
      Product teams
    Platforms
      macOS
      Linux

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Record polished product demo and walkthrough videos without paying for subscription software.

USE CASE 2

Edit screen recordings with a timeline editor for trimming, zooming, and adding cursor effects.

USE CASE 3

Export a recording in multiple aspect ratios for platforms like YouTube, TikTok, or Instagram.

What is it built with?

ElectronReactTypeScriptVitePixiJS

How does it compare?

blueberrycongee/cursorlensmx-space/coreshadcnspace/shadcnspace
Stars509527528
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

macOS may block the unsigned build by default and requires a one-line terminal command to allow it to run.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

CursorLens is a free, open source screen recorder and video editor for creators, developers, and teams who need to make product demos and walkthrough videos. It positions itself as a no-cost alternative to paid tools like Screen Studio, with no watermarks, no subscription fees, and a license that allows commercial use. It runs mainly on macOS, with a Linux build also available, and it builds on top of an earlier project called OpenScreen, adding a stronger native macOS capture and editing pipeline on top of it. Recording features include capturing the full screen or a single selected app window, a native macOS capture helper that shows or hides the cursor cleanly, a camera overlay so a webcam feed can appear on top of the recording, and microphone recording with gain adjustment handled in the editor afterward. Once a recording is made, a built in timeline editor supports trimming, cropping, zooming into parts of the screen, adding cursor effects and annotations, and a rough subtitle generation workflow. Finished videos can be exported in several aspect ratios, including standard widescreen, vertical for social media, and square, with support for exporting several videos at once and audio controls like loudness normalization. Installation is done by downloading a platform specific installer from the project's GitHub Releases page. On macOS, if the system blocks the app as unsigned or reports it as damaged, the README gives a single terminal command to remove the quarantine flag, followed by granting screen recording, accessibility, microphone, and camera permissions in system settings. The project is built with Electron, React, and TypeScript, and the README notes it is still in beta, so some workflows may behave unpredictably on certain machines.

Copy-paste prompts

Prompt 1
Walk me through installing CursorLens on macOS, including how to bypass the Gatekeeper security warning.
Prompt 2
Explain what permissions CursorLens needs on macOS and why each one is required.
Prompt 3
What editing features does CursorLens offer once I've finished recording a screen capture?
Prompt 4
Compare CursorLens to Screen Studio and explain the tradeoffs of using a free open source tool instead.

Frequently asked questions

What is cursorlens?

A free, open source macOS and Linux screen recorder and video editor for making product demos, built as a no-cost alternative to paid tools.

What language is cursorlens written in?

Mainly TypeScript. The stack also includes Electron, React, TypeScript.

What license does cursorlens use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is cursorlens to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is cursorlens for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.