🎐 Chimes

A notification for passing hours.

Inspired by the Stoic idea of memento-mori, this utility reminds you of the finitude of time.

Features

• ⏲️ Set your pace: Define notification intervals (say) 1h or 30m.
• 🔔 Choose your bell: Use any .wav file for your chime.
• 📃 Custom messages: one message or a random pick from a list.
• 🔌 Offline-first: runs locally.

Usage

Run in the background:

(chimes &>/dev/null & disown)

Stop it later:

pkill chimes

Config

1. Configuration File

The app automatically initializes a configuration file at:

• Linux : ~/.config/chimes/config.json
• Mac : ~/Library/Application Support/chimes/config.json.

You can edit it manually:

{
	"interval": "1h",
	"sound_path": "/home/user/.config/chimes/bell.wav",
	"messages": ["The wheel of time turns."]
}

• interval: Use standard duration strings like 1h, 30m, or 45s.
• sound_path: The absolute path to your custom .wav file.
• messages: A list of strings (the app picks one at random for each notification).

2. CLI Options

You can override the config via flags (these update config.json).

• chimes -i 30m: Set interval to 30 mins.
• chimes "Keep going" "Stay present": Pass custom messages directly.
• chimes -reset: Wipe all settings and restore defaults.

Installation

For Linux 64-bit:

curl -sL https://codeberg.org/commitsovercoffee/chimes/releases/download/v1.0.0/chimes-linux-amd64 \
  -o chimes && chmod +x chimes && sudo mv chimes /usr/local/bin/

For macOS Intel (64-bit):

curl -sL https://codeberg.org/commitsovercoffee/chimes/releases/download/v1.0.0/chimes-darwin-amd64 \
  -o chimes && chmod +x chimes && sudo mv chimes /usr/local/bin/

For macOS Apple Silicon (arm64):

curl -sL https://codeberg.org/commitsovercoffee/chimes/releases/download/v1.0.0/chimes-darwin-arm64 \
  -o chimes && chmod +x chimes && sudo mv chimes /usr/local/bin/

Uninstallation

sudo rm /usr/local/bin/chimes # remove app
rm -rf ~/.config/chimes/ # remove data

Credits

• The sound used is from Notification Sounds.

License

This project is licensed under the GNU AGPLv3.