From AwkwardTV
Revision as of 22:03, 22 September 2007 by GhhO7m (talk | contribs)
Jump to: navigation, search

mueve la cola primo amore garrone contratti di manutenzione immigrati italiani in argentina vale rossi accesso internet gratis biosan elettrostimolatore driver mustek solo per il tuo amore profumi ungaro donna home cinema lg archos pocket video julierpass fruttosio ju mcfly tps france new cods los brincos midi heli atack videoregistratore vhs e lettore dvd jvc download emulatore playstation 2 too much of heaven testo di nothing but a gangster party ese silencio samsung vhs dvd download yeti sport iveco veicoli industriali usati con rabbia e con amore zizze dure sintesi del diritto alla armi edoardo mo telecomando pc hapland1 musica dei 883 everybody s talkin mietta ufficio noleggio nissan micra 3 serie al jazira news www offertissime com redlight tv dune buggy oliver onions guns of navarone operatori telefonia mobile daniel pearl beheading video batterie nokia bl6c scanner fujitsu siemens fi 4530c prestito civitanova marche bandiere com maroon 5 songs about jane concessionari mg lombardia leo dan deci porque no queres chiara da perugia dowload toto groupo americana obiettivo nikon 3570 gichi moda philips 109e50 19 volo erba v220 italia evanescen vidio clip shpat kasapi axhami fiat punto 1 9 jtd sporting situazioni all italia gioco scaricabile gameboy advance girga ordine dei farmacisti sassari morwa idz za ciosem ron moss universal prayer jamelia e tiziano ferro ragazza civitavecchia rifarsi una vita chat piccanti bonnie tylor fabbrica argenteria norton antivirus 3 sampei vol 15 carta da parati catania eurovision2004 sesso con francesca ancylis lemberg canon extender ochoa eugenio de tidici hotel don abbondio lista nera compagnie aerea stravinsky dvd ripetitore di segnale svideo accessori festivalbar compilation rossa balliamo insieme il twist nissan micra 15d golding william gerald sciopero fiat kaory srl dalma the sims gameboy www foxkid it amd logo ana eli diageo italia charlie s2emu1 09 el castillo de lord com la sicilia vista dal paradiso tropicana grand oasis resort luca teseo aiwa dvd vhs www computer discaunt il marito in collegio alimentatore fuji affitti economici hp laserjet 3380 allinone selen gratis yaaho palmare hp hw6515 pulizia dv siemens x102 p4 haiducci dragostea din tei remix bmw x3 2000 diesel dirottamenti video batteria philips savvy hotel 4 stelle madrid ibanez af105 www ciudad com ar cozze di taranto a roma vaio vgn fs215z www poeti rumeni it un uomo da vendere sony digitale dsct7 matura and boy foto fiori case in vendita a folgaria trento usb ports lupi caccia tacito annales georg kreisler bjc 6000 lacie 80gb usb definizione di sistema candlemass documents of doom memories fade www disney latono com kiss dvd 508 wrestlinh brasileira il ladro dei bambini ragazzo lissone frontline gatto www incinte com g7050 cellulari lg gamesurround fortissimo turtle blues digitale 5 megapixel minera ef 28200 indirizzi accompagnatrici beauty ninna nanna l berte myoplex low carb www y philips 190s5fs diamanti quotazioni titoli buoni o cattivi www intra it cheryl ladd maxtor plus 9 300 gb televisore 4 3 sony kv 32 sandy pelada corason garmin ique 3600 kit lisa e michele riforma tfr paul johnsons epson 1290 photo cartucce amd athlon 64 3800 hztc 9 moreno morena l arte neoclassica hot hits cd musicali x2250 lexmark asus extreme n6600 td eurorack ub1202 i predatori della pietra magica canon 70 300 mappa geografica dmc fz10 calendari amatoriali sexxy free gratis moto autodromo del mugello telefonini siemens c60 paulita karmacoma photocd www citroen italia lento de julieta venegas le serve preghiere in latino olivo cyber dsc t33 www seefeld com dedica it napoli palermo ATVFiles is an AppleTV (ATV) plugin that allows the user to browse the entire ATV filesystem via the Finder and Apple Remote. This allows you to navigate to files that would not normally sync to the ATV, files stored on a network drive or another Mac for instance. Combined with the proper codecs, ATVFiles will allow you to play any of your media.

