https://github.com/jrr6/Caffeinator

A compact yet versatile menu-bar app for keeping your Mac awake.
https://github.com/jrr6/Caffeinator

caffeinate caffeine macos macos-menubar swift

Last synced: 2 days ago
JSON representation

A compact yet versatile menu-bar app for keeping your Mac awake.

• Host: GitHub
• URL: https://github.com/jrr6/Caffeinator
• Owner: jrr6
• License: mit
• Created: 2016-01-23T17:33:43.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2021-07-07T17:57:25.000Z (almost 4 years ago)
• Last Synced: 2025-04-11T21:19:06.704Z (about 1 month ago)
• Topics: caffeinate, caffeine, macos, macos-menubar, swift
• Language: Swift
• Homepage: https://jrr6.github.io/Caffeinator
• Size: 3.08 MB
• Stars: 18
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• Mac-Menubar-Megalist - Caffeinator

README

        


# Caffeinator

**Caffeinator is a menu-bar app that helps you prevent your Mac from falling asleep. It's a simple but robust visual interface for the `caffeinate` command-line tool.**

## Download

To download a prebuilt version of the latest stable release of Caffeinator, visit [Releases](https://www.github.com/jrr6/Caffeinator/releases).

## Build

Caffeinator is built upon the [CaffeineKit](https://github.com/jrr6/CaffeineKit) framework, which provides elegant Swift abstractions for interacting with `caffeinate`. Caffeinator uses [Carthage](https://github.com/Carthage/Carthage) to manage this and other dependencies. To build Caffeinator from source, clone this repository and run `carthage bootstrap --platform macOS --cache-builds` in the cloned directory. After doing so, open, build, and run the project in Xcode.

## FAQ

* **Why can't I open Caffeinator?**

  Probably because Caffeinator is not signed with a Developer Certificate. To open Caffeinator for the first time after installation, right-click on the app icon and click "Open," then confirm that you trust the app.

* **Why isn't there an option to specify a utility as an argument to `caffeinate` (as is shown in the man page)?**

  Because there's really no practical benefit to it, and it would create needless hassle. If you want equivalent functionality, start the process manually, then find its PID and use process-based Caffeination.

* **Why can't I start a timed Caffeination for a period of time shorter than one second?**

  Firstly, there isn't really any practical use for doing this. Secondly, the `caffeinate` utility will not accept time values shorter than one second. (If you specify a time shorter than one second using the argument editor, you'll see that it runs indefinitely.)

* **Why is this README so short?**

  Because Caffeinator has a website, which you can visit [here](https://jrr6.github.io/Caffeinator) and which also contains a [help guide](https://jrr6.github.io/Caffeinator/help.html).