Skip to content

Repository files navigation

Catfeine

A tiny, native menu bar utility for macOS that keeps your Mac awake — like Caffeine / Amphetamine, but with a cat.

🇹🇷 Türkçe README

What it does

  • Menu bar icon toggles sleep prevention on/off — a sleepy cat when off, an alert cat when on.
  • Pick a duration (15 min / 30 min / 1 hour / 2 hours) or leave it indefinite.
  • Uses macOS's own power management API (IOPMAssertionCreateWithName) — the same mechanism the built-in caffeinate command line tool uses, no hacks.
  • Native SwiftUI MenuBarExtra, no Electron, no background daemons beyond the app itself.
  • Idle resource usage: ~0% CPU, ~80 MB RAM (measured on macOS 26, Apple Silicon).

Requirements

  • macOS 14 (Sonoma) or later.
  • Universal binary — runs natively on both Apple Silicon and Intel Macs.

Installing

No signed release yet — for now, build it yourself:

git clone https://github.com/CoYildiz/catfeine.git
cd catfeine
./Scripts/build-app.sh
open dist/Catfeine.app

This produces dist/Catfeine.app, a real, double-clickable app bundle. It's ad-hoc signed (not notarized), so on first launch macOS will show an "unidentified developer" warning — right-click the app and choose Open once to bypass it. This is the same one-time step most open-source Mac menu bar apps require without a paid Apple Developer notarization certificate.

Development

This project is a plain Swift Package (no Xcode project file needed):

swift build      # compile
swift run        # compile + run (shows in the Dock too — quick iteration only)
swift test       # unit tests

See CLAUDE.md and docs/ for architecture notes and the project roadmap (development docs are in Turkish; the app's UI and this README are in English/Turkish).

Credits

Cat artwork: see CREDITS.md (Flaticon, Marz Gallery).

License

MIT — feel free to suggest a different license if you'd rather use something else; this was picked as a permissive default and hasn't been locked in yet.

About

Tiny native macOS menu bar app that keeps your Mac awake — like Caffeine/Amphetamine, but with a cat

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages