Main Page

Software - Hardware - Plugins - How-to Guides - Development - Potential Capabilities

KEEP THINGS ABSOLUTELY LEGITIMATE, PLEASE

Links to illegal warez, etc. will be removed, and your access will be blocked. (Details)

Welcome to the AwkwardTV Wiki As you probably know, Apple TV is a set-top box manufactured by Apple. Out of the box, it is enabled to stream digital content from any computer running iTunes. As there is little information provided about what is going on "under the hood" of the Apple TV, this is a place to collect and share information. This website is dedicated to finding additional uses for the Apple TV by (legitimately) enabling its Potential Capabilities, and is a place for the community to share ideas, discoveries and solutions. As such, when you add any comments or questions (not contributions to an informational page) please sign it using the signature button, , or four tildes (~~~~). It is for informational purposes only. AwkwardTV is not responsible if you void your warranty or damage your device. Beginners Guides If you're just getting started and trying to learn how to hack your Apple TV, then checking out the Beginners Guides section is probably the best place to start. This will help the novice get started with hacking the Apple TV, explaining steps in detail. Now in four flavours, we have: It's time to grow up FAQ | An FAQ for the latest AppleTV 4+ jailbreaks. A good place to start! A Guide for the Second Generation AppleTV. This is for those who want to jailbreak the new AppleTV that Apple released in September 2010. A Guide for 3.x. This is for those who want to run the "new" menu system that Apple released in October 2009. A Guide for 2.x aka Take 2. This is for those who want to run the menu system that Apple released in February 2008. A Guide for 1.x. This is for those who want to run the "old" menu system prior to Take 2 which was released February 2008. HackMeNot or The Alternative To Hacking. Tried hacking and messed it up? Just can't get stuff to work? Or think that it's just too complicated. You can get more from your Apple TV than you think with a few free apps and the correct settings in iTunes. Automation Mac Only. How to use Applescript to watch a folder for new videos of any type, convert these files to Apple TV format, add them to iTunes, process them and name them neatly. How To's How To Section covering Hard Drive Preparation and General Software Modifications. Take 2 Full Update - Walkthrough on getting your new AppleTV Take 2 modified with SSH, new codecs, USB support and more Plugins How to automatically/manually install plugins AppleTV Take 2 Plugin Compatibility List AppleTV Take 3 Plugin Compatibility List Development Plugin Tutorials For Developers FRAppliance 101 - Tutorial for creating new PlugIns FRScreenSaver 101 - Tutorial for creating screen savers. Please read FRAppliance_101 first. BackRow_2.3 - Instructions for linking against BackRow 2.3 headers in your PlugIn project. BackRow_2.3_SDK - almost ready to deploy SDK for developing 2.3/2.4 compatible frappliances with XCode 3.1+ on 10.5 Leopard BackRow_3.0_SDK - an update for ATV 3.0 with a template for XCode 3.x Advanced BackRow Coding - An Ongoing Series Introduction To Custom Controls A Custom Layer Controller Extra Credit 1: Animations A Downloader Controller BackRow Developers' Kit - A Mac OS X application and utilities to aid in creating and debugging new plugins. Create Environment for stock ATV 1.1 Development with Leopard Setting up the development environment in Leopard Plug-in Developers Note Pad - Snippits of information that may help others. Alan Quatermain Video Tutorials Alan Quatermain's Site - for more info and tutorials. Recursive Menu Controller & Icons on Menus - A post by Alan Quatermain in the forum Leopard Plug-In Method - Under Construction? Resources IRC: You can find us on IRC: #awkwardtv on irc.moofspeak.net. Register your Nick Please feel free to contribute! We are all learners at this stage ;-) Forum: AwkwardTV project forums Prerequisites Hardware Modification Prerequisites

Latest News PreBoard Added a page describing how PreBoard works and how to trigger it if necessary checkra1n released jailbreak for iOS and tvOS cover 12.x - 13.x TVControlCenter TVControlCenter released - Add your on control center widgets with ease on tvOS 13 AirDrop Central Details about Breezy (tvOS AirDrop implementation) and any related projects (AirPhoto, Ethereal, etc) Safely Upgrading Information on how to safely upgrade your AppleTV It's time to grow up tvOS App Store launch information Snappy Created a page for snappy, instructions to revert tvOS 11 to original pre jailbroken snapshot. CODMC Released, MFI support for Call of Duty Mobile MLC Released, MFI support for Mobile Legends FControl Released, MFI support for FIFA Pesc Released, MFI support for Pro Evolution Soccer 2019 Pubc Released, MFI support for pubg Installing_Deb_Files Added page for instructions on manually installing deb files on Windows and macOS chimeraTV *OS 12 jailbreak released NControl Soft launch for tvOS and released on iOS on chariz repo bootstrapTool Useful macOS tool for repackaging deb files and modifying bootstrap skeleton directories DalesDeadBug Updated for Backr00m jailbreak support. Install Amazon Prime on 10.2.2 AirMagic AirMagic a variety of clients for remote control over web protocols for AppleTV 4+ Depiction Setting up a custom depiction for your package to emulate the look of kodi or tuyu packages. FAQ Start here! General FAQ on latest tvOS jailbreaks Cycript Tutorial on how to use cycript on jailbreakd based Jailbreaks. Backr00m A page dedicated to the backr00m 10.2.2 -> 11.1 Jailbreak Xcode_Deb_Creation A tutorial for a post build script in Xcode to create + deploy a deb to your jailbroken AppleTV NitoTV_Take_4 nitoTV + greeng0blin for the AppleTV 4 on 9.0, 10.1 and 10.2.2 released AppSync AppSync tutorial 1.0 AirMagic AirMagic for AppleTV released AppleTV 4 is jailbroken by Pangu for tvOS 9.0.x 03/26/15 awkwardTV is reborn, join us on freenode #awkwardtv 06/04/13 PlexConnect Plex Player without jailbreak MediaCloud UPnP Player for Apple TV 1, 3.0.2. XBMC now runs on AppleTV2, iPhone 4, and iPad. Exposed VNC for AppleTV 2G by Brandon Holland Beginners_Guide_AppleTV2 Beginner's guide to jailbreaking the AppleTV2 added. NitoTV_Take_3 Added page for nitoTV Take 3 for AppleTV 2G AppleTV_2 Added page for information and updates on AppleTV 2 information and JB status NitoTV Take 2 0.9.1 too much to list! lots of new meta changes, tons of bug fixes full changelog here: http://nitosoft.com/ntv/about.txt NitoTV Take 2 0.9.0 Hate for 0.9.0 to be a bugfix release but what can ya do? Fixed a bug in the smart installer with the new smbfs.kext installer, fixed improper permissions for package as well. AtvDrive wiki added atvDrive 1.1 released wiki added later (still). major partition map bug fixed atvDrive 1.0 released wiki added later. forum.tomcool.org until the forum.awkwardtv.org is back up questions can be asked there (since it appears to be dead for good). CMP_Framework Added a page for the Common Media Player framework Couch Surfer 2.2 now available for AppleTV 3.0 - 3.0.2 NitoTV Take 2 0.8.7 quick bugfix follow up release. Bundled with latest Common Media Player, fixed the CMP installer and fixed gestures in 3.0.1. NitoTV Take 2 0.8.6 release supporting the Common Media Player framework, now with 5.1 AC3 passthrough support (in MPlayer too) Sapphire b7.8.1 released supporting the Common Media Player framework which support DVD Playback on the AppleTV (including 5.1 AC3 passthrough support). SoftwareMenu1.0b2.1 released. 1.0b1 has a bad update algorithm. select SoftwareMenu_Update1 (from third party menu), install it and even though it will say not installed, restart finder and it should be installed Overflow beta 4 has been released. couple of bugs and memory leaks fixed. Now also available from SoftwareMenu. Sorry for beta 3 users. was a huge bug stopping it from working ATVUSB-Creator Has been released. Updates include OpenSSH, Launcher and SoftwareMenu. This release is compatible with 2.x and 3.x AppleTVs. Overflow beta 2 has been released. Overflow is a plugin that itself loads plugins while hiding them from the Finder. Archived News

Projects

(Please put your projects here-- in categories)

OS Related

• Booting from a USB Thumbdrive Pre-made 256MB image for testing; small download
• Boot.efi Information An effort to understand the boot.efi file format
• Linux on Apple TV Our AppleTV-Linux Resource Guide (work in progress)
• Patchstick A project to build a Darwin kernel plus tools to have a 100% legitimate way of enabling hacks on the ATV (without opening case) (work in progress)

Awkward Project Wikis

