Piotr's site


In one sentence, Hammerboard is a windowless soundboard. You add as many folders of sounds as you like, naming them based on what key you want to trigger that sound. Then, with a simple key combination, your keyboard switches into a mode letting you press the key of any sound you set to play it. You have more sounds than keys on the keyboard? No problem! You can have as many subfolders as you want and switch between them to make categorising and remembering easy. 1 folder for movie quotes, another for sound effects, and one more for music clips. Whether you want to annoy your friends on voice chat or use it like a cart machine while DJing, Hammerboard will make it easy and stay out of your way.


On either Mac or the Windows version, you will need to create a sounds folder. On Mac, this will need to be in your Hammerspoon directory (~/.hammerspooon), and on Windows it needs to be in the same folder as the other files. If you run either version without creating the folder, it’ll be created and the program will close.

Under the sounds folder, make as many subdirectories for categories as you like. Give them descriptive names, as they will be spoken when you switch folders. The sounds should be named based on the key you want to use to play it. So fir instance, naming a sound C.wav will mean that pressing C will cause it to play. Generally, letters and numbers are best, though some special keys like space and return are also supported. For formats, the 2 versions support slightly different ones:

  • Mac supports anything Mac OS does for alert sounds. This includes wav, mp3, m4a, aif, aiff and flac.
  • Windows supports all formats supported by the bass sound library, which includes everything above apart from caf, as well as ogg.

For best cross-platform compatibility, use one of the more common formats like wav or m4a.

Once you have all the files you need, launch the windows exe or start hammerspoon on the Mac. To rescan folders or change the playback device, look for a Hammerboard icon in either the Mac menu bar or Windows System tray. To play a sound, press CTRL-Shift-P on Mac or CTRL+Windows+Alt+P on Windows. This will enter the Hammerboard layer and tell you what folder you’re playing from. From here, you can press: