Skip to content

arjunlohan/screengif

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ScreenGif

Record your screen as a GIF. Instant. Local. No tracking.

ScreenGif is a free, open-source screen recorder that outputs animated GIFs — perfect for UAT feedback, bug reports, and sharing UI interactions with your team. No accounts. No uploads. No BS.

  • Drag-to-select any region of your tab (like macOS ⌘⇧4, inside the browser)
  • 10fps · max 10 seconds · GIF auto-downloads on stop
  • 100% local — zero network requests, no servers, no telemetry
  • Keyboard shortcut: ⌘⇧6 (Mac) / Ctrl+Shift+6 (Windows/Linux)

Platforms

Platform Status
Chrome Extension ✅ Available
Safari Extension ✅ Available
macOS Native App ✅ Available (Electron)

Chrome Extension

Install from Chrome Web Store

Coming soon — listing under review.

Install manually (Developer mode)

  1. Clone this repo
  2. Open chrome://extensions
  3. Enable Developer mode (top right toggle)
  4. Click Load unpacked → select the chrome-extension/ folder
  5. The ScreenGif icon appears in your toolbar

Usage

  1. Click the ScreenGif icon (or press ⌘⇧6)
  2. Record Tab — captures the current tab instantly, no picker dialog — or — Full Screen / Window — opens Chrome's source picker
  3. Drag on the page to select a region (or skip for full tab)
  4. Click Stop when you're done (max 10s)
  5. GIF saves automatically to ~/Downloads

Safari Extension

Built with xcrun safari-web-extension-converter from the same source.

xcrun safari-web-extension-converter safari-extension/ --app-name ScreenGif

Open ScreenGif/ScreenGif.xcodeproj in Xcode, build the macOS target, then enable in Safari → Settings → Extensions.

Note: Safari doesn't support chrome.tabCapture, so only Full Screen / Window recording is available (via getDisplayMedia).


macOS Native App

Electron app with system tray, global shortcut, and — the key feature over the browser extension — true animated GIF clipboard copy. Paste directly into Linear, Slack, GitHub Issues, or anywhere else with ⌘V.

cd macos-app
npm install
npm start

Build a distributable .dmg:

npm run build

macOS will prompt for Screen Recording permission on first launch.

Features vs browser extension

Feature Chrome Extension macOS App
Copy animated GIF to clipboard ✗ (browser API limitation) ✅ (⌘V into Linear/Slack)
Source picker with thumbnails Chrome's built-in picker Custom grid with live thumbnails
System tray
Global shortcut
Record current tab only ✅ (no picker)

Why GIF?

GIF renders inline in Linear, Slack, GitHub, and most email clients without requiring a video player or external service. Unlike Loom, a GIF attaches directly to a ticket and plays immediately in context.

Property Value
FPS 10fps
Max duration 10 seconds
Typical file size 1–3 MB (cropped UI region)
Colors 256 per frame (great for UI, not photos)
Audio None

Privacy

All processing is local. ScreenGif makes zero network requests. Your screen content never leaves your machine. No accounts, no telemetry, no analytics.

Chrome extension permissions:

  • tabCapture — record the current tab without a picker dialog
  • downloads — save the GIF to your Downloads folder
  • scripting + activeTab — inject the region-selection overlay into the page
  • offscreen — hold the tab media stream while encoding
  • notifications — show an error if a tab can't be captured (e.g. chrome:// pages)

Development

No build step required for the Chrome or Safari extensions. gifenc is bundled at chrome-extension/lib/gifenc.js.

# Update gifenc to latest
npm pack gifenc
tar -xzf gifenc-*.tgz
cp package/dist/gifenc.esm.js chrome-extension/lib/gifenc.js
cp chrome-extension/lib/gifenc.js safari-extension/lib/gifenc.js
cp chrome-extension/lib/gifenc.js macos-app/lib/gifenc.js

Roadmap

  • Chrome extension — tab capture, region selection, GIF encoding
  • Chrome Web Store listing
  • Safari extension
  • macOS native app — system tray, global shortcut, animated GIF clipboard copy
  • gifski integration for higher quality GIF (macOS app only)
  • Configurable FPS and duration
  • WebP output option

Contributing

PRs welcome. Please open an issue first for significant changes.


License

MIT — see LICENSE

About

Record your screen as a GIF. Instant. Local. No tracking.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors