Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…
Cannot retrieve contributors at this time
58 lines (42 sloc) 2.28 KB

App Remote

Listens to button presses from an Apple Remote, and calls application-specific AppleScript subroutines.

Similar to the basic functionality of Sofa Control, without the bells and whistles, and the price tag.

Tested on OS X 10.8 Mountain Lion using a white Apple Remote.

Installing the Binary

  1. Download the latest zip file from GitHub
  2. Expand the archive (usually clicking on it works).
  3. Drag "App" to the Applications folder.
  4. Drag "App Remote Scripts" to your Documents folder, or another desired location.
  5. Double-click "App" to open it.
  6. The first time you launch the app, you will be prompted to choose a folder. Select the "App Remote Scripts" folder you copied earlier.

See Usage below for scripting instructions.


Assuming you have Xcode and git installed, run the following command in Terminal:

git clone
cd App-Remote
git submodule update --init

Open App-Remote.xcodeproj in Xcode, select the target "App Remote", and click Run.


App Remote runs as a menu bar extra. Currently the icon is "▶".


On the first launch, App Remote will prompt you to select a directory for the event handling scripts. This is where you will put the AppleScript to handle remote button presses. This folder can be changed by clicking on the app menu and "Choose Script Folder".

Scripts can be written in the AppleScript Editor, which is bundled with Mac OS X. Scripts must be named "NameOfApp.scpt", for example, "Keynote.scpt". The handlers are subroutines named in the following way:

  • NameOfAppPlay
  • NameOfAppPlayHold
  • NameOfAppUp
  • NameOfAppUpHold
  • NameOfAppDown
  • NameOfAppDownHold
  • NameOfAppLeft
  • NameOfAppLeftHold
  • NameOfAppRight
  • NameOfAppRightHold

An example for the Keynote script would be:

on KeynoteUp
    *... do something in AppleScript*
end KeynoteUp

Take a look at Default.scpt (the fallback script) in the Resources folder for an example script file.

Jump to Line
Something went wrong with that request. Please try again.