GitHub - drybjed/chimed: wind chimes in your UNIX environments

2 min read Original article ↗

The chimed daemon is an equivalent of a wind chime in a Linux system. It provides a way for other programs to create various sounds with simple interfaces - interrupt signals, UDP or TCP packets, UNIX sockets.

Installation

The chimed installation requires libasound2 development files, needed to build the simpleaudio Python module.

sudo apt install libasound2-dev

You can install chimed from source in editable mode, if you want to work on it:

git clone https://github.com/drybjed/chimed ~/src/github.com/drybjed/chimed
pipx install --editable ~/src/github.com/drybjed/chimed

You can also install chimed from PyPI:

Usage

After installation, run the daemon in a terminal window:

You can send commands to it using a FIFO file:

# Play a bell sound
echo "chime" >> $XDG_RUNTIME_DIR/chimed/fifo

The default installation includes a set of chimes and a corresponding configuration for vim editor. You can check the lib/vim/vimrc file in the repository to see an example configuration you need to include in your ~/.vimrc configuration to integrate with chimed. There's also an example systemd unit file available, to run chimed as an user daemon.

The internal configuration can be viewed using:

You can put YAML, TOML and JSON files in the ~/.config/chimed/conf.d/ directory to add or modify configuration options. See lib/example-config.toml for a starting point.

Bell options

Key Default Description
resource — WAV file from the bundled package (see chimed config get bells)
min_interval 0.08 Minimum seconds between successive plays of this bell — controls the rate limit (lower = more responsive, higher = gentler on resources)

Copyright

Copyright (C) 2022-2024 Maciej Delmanowski drybjed@gmail.com

Attribution

This software includes sounds from freesound.org: