What's this?

evtone is a command-line program that plays tones on any beeper device on Linux, such as your PC speaker or the pwm-beeper module.

Unlike 'beep' or similar tools, evtone only supports outputting SND_TONE events to devices you'll find in /dev/input. No attempt to play tones through the connected terminal or to single tone hardware is supported.

How do I use it?

Copy and pasted from evtone --help:

Usage: evtone [OPTION...] TONE [TONE...]
TONE is of the format HZ:MILLISECONDS
Up to 256 TONEs may be specified at once.

  -d, --dry-run              Print what the program will do
  -D, --device=FILE          /dev/input device to use to play tones
                             If not supplied the device will be guessed
  -?, --help                 Give this help list
      --usage                Give a short usage message
  -V, --version              Print program version

Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.

Examples:
  "evtone 440:1500" plays a tone of 440Hz for 1500 milliseconds.
  "evtone 440:1500 300:10" plays a 440Hz tone for 1500 milliseconds
    followed by a 300Hz tone for 10 milliseconds
  "evtone -d 440:1500 300:10" will print what the program will do
    instead of actually doing it
  "evtone -D /dev/input/event2 440:1000" will play a 440Hz tone for
    1000 milliseconds using the /dev/input/event2 device

Here's some example happy beeps you can try:

$ evtone 220:100 275:100 330:100 440:100 550:100 660:100 880:200

System requirements

You need the following to build and run this software:

• Linux kernel
• glibc
• GCC (for building only)
• Meson (for building only)

To build and run with Meson use these commands:

$ meson setup build
$ cd build
$ ninja
$ ./evtone

If you really dislike Meson, you can build with just GCC like this:

$ gcc evtone.c -o evtone
$ ./evtone

Developer notes

Make sure to run this after checking out:

git config blame.ignoreRevsFile .git-blame-ignore-revs

TODO

There's always new stuff to add to software. Some future ideas for evtone:

• Find bugs (I'm sure they're there!)

License

evtone is licensed under the MIT license.

• Copyright: 2022 Jookia contact@jookia.org
• SPDX-License-Identifier: MIT