https://github.com/bsharper/atv-desktop-remote

A simple app to allow you to control an Apple TV from your desktop
https://github.com/bsharper/atv-desktop-remote

Last synced: 26 days ago
JSON representation

A simple app to allow you to control an Apple TV from your desktop

• Host: GitHub
• URL: https://github.com/bsharper/atv-desktop-remote
• Owner: bsharper
• License: mit
• Created: 2021-03-24T02:54:17.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-07-08T15:11:40.000Z (5 months ago)
• Last Synced: 2024-08-03T09:05:47.254Z (4 months ago)
• Language: JavaScript
• Size: 2.19 MB
• Stars: 208
• Watchers: 14
• Forks: 12
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• Mac-Menubar-Megalist - ATV Desktop Remote

README

        
# ATV Desktop Remote

A simple menubar app that allows you to control an Apple TV from your desktop

 ![What this application looks like when running in either light or dark mode](screenshot.png)

 ## Update: Keyboard input works 

 

 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. 

 ## Download

 I've created macOS and Windows releases available here: https://github.com/bsharper/atv-desktop-remote/releases

## Usage

 1. 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).

 2. Press `Option`, or `Alt` on Windows, to see what the characters are mapped to when the application is open.

 ## Running

 1. Run `npm install` or `yarn`

 2. Run `npm start` or `yarn start`

 3. The application runs in the menubar. Look for a tiny remote icon and click on it. Right-click for more options.

 4. The first time the app runs it will need to pair with an Apple TV. You can pair with more than one.

 5. Press `Cmd+Shift+R` to open the application from anywhere. On Windows its `Win+Shift+R`

## Building

1. `electron-builder` is used to create a standalone application.

## Notes

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. 

This project is built using [pyatv.](https://pyatv.dev/)

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/brianharper)