/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.

Primary LanguageObjective-C

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 Remote.app" to the Applications folder.
  4. Drag "App Remote Scripts" to your Documents folder, or another desired location.
  5. Double-click "App Remote.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.

Building

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

git clone https://github.com/DennisTT/App-Remote.git
cd App-Remote
git submodule update --init

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

Usage

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

Screenshot

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.