DomeKey

Control your computer with a pair of headphones

DomeKey gives you the power to remap your headphone buttons to any action you can think of. Define mappings in text using a Vim-like configuration language.

• Simulate keyboard keys to control applications or automate actions
• Run shell commands at the press of a button
• Define as many actions as you need by adding modes, or triggering an action with a sequence of headphone buttons

With up to three new button inputs, the possibilities are endless.

Examples

Video controls:

map <Up> <Left>
map <Play> <Space>
map <Down> <Right>

Preserve volume buttons and include video controls in a mode:

# Don't launch iTunes when pressing the middle button
map <Play> <Nop>

mode <Play><Play> {
    map <Up> <Left>
    map <Play> <Space>
    map <Down> <Right>
}

Open frequently used applications:

cmd <Up>       open -a Terminal
cmd <Play>     open -a Xcode
cmd <Down>     open -a Firefox
cmd <Up><Play> open -a Dictionary

Open Terminal window #2:

cmd <Play> osascript -e 'activate application "Terminal"' -e 'tell application "System Events" to keystroke "2" using command down'

Manual

dome-key(1), dome-key-mappings(7)

Editor plugin

A Vim syntax plugin is available for the DomeKey mapping syntax.

System requirements

• Mac OS X 10.12 and later
• Wired headphones with 1–3 buttons (Bluetooth headphones are currently unsupported. If you know of a way to access bluetooth headphone events, please get in touch.)

Purchasing

Licenses are valid for all 1.x releases of the program.