• ATVFiles Plugin to play back video files that are not in the Apple TV library.
• ATVFiles Cover Downloader Script to download dvd/tv/hddvd cover images and XML metadata for ATVFiles
• Streamer Streaming Audio player, using MPlayer.
• ATV Loader Download and install new appliance plugins, enable and disable SSH and AFP access to your AppleTV.
• Applications Menu Run any Mac OSX program on AppleTV
• ATVTorrents A rtorrent controller for AppleTV
• NitoTV mplayer video playlist, video_ts, iso playback - For AppleTV version 1.0 & 1.1 Only
• NitoTV Take 2 Updated version of NitoTV for Take2 and 2.01 AppleTV - movie, photo, music playback, RSS feeds, Weather and more.
• Emulation Efforts to test and tweak compatibility regarding Game Emulation. (work in progress)
• Install Developer Tools (work in progress)
• Patch Over Network - Patching AppleTV over the network (without opening case) (work in progress)
• Enable Internet Sharing (work in progress)
• Volume control Control the volume (analogue) with the remote control + and - (during playback) (work in progress)
• HD DVD Playback Enable USB-based XBOX HD-DVD Player to allow regular or HighDefinition DVDs with DVD Player.app
• VLC Plugin A first implementation, lots of bugs..
• TorrentFlux-b4rt Make your ATV download your torrents & direct links itself.
• Transmission on AppleTV the best torrent client for any platform
• Broadcom HD Decoder hardware and software installation

Outside Awkward

• How to upgrade hard drive with GUI tools ($100) or CLI
• How to upgrade hard drive using command line. (more pictures)
• Macworld's in-depth (mostly CLI) hard drive upgrade tutorial with pics.
• InsanelyMac Apple TV resource compilation
• Apache on Apple TV
• Turbo's AppleTV hacks @ 0xfeedbeef. A wealth of information, especially USB related.
• How to set up the Apple TV skin for XBMC
• Running mt-daapd/Firefly (iTunes server) on ATV
• ATV-Bootloader (a new bootloader for booting standard Linux distributions w/ guides)
• Download and install Sapphire on Take 2 ATVs
• Proof of concept: showing Google Maps plotted data

Hardware

• Parts
• Hardware Profile
• Sysctl output
• Various diskutil command results
• Power Usage
• Airport Card in MacBook Pro or intel MacMini

Does anybody fancy upgrading their RAM using a SMD removal kit? http://www.rsrelectronics.com/sdr_smd1.htm

Software

• Apple TV OS 10.4.7
  • file list of a virgin Apple TV
  • List of new files compared to stock Mac OS
  • List of files in mach_kernel.prelink (by n8man)
• Boot Process
• Watchdog
• osputil command-line program to control the LED
• screencapture
• dmesg output
• Ps output
• glQuery output
• kextstat output
• kernel_settings.xml (by n8man)
• Media Library
• Open Source 10.4.8 Components you can install on Apple TV
• XML Downloaded By ATV

Third party software

• Axie. Xml metadata and cover art editor for Mac OS X.
• Codec Sources
• Remote Buddy
• MediaCentral
• nano Excellent, lightweight text editor for scripts and such.
• vim Another classic text editor.
• MacPorts suggestions to bootstrap the MacPorts infrastructure natively
• Xbench 1.3 Benchmark
• Joost
• Synergy Kebyboard and Mouse control over TCP/IP
• SeasonPassGetter Automatically transfer Season Passes from TiVo to iTunes for use with AppleTV
• Dropbox Cloud Based storage

Potential Capabilities

• Potential Capabilities

Known Issues

• Connecting drive to PowerPC Mac makes drive unbootable (successes reported inside as well)
• Apple TV HDMI "Green Screen" bug
• Lists issues I haven't found much discussion on - FYI

Tried & Working Video

• 720p Xvid
• 720p Divx (Perian)
• 1080p using an additional Broadcom_HD_Decoder hardware
• MKV with VLC (Coming in perian 1.0 for Quicktime)
• .vob(DVDrip) with VLC (Menu, subtitles, 5.1 surround working). No skip on network play (802.11g) if you setup a buffer in vlc options.
• MPEG2 using QT MPEG-2 Component. 720p and 1080i playback was very choppy.
• WMV using Flip4Mac WMV Import component.
• .vob on a DVD pl
• Latest Perian works with .srt subtitles.
• List of file formats working on Apple TV
• How to get iTunes to sync other video formats to Apple TV

Wiki documentation

• Consult the User's Guide for information on using the wiki software.
• Configuration settings list
• MediaWiki FAQ
• MediaWiki release mailing list

The AwkwardTV Wiki currently contains 277 articles.

<Google>WIKI</Google>