Main Page

From AwkwardTV
Revision as of 20:36, 17 July 2018 by Nito (talk | contribs) (Beginners Guides)
Jump to: navigation, search

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

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, button_sig.png, 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:

  • FAQ | An FAQ for the latest AppleTV 4+ jailbreaks. A good place to start!
  • 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



Advanced BackRow Coding - An Ongoing Series

  1. Introduction To Custom Controls
  2. A Custom Layer Controller
  3. A Downloader Controller


IRC: You can find us on IRC: #awkwardtv on Register your Nick Please feel free to contribute! We are all learners at this stage ;-)

Forum: AwkwardTV project forums


Latest News

  • NControl launch for tvOS and released on iOS on packix repo & and recently updated.
  • 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
  • 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:
  • 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.
  • until the 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


(Please put your projects here-- in categories)

OS Related

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
  • 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


Does anybody fancy upgrading their RAM using a SMD removal kit?


Third party software

Potential Capabilities

Known Issues

Tried & Working Video

Wiki documentation

The AwkwardTV Wiki currently contains 277 articles.