Gifrog

Turn every screen recording into a clean, elegant GIF.

English · 中文

---

Gifrog is a macOS menu bar utility that captures any region, window, or full screen and exports it as an optimized GIF, MP4, or WebM — with built-in trimming, click highlighting, and one-click clipboard copy. No Dock icon, no clutter. Just a frog in your menu bar.

Download

Download the latest .dmg from GitHub Releases, open it and drag Gifrog to Applications.

Note: macOS may show an "unidentified developer" warning on first launch. Right-click the app and select Open to bypass it.

Features

• Three capture modes — Region, Window, or Full Screen
• Multiple export formats — GIF, MP4 (H.264), WebM (VP9)
• Built-in editor — Video preview, timeline trimming, live file-size estimation
• Click highlighting — Visual overlays for mouse clicks during recording
• Global hotkey — ⌥⇧G to start/stop recording from anywhere
• Clipboard integration — Exported files are automatically copied to clipboard
• Drag & drop import — Import existing MP4, MOV, M4V, or WebM files
• Crash recovery — Automatically recovers incomplete recordings on launch
• Launch at login — Optional auto-start via macOS ServiceManagement

Usage

1. Launch — a frog icon appears in your menu bar
2. Choose mode — click the icon → Region / Window / Screen
3. Record — use the floating toolbar to pause or stop
4. Edit & export — trim in the editor, pick format and quality, export

Keyboard Shortcuts

Shortcut	Action
⌥⇧G	Start / Stop recording
Space	Pause / Resume
Esc	Cancel recording

Configuration

Open settings via the gear icon in the popover menu:

Setting	Default	Options
Frame rate	15 fps	10 / 15 / 24 / 30
Scale	100%	100% / 75% / 50%
Format	GIF	GIF / MP4 / WebM
Quality	Medium	Low / Medium / High
Countdown	3s	0 / 3 / 5 seconds
Show cursor	On	On / Off
Click highlight	On	On / Off
Launch at login	Off	On / Off
Save path	~/Movies/Gifrog	Custom path

Quick Start

# Clone and build
git clone git@github.com:Moosphan/Gifrog.git && cd Gifrog
swift build -c release

# Or build as .app bundle
bash scripts/build_app.sh && open dist/Gifrog.app

Requirements: macOS 13+, Xcode 15+ (or Swift 5.10 toolchain)

Architecture

Sources/Gifrog/
├── main.swift                    # App entry point
├── Models.swift                  # Data models
├── Controllers/                  # AppKit window & state management
│   ├── GifrogController.swift    # Central coordinator
│   ├── StatusBarController.swift # Menu bar icon & popover
│   └── ...
├── Recording/                    # Screen capture pipeline
│   ├── ScreenCaptureRecorder.swift  # ScreenCaptureKit-based
│   ├── FrameRecorder.swift          # Recording orchestrator
│   └── ClickEventRecorder.swift     # Mouse click capture
├── Export/                       # FFmpeg-based export
│   └── ExportManager.swift
├── Views/                        # SwiftUI views
└── Resources/                    # App icons

Tech Stack

Component	Technology
Language	Swift 5.10
Build	Swift Package Manager
UI	SwiftUI + AppKit
Capture	ScreenCaptureKit
Video	AVFoundation
Export	FFmpeg
Hotkeys	Carbon HIToolbox

License

Apache License 2.0 © 2026 Gifrog