Frametap

Cross-platform screen capture for macOS, Linux, and Windows.

What you get

🖥

GUI App

Graphical app with live preview of any monitor or window. Click to capture, save as PNG.

CLI Tool

Interactive command-line tool. Capture monitors, windows, or regions from your terminal.

📚

C++ Library

Static C++ library you can embed in your own apps. Screenshot or stream frames with a simple API.

Quick Start

bash
# List available monitors
frametap --list-monitors

# Capture a monitor by ID
frametap --monitor 1

# Capture a window by ID
frametap --window 12345

# Capture a region (x,y,width,height)
frametap --region 0,0,1920,1080

# Save to a custom file
frametap --monitor 1 -o desktop.bmp

# Interactive mode (menu-driven)
frametap --interactive

Run frametap --help to see all options.

Platform Support

Platform Status
macOS 12.3+ Fully supported
macOS 10.15+ Screenshots only (older fallback)
Linux (Wayland) Fully supported — GNOME, KDE, Sway, Hyprland
Linux (X11) Fully supported
Windows 10+ Fully supported
Windows 8+ Screenshots only (GDI fallback)

Install

macOS (Homebrew)

brew tap krazyjakee/tap
brew install frametap

Ubuntu / Debian (apt)

curl -fsSL https://krazyjakee.github.io/frametap/apt/frametap.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/frametap.gpg
echo "deb [signed-by=/usr/share/keyrings/frametap.gpg] https://krazyjakee.github.io/frametap/apt stable main" | sudo tee /etc/apt/sources.list.d/frametap.list
sudo apt update
sudo apt install frametap

Or download the .deb from the Releases page and install with sudo apt install ./frametap_*.deb.

Linux (quick install)

curl -fsSL https://raw.githubusercontent.com/krazyjakee/frametap/main/install.sh | sh

Arch Linux (AUR)

yay -S frametap-bin

Windows (Scoop)

scoop bucket add frametap https://github.com/krazyjakee/scoop-frametap
scoop install frametap

Windows (winget)

winget install krazyjakee.frametap

Download binaries

Grab the latest release for your platform from the Releases page. Each release includes:

  • GUIframetap_gui — graphical app with live preview
  • CLIframetap — interactive command-line tool
  • Librarylib/ and include/ — static C++ library for developers

Support

If you find Frametap useful, consider sponsoring to help sustain and grow it.

This is optional support. Frametap remains free and open-source regardless.