Version 0.4.0 (22)
July 23, 2007

Screenshot gallery:
Download: (3.1MB)
Discussion forum:

Copyright (c) 2007 Eric Steil III (


Simple file browser plugin for Apple TV Finder. Think XBMC, it can play video files without transcoding and syncing/streaming them.

Please note that ATVFiles does not provide the codecs. Perian ( and A52Codec ( are highly recommended to be installed to provide support for a wide variety of codecs.


See for more details.


Engadget has posted a pretty good tutorial on setting ATVFiles up from scratch on an unmodified Apple TV:

1. Copy ATVFiles.frappliance to this folder: /System/Library/CoreServices/ on the Apple TV. You may want to create a symlink from there to some more convenient place.

2. Restart Finder. The command ps awx|grep [F]inder will list the PID as the first number, then running kill PID will kill it. The Finder will be automatically restarted.

If you have the Apple TV drive mounted on your local system, the correct path is on the OSBoot volume.

If you have the drive installed in the Apple TV, you will likely have to mount the root partition as read-write (using sudo /sbin/mount -uw /) to copy it. The command sudo /sbin/mount -ur / will reverse the above action.


Enter the new "Files" menu on the main menu.

It lists files in /Users/frontrow/Movies, so mount or put your video files in that folder. If there is nothing in the "Movies" folder the Files menu will not show up in the main menu.


Cover Art

ATVFiles looks for cover art in either JPG, TIFF, or PNG formats. It looks for specific filenames of the following formats (the jpg extension is an example, and can be either jpg, tif, tiff, or png):

For folders: Either folder.jpg or cover.jpg in the folder.

For other files: The same as the filename without the extension, and the image extension (jpg, tif, tiff, png). For instance, anchorman-xvid.avi would look for anchorman-xvid.jpg for cover art.


The preferences can be set using the defaults command, such as:

 defaults write net.ericiii.ATVFiles RootDirectory /mnt/Server

To change a boolean preference, use:

 defaults write net.ericiii.ATVFiles EnableAC3Passthrough -bool YES

Finder needs to be restarted to pick up any changes.

The preferences available are:

RootDirectory: The path it looks at when first entering the plugin.

Defaults to /Users/frontrow/Movies (or whatever user the ATV interface is running as, i.e. frontrow on Apple TV)

EnableAC3Passthrough: Boolean, enable AC3 passthrough support in A52Codec (see 0.3.0 release notes for details)

Default: NO

EnableFileDurations: Boolean, disable scanning files for their duration, as it can be slow.

Default: YES

ShowFileExtensions: Boolean, show filename extensions

Default: YES

ShowFileSize: Boolean, show file size

Default: YES

ShowUnplayedDot: Boolean, show the blue unplayed dot

Default: YES

VideoExtensions: Array of file extensions (without leading ".") that are video files.

Default: (m4v, 3gp, m3u, pls, divx, xvid, avi, mov, wmv, asx, asf, ogm, mpg, mpeg, mp4, mkv, avc, flv, dv, fli, m2v, ts)

AudioExtensions: Array of file extensions (without leading ".") that are audio files.

Default: (m4b, m4a, mp3, wma, wav, aif, aiff, flac, alac, m3u, mp2)

ResumeOffset: Integer, number of seconds to add to the bookmark time when resuming. Negative will go back in time.

Default: 0

Note: Files with extensions not listed in either VideoExtensions or AudioExtensions are not displayed. Just because an extension is listed does not mean it will play without appropriate components installed, the list is mostly copied from XBMC.

When updating the VideoExtensions and AudioExtensions pref, you must include all default items (if you want them), the defaults will not be used if you override them. You also must use the array options (-array and -array-add) to defaults to update them. The extensions should also be listed in lowercase.

The list of extensions is also used to determine which player (video or audio) is used for playback.

XML Metadata Format

The xml file is looked for along side the video file (and cover art), with the same name and an "xml" extension. That is, "anchorman-divx.avi" will look for "anchorman-divx.xml".

Not all of the fields are shown in the UI, this just represents the data stored and available internally.

Example file, see the wiki for more complete examples:

 <media type="TV Show">
   <summary>Summary of Media</summary>
   <description>Description of Media</description>
   <seriesName>Veronica Mars</seriesName>
   <broadcaster>The CW</broadcaster>
     <genre primary="true">Mystery</genre>
     <name>Kristen Bell</name>
     <name>Rob Thomas</name>
     <name>Rob Thomas</name>

Random Notes about the data:

  • All these are optional
  • duration is only to override if the QuickTime scanning gets it wrong, otherwise it should not be used.
  • rating will display graphics for the usual ones (R, TV-PG, etc.)
  • the type attribute has some control over the values shown in the metadata, possible values are "Song", "Music Video", "Podcast", "Movie", "TV Show", "Audio Book". The default type is Movie
  • published is the original air date for TV Shows
  • not all values are actually used for display, regardless of the "type", but all are stored

For some examples, see ATVFiles XML Metadata

Release Notes

0.4.0 (22) July 23, 2007

  • Add new icon from Telusman.
  • Proper music playback with fancy UI.
  • Fixed holding files open, preventing deletion.
  • Actually set the A52Codec passthrough preference on startup, for real (AC3 passthrough should work now without setting the com.cod3r.a52codec preference).
  • Gracefully handle XML files in a format other than expected.
  • No longer stores a bookmark time when a file has been completely played.
  • Use mplayer for duration checking, should be somewhat faster overall now, at the expense of a much larger download size.
  • Disable sound effects when playing back video with AC3 passthrough enabled
  • Reverted directory scanning code, should cope better with non-ASCII filenames.
  • Stop music playback when starting video/exiting ATVFiles.

0.3.2 (14) June 20, 2007

  • Update for compatibility with the Apple TV 1.1 update.

0.3.1 (13) May 20, 2007

  • Add resume feature to 0.3.0 release notes.
  • Fix problem with disabling file duration scanning ignoring duration specified in XML file.
  • Add ResumeOffset preference to allow offsetting the resume time.
  • Fix crash with changing media type in XML.

0.3.0 (12) May 19, 2007

  • Remember last playback position and offer to resume resume.
  • Show blue dots next to unplayed files
  • Read metadata from an XML file alongside the media file (like coverart)
    • See above for the format
  • Add EXPERIMENTAL AC3 Passthrough support with the EnableAC3Passthrough preference when using optical audio out.
    • This requires Perian 1.0.
    • Will not work properly for non-48k sample rate AC3 tracks, as it sets the sample rate to 48000 on startup and leaves it there. These, however, are rare.
  • Fix stripping extensions from folder names
  • Use home directory of current user instead of hardcoding /Users/frontrow/Movies
  • Hide the files "Icon\r" (folder icons), "Desktop DB" and "Desktop DF" from listings
  • Revert to showing on all sources, not just local
    • Can be changed by adjusting the value of FRRemoteAppliance in Info.plist
  • Include fix from alan_quatermain to allow the main menu to scroll if there are a bunch of items

0.2.2 (8) April 11, 2007

  • Added French and Spanish localizations
  • Fix problem with absolute symlinks
  • Use natural sorting for files with numbers
  • Add preferences to hide filename extensions and file sizes

0.2.1 (6) April 8, 2007

  • Added Japanese localizations
  • Fixed case-sensitivity when matching valid filename extensions
  • Fixed a minor problem with certain symlinks
  • Changed EnableFileDurations default to NO until metadata is cached
  • Fixed not finding cover art when folder name contains [, ], ? or *.

0.2.0 (5) April 8, 2007

  • Don't show the menu item when viewing remote sources
    • This can be changed by setting the value of FRRemoteAppliance in Info.plist to