gitwtfhub

wtf is vestige?

sandeepwastaken/vestige — explained in plain English

Analysis updated 2026-05-18

4SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

A macOS menu bar app that keeps a rolling replay buffer of gameplay and saves the last moments as an MP4 on a hotkey press.

Mindmap

mindmap
  root((Vestige))
    What it does
      Rolling replay buffer
      Hotkey saves MP4
      Menu bar app
    Features
      Auto game detection
      HEVC or H.264
      Discord size presets
    Privacy
      No accounts
      No network code
      Local files only
    Audience
      Mac gamers

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

Why would anyone build with this?

REASON 1

Save the last minute of a great gaming moment without recording constantly to disk

REASON 2

Export a short clip and share it directly to Discord with built in size presets

REASON 3

Build a searchable local library of favorite gameplay clips

What's in the stack?

SwiftSwiftUIAVFoundationVideoToolbox

How it stacks up

sandeepwastaken/vestigeanywhere-music-player/codexlimitsaydahnizzy/calendar-drag-interaction
Stars444
LanguageSwiftSwiftSwift
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencegeneraldeveloperdeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires macOS 14 or later and a Mac with hardware video encoding.

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

Wtf does this do

Vestige is a Mac app that acts as a replay buffer for gameplay, similar to the instant replay feature PC gamers get from tools like ShadowPlay. It sits in the menu bar, watches for games running on your Mac, and continuously keeps the last few seconds or minutes of gameplay in memory. When something worth keeping happens, you press a hotkey and Vestige turns that buffered footage into a local MP4 file. The app is built natively for macOS using Apple's ScreenCaptureKit for capture, VideoToolbox for hardware video encoding, AVFoundation for writing video files, and SwiftUI for the interface. Because the replay buffer stays in memory rather than being written to disk continuously, saving a clip is a quick operation rather than a full re encode of long recorded footage. Features include automatic detection of games you are playing, replay lengths from thirty seconds up to ten minutes with custom options, rebindable keyboard shortcuts, hardware accelerated encoding in either HEVC or H.264, optional system audio and microphone capture with the microphone off by default, and built in compression presets sized for sharing clips on Discord. A clip library lets you search, favorite, sort, and rename saved clips. Vestige requires macOS 14 or later and a Mac with hardware video encoding, with Apple silicon recommended. You can install it by downloading a DMG file, which is not notarized by Apple so macOS will show a security warning the first time you open it, or you can build the app yourself from source using a provided build script. The privacy model is straightforward: there are no accounts, no cloud syncing, no telemetry, no advertising, and no network code anywhere in the app, so nothing about your gameplay or clips ever leaves your Mac. Command line diagnostic tools are included for checking permissions, audio, and the capture pipeline if something is not working. The project is licensed under MIT.

Yoink these prompts

Prompt 1
Walk me through installing Vestige and granting screen recording permission
Prompt 2
Explain the difference between HEVC and H.264 encoding options in Vestige
Prompt 3
Show me how to build Vestige from source using the build-app script
Prompt 4
Help me set up a custom replay length and hotkey in Vestige settings

Frequently asked questions

wtf is vestige?

A macOS menu bar app that keeps a rolling replay buffer of gameplay and saves the last moments as an MP4 on a hotkey press.

What language is vestige written in?

Mainly Swift. The stack also includes Swift, SwiftUI, AVFoundation.

What license does vestige use?

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

How hard is vestige to set up?

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

Who is vestige for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.