https://github.com/adroll/aircontrol

Control AirPlay Mirroring from the command line.
https://github.com/adroll/aircontrol

Last synced: about 1 year ago
JSON representation

Control AirPlay Mirroring from the command line.

• Host: GitHub
• URL: https://github.com/adroll/aircontrol
• Owner: AdRoll
• License: mit
• Created: 2014-09-26T20:08:45.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2017-08-05T00:16:21.000Z (almost 9 years ago)
• Last Synced: 2025-03-24T11:12:17.405Z (about 1 year ago)
• Language: Shell
• Homepage:
• Size: 5.9 MB
• Stars: 96
• Watchers: 26
• Forks: 12
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
AirControl

==========

Simple utility for controlling AirPlay Display Mirroring from the command line.

Installation

------------

    ln -s $PWD/aircontrol ~/bin  # assuming ~/bin is on your PATH

If you want tab completion and have bash-completion installed, then install aircontrol completion:

    ln -s $PWD/aircontrol-completion.bash /usr/local/etc/bash_completion.d/aircontrol-completion.bash

Usage

-----

Mirror display to Apple TV named "2nd Floor Lounge":

    aircontrol "2nd Floor Lounge"

The first time you do this, you'll be prompted to grant accessibility access to

"Terminal" (or iTerm, if that's your thing). Go into System Preferences ->

Security & Privacy -> Privacy and check the box for "Terminal". You won't be

prompte for this in the future.

Stop mirroring:

    aircontrol -k

Completion:

    aircontrol 2nd

    # expands to

    aircontrol 2nd\ Floor\ Lounge

    # assuming such a device is on your local network

In action

---------

![aircontrol in action](./aircontrol.gif)

Details

-------

For details on how we built it, please check out this blog post: [http://tech.adroll.com/blog/terminal/2014/09/26/introducing-aircontrol-control-airplay-through-terminal.html](http://tech.adroll.com/blog/terminal/2014/09/26/introducing-aircontrol-control-airplay-through-terminal.html)

Contributors

---

- Timothée Boucher https://github.com/Timothee

- Eric Allen https://github.com/epall

- Kyle Engibous https://github.com/kengibous