Skip to content
GAServantesPublic

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

SnapCap icon

SnapCap

Screenshots and screen recording for GNOME, the ShareX way.
Click the tray icon, drag a box, done.

CI Latest release License: GPL-3.0-or-later

Selecting an area on the frozen screen, with the pixel magnifier showing coordinates and the color under the pointer

SnapCap lives in your top bar. Left-click it and the screen freezes; drag out the area you want, with a magnifier that shows exactly which pixel you are on. The picture is saved, copied to the clipboard, and shown in a small preview that fades away. Right-click for everything else: full screen, scrolling pages, color picking, video, GIFs, sound, and every setting.

What it does

  • Region capture on a frozen screen, with a 15×15 pixel magnifier, the X/Y position and the color under the pointer. It can snap to window and panel edges (a single click captures the element under the pointer), and adjust before saving keeps the selection editable with handles and arrow keys.
  • Repeat last region: left-click captures the same area again.
  • Scrolling capture: pick the part of a window that scrolls. SnapCap scrolls it and joins the screens into one tall image. Sticky headers and footers are kept once, and floating buttons and spinners are left out.
  • Color picker: click a pixel to copy #RRGGBB or rgb(), or press C in any selection.
  • Video (MP4 with sound) and GIF of a region, with computer sound and/or the microphone. Recording uses the graphics card when it can (VA-API H.264): little CPU, no dropped frames at high resolution, and saving is near-instant.
  • Sound only (MP3): record computer sound and/or the microphone with nothing from the screen. A small bar under the tray icon shows the time and a level meter, so you can see the sound coming in.
  • Trim recordings before saving, or later from the preview.
  • Edit in Splice: if you have Splice installed, a video's preview gets an Edit button that opens the video there for the full job: trim, join clips, add text, change the sound, crop.
  • Webcam overlay in recordings: circle, rounded or square, cropped and placed in any corner, and it can hop out of the pointer's way.
  • Preview in the corner: drag it straight into another app, or use Copy, Open, Folder, Trim, Edit, Delete. 📌 keeps it on screen.
  • Delay of 0–20 s, with the countdown drawn on the tray icon.
  • Hide the pointer in screenshots, videos and GIFs, or show it.
  • Saves to ~/Pictures/Screenshots/2026-11/2026-11-01_14-03-22.png (one folder per month, named by date and time, never overwriting).
  • Follows your light or dark style.

The right-click panel: capture, recording and sound actions at the top, settings for capture, preview, recording and webcam below

The preview after a capture, with Copy, Open, Folder and Delete buttons   The trim window: video preview, a thumbnail strip with two handles, and Save trimmed / Keep everything / Throw away

Install

SnapCap is developed and tested on Ubuntu 24.04 (GNOME 46, Wayland). It needs the AppIndicator extension with legacy tray icons, which Ubuntu ships and enables by default.

sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-gstreamer-1.0 python3-numpy \
  ffmpeg gstreamer1.0-pipewire gstreamer1.0-gtk3 gstreamer1.0-plugins-good
# optional, for recording on the graphics card:
sudo apt install gstreamer1.0-vaapi gstreamer1.0-plugins-bad

git clone https://github.com/GAServantes/snapcap.git ~/snapcap
cd ~/snapcap && ./install.sh

The installer adds SnapCap to your app menu and to start at login, puts a snapcap command in ~/.local/bin, adds the keyboard shortcuts below, and gives SnapCap permission to take screenshots without asking each time. SnapCap runs from the folder you cloned. ./install.sh --remove takes it all out again; your captures stay where they are.

Using it

Left-click the tray icon to capture a region. Right-click opens the panel under the icon, like a menu, with every action and setting. A click outside it, Esc, or another right-click on the icon closes it.

In the selection screen:

Do To
Drag Select an area
Click without dragging Whole screen, or with snap on, the element under the pointer
C Copy the color under the pointer
Esc / right-click Cancel
With adjust before saving: drag inside, handles, arrows, Shift+arrows Move, resize, nudge (Ctrl: 10 px), resize by keyboard
Enter, double-click or ✓ Save Save the adjusted selection

Recording: a red border marks the area, with ■ Stop and ✕ (throw away) next to it. The tray icon turns red while recording. To stop:

  • click ■ Stop next to the area,
  • left-click the red tray icon (stop and save),
  • right-click the tray icon for Stop and save or Throw away at the top of the panel. The video ends where you opened the panel, so the panel isn't in it,
  • or press the shortcut again.

A full-screen recording leaves no room for the Stop bar, so a note in the middle of the screen counts down 3 seconds first and says how to stop. The note is gone before recording starts.

Recording sound only: right-click → Record sound. It records what the Record computer sound and Record microphone switches say (one or both), so turn on the one you want first. A small bar under the tray icon shows the time and how loud the incoming sound is, with ■ Stop and ✕. Left-clicking the red tray icon or snapcap --sound also stops it. The MP3 is saved with your other captures, and the preview shows its waveform.

With trim before saving on, a trim window opens when you stop: drag the two handles, Space plays, I/O set the start and end.

Scrolling capture: keep your hands off the mouse while it scrolls. It stops at the end of the page, when you press ■ Stop, or when you click the tray icon (it keeps the screens taken so far).

Keyboard shortcuts (GNOME custom shortcuts, added by the installer):

Keys Action
Ctrl+PrtSc Capture a region (repeats the last one if that's on)
Ctrl+Shift+PrtSc Start or stop a video recording
Ctrl+Alt+PrtSc Start or stop a GIF recording

Command line (talks to the running SnapCap): snapcap --region, --select, --full, --scroll, --pick, --record, --gif, --sound, --stop, --abort, --folder, --settings, --status, --quit.

Privacy

Everything stays on your computer: SnapCap never goes online. GNOME shows its orange privacy dot while a recording or scrolling capture runs, because the screen is being captured. Screenshots never contain the dot: the pointer is added by comparing two captures and copying only the pointer's pixels.

How it works

It is one Python/GTK 3 file, snapcap.py. The screenshot picture comes from the desktop portal; the pointer and the scrolling frames come from GNOME's screen-capture API (Mutter ScreenCast), and scrolling uses Mutter's RemoteDesktop API. Recordings go through GNOME Shell's own recorder, on the graphics card when possible, and ffmpeg records the sound and saves the result. Unit tests: python3 -m unittest discover -s tests.

Known limits

  • One monitor is assumed.
  • Scrolling capture only goes down, and pages that change while they scroll (lazy-loaded images, endless feeds) can confuse it. It was tested on GTK apps and a WebKit browser engine; Chrome and Firefox haven't been tested yet.
  • Webcam overlay has only been tested with a simulated camera.

Changelog

  • 1.5.0: Record sound: computer sound and/or the microphone as an MP3, with nothing from the screen. A small bar shows the time and a level meter, and the preview shows the waveform.
  • 1.4.2: The right-click panel opens at the tray icon even when the top bar has been moved (to the bottom of the screen, say) after SnapCap started. Before, it opened where the bar used to be.
  • 1.4.1: Easier to stop a recording, especially a full-screen one: left-click the red tray icon, or use Stop and save in the right-click panel (it never showed before). A full-screen recording says how to stop before it starts. The panel now always opens under the tray icon; before, it could open in a corner of the screen.
  • 1.4.0: Edit button on a video's preview opens it in Splice (when installed). American English throughout.
  • 1.3.1: First public release.

License

GPL-3.0-or-later. See LICENSE. Copyright (C) 2026 G. Austin Servantes.

Releases

Packages

Contributors

Languages