Skip to content

A keyboard switches sound simulator for Linux and MacOS written in Python

License

Notifications You must be signed in to change notification settings

PlankCipher/tripleS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 

Repository files navigation

tripleS

Wise man once said: No software can give you the feeling of the switches, just the sound.

tripleS is a keyboard switches sound simulator for Linux and MacOS written in Python.

Dependencies

Packages

  • sox => to play sounds
  • python-xlib => required by pyxhook

Python Libraries

  • pyxhook => to listen to keyboard events

Usage

usage: tripleS.py [-h] [-v VOLUME] -s SOUNDS

Keyboard switches sound simulator.

optional arguments:
  -h, --help            show this help message and exit
  -v VOLUME, --volume VOLUME
                        Volume of switch sound (float)
  -s SOUNDS, --sounds SOUNDS
                        Path to directory cotaining switches sounds. Have a look at https://github.com/PlankCipher/tripleS#sounds for more info

Examples:
  python tripleS.py -s sounds/modelm/
  python tripleS.py -s sounds/hhkb2_pro_topre -v 1.7

Sounds

Currently, the supported file types are wav and mp3. The directory containing keyboard switches sounds you want to play can and must be specified via the -s/--sounds option.

The directory must contain the following so that the program accepts using it:

  • A file called enter.wav or enter.mp3 for the enter key sound.
  • A file called space.wav or space.mp3 for the space key sound.
  • At least one file for the sound of the rest of the keys. The file can be called anything as long as it ends with .wav or .mp3. The more files you have for this, the more variety of sounds you get.

Contributions

Contributions are highly appreciated, specially with sound files.

Credits

The credit for Model M and Happy Hacking Keyboard Professional 2 sounds goes to millerjs.

About

A keyboard switches sound simulator for Linux and MacOS written in Python

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages