cocainate

README

cocainate

Description

cocainate is a cross-platform CLI utility for keeping the screen awake until stopped, or for a specified duration.

Why This Name?

The program's functionality and name are inspired by macOS's caffeinate utility that prevents the system from entering sleep mode.

This name is simply a stupid pun, therefore I do not condone and do not promote drug use, for more information: Wikipedia.

Installation (working progress)

Arch Linux Distributions

• yay:

yay -S cocainate-bin

• paru:

paru -S cocainate-bin

macOS

• Homebrew Tap:

brew tap AppleGamer22/cocainate
brew install cocainate

Windows (working progress)

• winget:

winget install AppleGamer22.cocainate

Other

• go:

go install github.com/AppleGamer22/cocainate

Functionality

Root -d/--duration Flag

This is an optional flag that accepts a duration string (see Go's time.ParseDuration for more details). If this flag is not provided, the program will run until manually stopped.

Acceptable Time Units

• nanoseconds: ns
• microseconds: us or µs
• milliseconds: ms
• seconds: s
• minutes: m
• hours: h

Examples

• 10 hours: -d 10h
• 1 hour, 10 minutes and 10 seconds: -d 1h10m10s
• 1 microsecond: -d 1us

If the --pid flag is provided, the -d flag's value is used as process polling interval.

Root --pid Flag

This is an optional flag that accepts a process ID (PID). If a valid PID is provided, the program will wait until that process is terminated. The delay between the termination of the provided process and the termination of screensaver inhibitation depends on the -d flag (which must be provided).

version Sub-command

-v/--verbose Flag

• If this flag is provided, the following details are printed to the screen:
  1. semantic version number
  2. commit hash
  3. Go compiler version
  4. processor architecture & operating system
• Otherwise, only the semantic version number is printed.

Dependencies

Linux

• D-Bus
• One of the following desktop environments:
  • KDE 4 or later
  • GNOME 3.10 or later
  • Any other desktop environment that implements org.freedesktop.ScreenSaver

Common Contributor Routines

Testing

Running the following command will run go test on the cmd and session sub-modules:

make test

Building From Source

Running the following command will run go build for:

• Linux
  • AMD/Intel 64-bit processors
  • ARM 64-bit processors
  • RISC-V 64-bit processors
• macOS
  • AMD/Intel 64-bit processors
  • ARM 64-bit processors
• Windows
  • AMD/Intel 64-bit processors
  • ARM 64-bit processors

make build

Building from source for an individual operating system is available via:

• Linux

make linux

• macOS

make mac

• Windows

make windows

All binary artificats are stored in the bin child directory in the codebase's root directory.

Packaging

Running the following command will package the program binaries and shell (BASH, ZSH, FISH and PowerShell) completion scripts for:

• Arch Linux Distributions
• macOS
• Windows

make package

Copyright

cocainate is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

cocainate is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.