whatisgithub

What is longscreenshot?

mustangym/longscreenshot — explained in plain English

Analysis updated 2026-05-18

34SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A lightweight macOS menu bar app for taking screenshots, annotating them, running local OCR, and stitching manual scrolls into long screenshots.

Mindmap

mindmap
  root((LongScreenShot))
    What it does
      Menu bar screenshots
      Annotation tools
      Long screenshot stitching
      Local OCR and translate
    Tech stack
      Swift
      AppKit
      Apple Vision
    Use cases
      Capture full web pages
      Annotate bug reports
      Pin reference screenshots
      Extract text from images
    Audience
      Mac users
      Designers
      Support teams

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

Capture a normal screenshot with window detection or a free form selection.

USE CASE 2

Scroll through a long web page or document to build a single stitched screenshot.

USE CASE 3

Annotate a screenshot with shapes, text, or a mosaic blur before sharing it.

USE CASE 4

Pull text out of a screenshot with local OCR and translate it.

What is it built with?

SwiftAppKitApple Vision

How does it compare?

mustangym/longscreenshotkiraa-ai/project-onyxtofa84/berth
Stars343434
LanguageSwiftSwiftSwift
Setup difficultyeasymoderatemoderate
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires granting macOS screen recording permission before it can capture.

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

So what is it?

LongScreenShot is a screenshot tool built for macOS that lives in the menu bar. The developer made it to be simple and light, without a pile of extra features stuffed in. It runs in the background and you open it from the menu bar icon or a global keyboard shortcut, which is set to Command Shift 2 by default and can be changed if it conflicts with another app. The tool covers the basics you would expect from a screenshot app: window detection, free form selection, support for multiple displays, and the ability to move or resize your selection before capturing. On top of that it adds annotation tools such as rectangles, circles, arrows, text, a freehand brush, a mosaic blur for hiding sensitive information, and undo and redo. You can also pin a screenshot to the screen as a floating window that can be dragged and resized. For text, LongScreenShot uses Apple Vision to run OCR locally on the device, so recognized text does not need to leave your computer. It also offers translation through Baidu or Google. There is a history feature that keeps past screenshots and lets you set your own cache location and size limit. The app can check GitHub Releases for updates automatically or you can check manually. The long screenshot feature works by having you scroll the page yourself while the app captures, matches, and stitches the images together, showing a live preview as it goes. Because scrolling is manual, the app does not need special automation permissions, only the standard macOS screen recording permission that any screenshot tool requires. The developer notes that stitching can be less reliable on pages with animations, video, transparency, repeating patterns, or fast scrolling, since content that keeps changing is harder to match correctly. To install, you download a DMG from the GitHub Releases page and drag the app into Applications. The project can also be built from source using Xcode or the included build scripts, and it ships with a script for packaging a DMG. LongScreenShot is released under the Apache License 2.0.

Copy-paste prompts

Prompt 1
Explain how LongScreenShot stitches manually scrolled screenshots into one long image.
Prompt 2
Walk me through building LongScreenShot from source with Xcode on my Mac.
Prompt 3
What macOS permission does LongScreenShot need and why is it only screen recording?
Prompt 4
Show me how to change the default Command Shift 2 shortcut in LongScreenShot.
Prompt 5
List the annotation tools LongScreenShot offers for marking up a screenshot.

Frequently asked questions

What is longscreenshot?

A lightweight macOS menu bar app for taking screenshots, annotating them, running local OCR, and stitching manual scrolls into long screenshots.

What language is longscreenshot written in?

Mainly Swift. The stack also includes Swift, AppKit, Apple Vision.

What license does longscreenshot use?

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

How hard is longscreenshot to set up?

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

Who is longscreenshot for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.