AirMagic

From AwkwardTV

AirMagic - For AppleTV 4G Take 4
Current Version: 1.0

Release date: April 8th, 2016
Current as of: April 11th, 2016

AirMagic is a mobile substrate plugin that runs a basic webserver to receive and relay IOHIDEvents for remote control and text entry on AppleTV 4.

This appliance is Copyright © 2016 nito llc. All Rights Reserved.

Contents 1 Change Log 2 Install Instructions 2.1 Additional Notes 3 API Information 3.1 remoteCommand 3.2 enterText 4 Client Downloads 5 Source Code 6 Donations

Change Log

1.0 2016 04 08

• Initial Release, Basic support for left, right, up, down, menu, play, select and text entry.

Install Instructions

1. NitoTV_Take_4#Install_Instructions

2. Install AirMagic from featured list

3. nitoTV-> Settings -> Respring (if it doesn't work after this, try reboot instead)

Additional Notes

If you have not changed your hostname http://apple-tv.local from any web browser on any device on the same network as your AppleTV should take you to a web control page.

There are also native iOS, Mac applications and Alpha Windows client available to control AirMagic server, i you don't want to install these applications and cannot get connections to work i recommend Bonjour Browser, there you can search for _airmagic._tcp. to get the host name or IP address for the AppleTV (and to verify the airmagic server is working properly)

API Information

Due to the fact AirMagic is just a basic web server, pretty much anything that can send HTTP requests can be a client for AIrMagic. In this current incarnation there are only 3 base commands that do anything for AirMagic at the moment.

remoteCommand

accepts any of the following. ie http://apple-tv.local/remoteCommand=left

left
right
up
down
menu
select
selectH (like clicking and holding main remote selection button)
play

enterText

send a percent encoding escaped string to enter it into any visible text field.

ie http://apple-tv.local/enterText=search

will put the string "search" in any visible text field.

Client Downloads

• iOS (IPA, requires manual resigning and manual installation without a jailbreak)
• Mac applications
• Alpha Windows client

If you are jailbroken you an add the nitosoft beta repo: http://nitosoft.com/beta2 to custom sources Cydia and then install com.nito.airmagicclient

Source Code

• AirMagic tweak iOS and Mac source code
• Windows source code

Donations

Donations are very appreciated and will insure this projects future.