The Pug Automatic

Using Apple media keys over the network

Written September 21, 2008. Tagged OS X, AppleScript.

We use a networked Mac Mini as media center, and usually play iTunes music off it, since it's hooked up to decent speakers.

If I'm using my own computer, controlling iTunes or changing volume on the Mini means I either have to physically walk over to it, or use Screen Sharing, or move my mouse over using Teleport.

The latter requires the Mini's screen (our tv) to be on, and to make things more bothersome, even though Teleport will send most keypresses to the Mini, the media keys (dedicated keyboard keys for back, play/pause, forward, mute, volume down and volume up) still control my own computer.

My solution was to write some scripts to do these things over the network, then bind them to F7, F8 etc. So e.g. pressing Fn+Play/pause (which amounts to F8) will play or pause on the remote computer.

I also used ControlMaster SSH settings to speed up the network action.

The scripts

These are shell scripts that have been made executable (chmod +x filename.sh). I keep them in ~/Library/Scripts/HyperControl. They use ssh to run AppleScript on the remote computer.

hyper is my SSH alias for the Mac Mini. My ~/.ssh/config file contains something like

~/.ssh/config
Host hyper
Hostname hyperion.local
User mini

and I log in by public key.

back.sh
#!/bin/bash
ssh hyper "osascript -e 'tell app \"iTunes\" to back track'"
playpause.sh
#!/bin/bash
ssh hyper "osascript -e 'tell app \"iTunes\" to playpause'"
next.sh
#!/bin/bash
ssh hyper "osascript -e 'tell app \"iTunes\" to next track'"
mute.sh
#!/bin/bash
ssh hyper "osascript -e 'set volume output muted not (output muted of (get volume settings))'"
volume_down.sh
#!/bin/bash
ssh hyper "osascript -e 'set volume output volume (output volume of (get volume settings) - 7)'"
volume_up.sh
#!/bin/bash
ssh hyper "osascript -e 'set volume output volume (output volume of (get volume settings) + 7)'"

Note that changing the volume this way does not give any feedback other than, of course, the volume changing. You will not see a volume indicator on the screen, and you will not hear the volume example sounds.

Binding them

To bind these scripts to keyboard keys, I use Quicksilver. I'm sure you could use something else like FastScripts Lite if you prefer.

If you use Quicksilver, you need to do a couple of things.

First, you need to install the Terminal module (in the Plug-ins tab) to be able to run shell scripts from Quicksilver.

Then, the scripts need to be indexed by Quicksilver. You can add the script folder in the Catalog tab, make sure it's set to include the folder contents, then hit the rescan button (circular arrow at the bottom) to index them.

And now for the mapping proper. Go to the Triggers tab and add the scripts as HotKey triggers. "Select an Item" should be the script, and the "Action" should be "Run (Run a Shell Script)". Hit "Save", then set the key in the info drawer. Quicksilver will show the F-keys as a blank value in the shortcut column; triggers with no shortcut get "None", though.

You can even set Quicksilver to repeatedly run the script, e.g. every 0.5 seconds, if the key is kept down.

ControlMaster for faster SSH

Now you should be able to run the scripts by using Fn plus the media keys.

Even in a local network, though, opening up a new SSH connection for every command can be a little slow.

Turns out you can use ControlMaster settings to reuse SSH connections. Basically, if you already have a SSH connection open to a machine, making another connection will be faster. But if you disconnect the first connection and then make another connection, there is no speedup.

The scripts above make a connection, run some AppleScript and then drop the connection, so there's no speedup there even if ControlMaster is activated.

My solution is to make my computer establish a master connection to the Mini when it's started. These scripts can then reuse that, and it will also speed up other SSH connections I make to that machine.

I use launchd to run code when my computer starts. This is ~/Library/LaunchAgents/name.henriknyh.controlmaster.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>name.henriknyh.controlmaster</string>
<key>ProgramArguments</key>
<array>
<string>/opt/local/bin/ssh</string>
<string>-MN</string>
<string>hyper</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>StandardOutPath</key>
<string>/dev/null</string>
<key>StandardErrorPath</key>
<string>/dev/null</string>
</dict>
</plist>

I needed to specify the full path to ssh, otherwise I saw issues. This is probably because my ssh is custom from MacPorts.

The M flag is master mode for connection sharing. The N flag means to send no commands, only connect.

To load this into launchd, run

launchctl load name.henriknyh.controlmaster.plist

from that directory (otherwise specify the full path). Then run

launchctl start name.henriknyh.controlmaster

to start it immediately, without waiting for next boot.

And that's it. Pretty complicated, but very useful, and easy to use once it's set up.