A simple menubar app that allows you to control an Apple TV from your desktop
The latest version works with tvOS 15 and up. It requires Python 3 to be installed on the system to work properly.
When the program starts, it will attempt to install the necessary modules for Python to work properly. If you have custom scripts under the working directory, please check the release notes for v1.1.1 to see what steps you need to take for this to work for you.
On first run this program will run pip
to install modules under a self-contained env
directory. This program still works as it used to once it is running, but it does use a more complex method for communicating with the Apple TV.
Also note if you don't see an option for entering text, you may need to pair with your ATV again. You have to enter 2 codes instead of 1 because sending text to search fields uses a different protocol.
I've created macOS and Windows releases available here: https://github.com/bsharper/atv-desktop-remote/releases
- All of the keys are mapped to the keyboard when the application is open (pressing return or enter on the keyboard for select, delete for Menu, etc).
- Press
Option
to see what the characters are mapped to when the application is open.
- Run
npm install
oryarn
- Run
npm start
oryarn start
- The application runs in the menubar. Look for a tiny remote icon and click on it. Right-click for more options.
- The first time the app runs it will need to pair with an Apple TV. You can pair with more than one.
- Press
Cmd+Shift+R
to open the application from anywhere. On Windows itsCtrl+Shift+R
electron-builder
is used to create a standalone application.
This is cobbled together from a few projects I've worked on. It works well enough for me for daily use, so I figured others might like it.