Difference between revisions of "ATVFiles"

From AwkwardTV
Jump to: navigation, search
m
m (Reverted edits by Ipodsoft (Talk) to last revision by Bubba)
 
(45 intermediate revisions by 14 users not shown)
Line 1: Line 1:
[http://doctorpinkerton.ifrance.com/lib/webcam-porno/ webcam porno italiane] [http://furrysoap.ifrance.com/virtuagirl/ virtuagirl] [http://spirit-psyki.ifrance.com/lib/lesbo-gratis.html lesbo gratis] [http://end14april.ifrance.com/blog/sesso-it.html sesso it] [http://bakadeshi.ifrance.com/img/styles/immagini-incesto.html immagini incesto] [http://jnk713.ifrance.com/img/styles/sexs-woman/ sexs woman] [http://elixirium.ifrance.com/lib/collant-porno.html collant porno] [http://tulip123456.ifrance.com/topic/donne-rumene.html donne rumene nude] [http://furrysoap.ifrance.com/chattare-gratis/ chattare gratis] [http://elixirium.ifrance.com/lib/sexy-beast.html sexy beast - lultimo colpo della bestia] [http://doctorpinkerton.ifrance.com/lib/sesso-hard/ sesso hard racconti erotici gratis] [http://cincydj.ifrance.com/images/small/areasex/ areasex] [http://cincydj.ifrance.com/images/small/italian-gay/ italian gay] [http://tulip123456.ifrance.com/topic/basi-audio.html basi audio gigi d alessio gratis] [http://furrysoap.ifrance.com/sesso-tanga/ sesso tanga] [http://elixirium.ifrance.com/lib/chat-gratis.html chat gratis di virgilio] [http://competitio.ifrance.com/er-cipolla/ er cipolla suoneria gratis] [http://competitio.ifrance.com/pamela-anderson/ pamela anderson lee cocks video] [http://cincydj.ifrance.com/images/small/adult-black/ adult black jack] [http://tulip123456.ifrance.com/topic/sesso-esplicito.html sesso esplicito] [http://bakadeshi.ifrance.com/img/styles/fotosexy.html fotosexy] [http://elixirium.ifrance.com/lib/sexy-viaggi.html sexy viaggi] [http://adrienneee.ifrance.com/blog/sesso-erotismo/ sesso erotismo] [http://furrysoap.ifrance.com/donne-con/ donne con il cazzo] [http://elixirium.ifrance.com/lib/storie-di.html storie di sesso] [http://furrysoap.ifrance.com/scandali-sex/ scandali sex vip] [http://competitio.ifrance.com/sexy-olimpiadi/ sexy olimpiadi] [http://elixirium.ifrance.com/lib/girls-sexy.html girls sexy] [http://elixirium.ifrance.com/lib/elporno.html elporno] [http://cincydj.ifrance.com/images/small/sex-and/ sex and animal] [http://cincydj.ifrance.com/images/small/donne/ donne 45] [http://spirit-psyki.ifrance.com/lib/giochi-scaricare.html giochi scaricare pc gratis] [http://cincydj.ifrance.com/images/small/ragazze-catanzaro/ ragazze catanzaro] [http://furrysoap.ifrance.com/berlusconi-nudo/ berlusconi nudo] [http://tulip123456.ifrance.com/topic/marisa-mell.html marisa mell porno] [http://competitio.ifrance.com/ragazze-sassuolo/ ragazze sassuolo] [http://jnk713.ifrance.com/img/styles/cerco-donne/ cerco donne alte] [http://cincydj.ifrance.com/images/small/download-film/ download film porno casalinghi] [http://competitio.ifrance.com/orgasmo-donna/ orgasmo donna] [http://adrienneee.ifrance.com/blog/cazzo-gay/ cazzo gay] [http://mi-kkiechang.ifrance.com/tiscali-internet.html tiscali internet gratis] [http://tulip123456.ifrance.com/topic/vasco-rossi.html vasco rossi gratis] [http://elixirium.ifrance.com/lib/galleria-di.html galleria di foto veramente gratis donne] [http://end14april.ifrance.com/blog/juegos-pornos.html juegos pornos] [http://adrienneee.ifrance.com/blog/foto-porno/ foto porno amatoriali] [http://adrienneee.ifrance.com/blog/ragazze-ombrellino/ ragazze ombrellino] [http://elixirium.ifrance.com/lib/versos-cortos.html versos cortos gratis] [http://jnk713.ifrance.com/img/styles/cam-xxx/ cam xxx gratis] [http://tulip123456.ifrance.com/topic/videi-gratis.html videi gratis porno] [http://spirit-psyki.ifrance.com/lib/tette-molli.html tette molli] [http://competitio.ifrance.com/donne-nere/ donne nere penetrazioni anali] [http://bakadeshi.ifrance.com/img/styles/pamela-anderson.html pamela anderson sexy tape] [http://competitio.ifrance.com/hard-donne/ hard donne anziane] [http://cincydj.ifrance.com/images/small/jovencitos-gay/ jovencitos gay] [http://doctorpinkerton.ifrance.com/lib/dragon-ball/ dragon ball xxx italiano] [http://jnk713.ifrance.com/img/styles/best-xxx/ best xxx women and man vree] [http://competitio.ifrance.com/video-hard/ video hard gratis] [http://end14april.ifrance.com/blog/tatu-playboy.html tatu playboy] [http://furrysoap.ifrance.com/ti-vorrei/ ti vorrei rivivere eros ramazotti] [http://elixirium.ifrance.com/lib/tutto-lesbo.html tutto lesbo gratis] [http://competitio.ifrance.com/sexsex-com/ sexsex com] [http://spirit-psyki.ifrance.com/lib/maxim-canalis.html maxim canalis 2004] [http://competitio.ifrance.com/donne-mature/ donne mature over 40] [http://doctorpinkerton.ifrance.com/lib/io-voglio/ io voglio vivere gratis] [http://spirit-psyki.ifrance.com/lib/www-volaregratis.html www volaregratis it] [http://tulip123456.ifrance.com/topic/www-anal.html www anal] [http://mi-kkiechang.ifrance.com/tette-annalisa.html tette annalisa] [http://cincydj.ifrance.com/images/small/sesso-bizare/ sesso bizare] [http://adrienneee.ifrance.com/blog/beyonce-nuda/ beyonce nuda] [http://tulip123456.ifrance.com/topic/gay-sesso.html gay sesso gratis] [http://end14april.ifrance.com/blog/elimina-virus.html elimina virus gratis] [http://mi-kkiechang.ifrance.com/animali-sesso.html animali sesso] [http://jnk713.ifrance.com/img/styles/revista-sexy/ revista sexy] [http://adrienneee.ifrance.com/blog/maschia-sex/ maschia sex] [http://competitio.ifrance.com/marcuzzi-tette/ marcuzzi tette] [http://elixirium.ifrance.com/lib/foto-annunci.html foto annunci incesti] [http://adrienneee.ifrance.com/blog/donne-con/ donne con tori] [http://doctorpinkerton.ifrance.com/lib/sexy-olders/ sexy olders womans] [http://cincydj.ifrance.com/images/small/traduzione-fuck/ traduzione fuck right back] [http://adrienneee.ifrance.com/blog/giochi-donne/ giochi donne nude] [http://spirit-psyki.ifrance.com/lib/foto-uomini.html foto uomini vecchi nudi] [http://spirit-psyki.ifrance.com/lib/spogliare-donne.html spogliare donne] [http://doctorpinkerton.ifrance.com/lib/xxxporno-gratis/ xxxporno gratis] [http://cincydj.ifrance.com/images/small/ciccioni-nudi/ ciccioni nudi] [http://bakadeshi.ifrance.com/img/styles/donne-spiate.html donne spiate al bagno] [http://elixirium.ifrance.com/lib/canali-televisivi.html canali televisivi arabi] [http://spirit-psyki.ifrance.com/lib/www-sesso.html www sesso gradis it] [http://adrienneee.ifrance.com/blog/aerosol-sidestream/ aerosol sidestream] [http://bakadeshi.ifrance.com/img/styles/traduzione-online.html traduzione online gratis] [http://bakadeshi.ifrance.com/img/styles/www-donne.html www donne libere] [http://bakadeshi.ifrance.com/img/styles/scarica-giochi.html scarica giochi pc gratis] [http://competitio.ifrance.com/ragazze-di/ ragazze di rieti] [http://tulip123456.ifrance.com/topic/sexo-con.html sexo con maduras] [http://tulip123456.ifrance.com/topic/girl-sexy.html girl sexy vree sex] [http://furrysoap.ifrance.com/fotosxxxgratis/ fotosxxxgratis] [http://bakadeshi.ifrance.com/img/styles/dating-girl.html dating girl] [http://tulip123456.ifrance.com/topic/peliculas-para.html peliculas para adultos] [http://tulip123456.ifrance.com/topic/foto-suore.html foto suore porche gratis] [http://competitio.ifrance.com/fuck-usa/ fuck usa] [http://competitio.ifrance.com/film-trans/ film trans porno] [http://mi-kkiechang.ifrance.com/ragazze-ot.html ragazze ot] [http://spirit-psyki.ifrance.com/lib/vieri-canalis.html vieri canalis] [http://bakadeshi.ifrance.com/img/styles/click-fast.html click fast sexy] [http://competitio.ifrance.com/le-ragazze/ le ragazze di piazza di spagna] [http://spirit-psyki.ifrance.com/lib/uomini-neri.html uomini neri nudi foto] [http://elixirium.ifrance.com/lib/www-dragon.html www dragon ball z xxx com] [http://spirit-psyki.ifrance.com/lib/disney-xxx.html disney xxx] [http://furrysoap.ifrance.com/canalis-e/ canalis e fontana video] [http://elixirium.ifrance.com/lib/ragazze-da.html ragazze da vicenza in chatt] [http://competitio.ifrance.com/foto-di/ foto di donne bionde] [http://adrienneee.ifrance.com/blog/anale-donna/ anale donna] [http://adrienneee.ifrance.com/blog/xxx-porno/ xxx porno] [http://jnk713.ifrance.com/img/styles/poto-gay/ poto gay] [http://furrysoap.ifrance.com/download-mp/ download mp3 gratis] [http://tulip123456.ifrance.com/topic/forum-di.html forum di sesso] [http://cincydj.ifrance.com/images/small/asian-transex/ asian transex] [http://jnk713.ifrance.com/img/styles/sabrina-ferilli/ sabrina ferilli porno] [http://bakadeshi.ifrance.com/img/styles/informacion-del.html informacion del sexo oral] [http://cincydj.ifrance.com/images/small/xxx-paris/ xxx paris hilton] [http://spirit-psyki.ifrance.com/lib/eros-end.html eros end glamor] [http://adrienneee.ifrance.com/blog/sex-adult/ sex adult sites] [http://spirit-psyki.ifrance.com/lib/video-gratis.html video gratis oggi] [http://mi-kkiechang.ifrance.com/ritchey-george.html ritchey, george willis] [http://adrienneee.ifrance.com/blog/sexy-sherry/ sexy sherry] [http://jnk713.ifrance.com/img/styles/videro-porno/ videro porno gratis] [http://furrysoap.ifrance.com/sexxy/ sexxy] [http://cincydj.ifrance.com/images/small/video-porno/ video porno lunghi] [http://tulip123456.ifrance.com/topic/indiasex-com.html indiasex com] [http://competitio.ifrance.com/gallerie-porno/ gallerie porno gratuite] [http://cincydj.ifrance.com/images/small/photo-gratis/ photo gratis dei d 12] [http://cincydj.ifrance.com/images/small/gays-foto/ gays foto] [http://mi-kkiechang.ifrance.com/testo-e.html testo e traduzione di eamon girl version] [http://furrysoap.ifrance.com/giochi-/ giochi  porno online] [http://competitio.ifrance.com/miky-bet/ miky bet nuda] [http://jnk713.ifrance.com/img/styles/www-cdgirl/ www cdgirl com] [http://competitio.ifrance.com/webcamsex/ webcamsex] [http://tulip123456.ifrance.com/topic/blu-paola.html blu paola chiara] [http://mi-kkiechang.ifrance.com/le-donne.html le donne di baggio] [http://adrienneee.ifrance.com/blog/prodigy-girls/ prodigy girls] [http://spirit-psyki.ifrance.com/lib/sondagi-sul.html sondagi sul ruolo delle donne in tv] [http://competitio.ifrance.com/vendita-dvd/ vendita dvd adulto] [http://furrysoap.ifrance.com/materasso-anallergico/ materasso anallergico] [http://tulip123456.ifrance.com/topic/cannavaro-nudo.html cannavaro nudo] [http://cincydj.ifrance.com/images/small/veronica-gf/ veronica gf] [http://end14april.ifrance.com/blog/sesso-incontri.html sesso incontri] [http://elixirium.ifrance.com/lib/storie-incesti.html storie incesti] [http://elixirium.ifrance.com/lib/becham-nudo.html becham nudo] [http://doctorpinkerton.ifrance.com/lib/chat-di/ chat di sesso bollente] [http://bakadeshi.ifrance.com/img/styles/intervento-cambio.html intervento cambio sesso] [http://furrysoap.ifrance.com/eros-e/ eros e] [http://bakadeshi.ifrance.com/img/styles/emma-watson.html emma watson foto sexy] [http://mi-kkiechang.ifrance.com/wilkins-sir.html wilkins, sir george hubert] [http://cincydj.ifrance.com/images/small/donne-collant/ donne collant] [http://elixirium.ifrance.com/lib/sexy-single.html sexy single anstacia] [http://end14april.ifrance.com/blog/uomo-nudi.html uomo nudi gay] [http://tulip123456.ifrance.com/topic/cavalli-che.html cavalli che fanno sesso con delle donne] [http://furrysoap.ifrance.com/gunther-the/ gunther the sunshine girls teeny weeny s] [http://elixirium.ifrance.com/lib/testi-eros.html testi eros ramazzotti] [http://tulip123456.ifrance.com/topic/desktopgirls.html desktopgirls] [http://competitio.ifrance.com/annuncio-matrimoniali/ annuncio matrimoniali ragazze dell est] [http://tulip123456.ifrance.com/topic/vaginas-infantiles.html vaginas infantiles] [http://furrysoap.ifrance.com/immagini-gianluigi/ immagini gianluigi buffon nudo] [http://adrienneee.ifrance.com/blog/pornogratis/ pornogratis] [http://tulip123456.ifrance.com/topic/cartoni-sex.html cartoni sex] [http://mi-kkiechang.ifrance.com/porno-la.html porno la vicina di casa] [http://competitio.ifrance.com/noticieros-televisa/ noticieros televisa] [http://furrysoap.ifrance.com/sex-world/ sex world] [http://cincydj.ifrance.com/images/small/donne-gravide/ donne gravide] [http://bakadeshi.ifrance.com/img/styles/www-polizzi.html www polizzi generosa it] [http://spirit-psyki.ifrance.com/lib/sexi-samanta.html sexi samanta rossini] [http://doctorpinkerton.ifrance.com/lib/sexual-marvin/ sexual marvin gaye] [http://cincydj.ifrance.com/images/small/hot-sexe/ hot sexe] [http://doctorpinkerton.ifrance.com/lib/gay-bisceglie/ gay bisceglie] [http://mi-kkiechang.ifrance.com/giochi-.html giochi  porno per donne] [http://spirit-psyki.ifrance.com/lib/pornostar-nude.html pornostar nude] [http://elixirium.ifrance.com/lib/foto-porno.html foto porno latin] [http://cincydj.ifrance.com/images/small/wwwmorenasexit/ www.morenasex.it] [http://doctorpinkerton.ifrance.com/lib/falli-anali/ falli anali] [http://furrysoap.ifrance.com/groove-covergirl/ groove covergirl] [http://tulip123456.ifrance.com/topic/puttane-con.html puttane con tette grosse] [http://adrienneee.ifrance.com/blog/gay-porno/ gay porno tv] [http://end14april.ifrance.com/blog/racconti-erotici.html racconti erotici sul sesso anale] [http://competitio.ifrance.com/bacio-tra/ bacio tra paola e chiara] [http://competitio.ifrance.com/george-mazonakis/ george mazonakis] [http://furrysoap.ifrance.com/le-tette/ le tette] [http://end14april.ifrance.com/blog/fuckit-eamon.html fuckit eamon] [http://jnk713.ifrance.com/img/styles/www-sexyluna/ www sexyluna it] [http://cincydj.ifrance.com/images/small/george-moustaki/ george moustaki] [http://doctorpinkerton.ifrance.com/lib/cover-cd/ cover cd eros ramazzotti] [http://end14april.ifrance.com/blog/sicilia-sesso.html sicilia sesso] [http://end14april.ifrance.com/blog/accesso-internet.html accesso internet gratis] [http://jnk713.ifrance.com/img/styles/mitchelle-vieth/ mitchelle vieth desnuda] [http://tulip123456.ifrance.com/topic/ines-nobili.html ines nobili nuda] [http://furrysoap.ifrance.com/general-midi/ general midi karaoke gratis] [http://jnk713.ifrance.com/img/styles/sesso-in/ sesso in famigia] [http://jnk713.ifrance.com/img/styles/sesso-graties/ sesso graties] [http://adrienneee.ifrance.com/blog/ragazze-macerata/ ragazze macerata] [http://mi-kkiechang.ifrance.com/film-gratis.html film gratis ken park] [http://end14april.ifrance.com/blog/www-gay.html www gay it] [http://competitio.ifrance.com/donne-mature/ donne mature 50 60anni] ATVFiles README<br>
+
'''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)<br>
+
 
July 23, 2007
+
ATVFiles README<br>
 +
Version 1.2.1.1 (491)<br />
 +
November 1, 2009
  
 
Screenshot gallery: http://www.tuaw.com/photos/atv-files-beta/<br>
 
Screenshot gallery: http://www.tuaw.com/photos/atv-files-beta/<br>
Download: http://ericiii.net/sa/appletv/ATVFiles-0.4.0.tar.gz (3.1MB)<br>
+
Download (ATV): http://ericiii.net/sa/appletv/ATVFiles-1.2.1.1.run (549KB)<br>
Discussion forum: http://forum.awkwardtv.org/viewforum.php?f=18
+
Download (ATV Beta w/ 3.x support): http://ericiii.net/sa/appletv/ATVFiles-1.3.0b1.run<br>
 +
Download (Leopard): http://ericiii.net/sa/appletv/ATVFiles-1.2.1.1.pkg (450KB)<br>
 +
(manual: http://ericiii.net/sa/appletv/ATVFiles-1.2.1.1.tar.gz (450KB)<br>
 +
Discussion forum: http://forum.awkwardtv.org/viewforum.php?f=18<br>
 +
Development site: http://atvfiles.googlecode.com
  
Copyright (c) 2007 Eric Steil III (ericiii.net)
+
Copyright (c) 2007-2009 Eric Steil III (ericiii.net)
  
 
== Description ==
 
== Description ==
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 (http://perian.org) and A52Codec (http://trac.cod3r.com/a52codec/) are highly recommended to be installed to provide support for a wide variety of codecs.
+
<p>ATVFiles is an Apple TV 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.</p>
 +
 
 +
<p>Please note that ATVFiles does not provide the codecs.  [http://perian.org Perian] is highly recommended as it provides
 +
all the common codecs.</p>
  
 
[http://img252.imageshack.us/img252/4922/loepg0.jpg Screenshot]
 
[http://img252.imageshack.us/img252/4922/loepg0.jpg Screenshot]
  
See http://wiki.awkwardtv.org/ for more details.
+
<h2 id="installation">Installation</h2>
 +
 
 +
<h3 id="appletv">Apple TV</h3>
  
== Installation ==
+
<p><em>NOTE:</em> As of version 1.2.0, ATVFiles requires at least the Apple TV 2.1 update to run.</p>
Engadget has posted a pretty good tutorial on setting ATVFiles up from scratch on an unmodified Apple TV: http://www.engadget.com/2007/04/10/how-to-play-divx-and-xvid-on-your-apple-tv/
 
  
1. Copy <tt>ATVFiles.frappliance</tt> to this folder: <code>/System/Library/CoreServices/Finder.app/Contents/PlugIns</code> on the Apple TV.  You may want to create a symlink from there to some more convenient place.
+
<p>ATVFiles can be installed via Software Menu, or manually via the <code>ATVFiles-1.2.0.run</code> file.</p>
  
2. Restart Finder.
+
<p>To install manually,</p>
The command <code>ps awx|grep [F]inder</code> will list the PID as the first number, then running <code>kill PID</code> 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.
+
<ol>
 +
<li>Copy the file <code>ATVFiles-1.2.0.run</code> to the Apple TV.</li>
 +
<li>SSH into the Apple TV, and run the following command: <code>sudo sh ATVFiles-1.2.0.run</code></li>
 +
</ol>
  
If you have the drive installed in the Apple TV, you will likely have to mount the root partition as read-write (using <tt>sudo /sbin/mount -uw /</tt>) to copy it. The command <tt>sudo /sbin/mount -ur /</tt> will reverse the above action.
+
<p>It does not matter what the file is named, if Safari renames it to something like <code>ATVFiles-1.2.0.run.sh</code> it will still work fine.</p>
 +
 
 +
<h3 id="leopard">Leopard</h3>
 +
 
 +
<p><em>NOTE:</em> Leopard is not officially supported for 1.2.0, but it should work.</p>
 +
 
 +
<p>Double click on <code>ATVFiles-1.2.0.pkg</code>, and follow the prompts.</p>
 +
 
 +
<h3 id="manualmethod">Manual method</h3>
 +
 
 +
<p>Engadget posted a pretty good [http://www.engadget.com/2007/04/10/how-to-play-divx-and-xvid-on-your-apple-tv/ tutorial] on installing this.</p>
 +
 
 +
<ol>
 +
<li>Copy ATVFiles.frappliance to this folder:
 +
<code>/System/Library/CoreServices/Finder.app/Contents/PlugIns</code>
 +
on the Apple TV.  You may want to create a symlink from there to some more
 +
convenient place.</li>
 +
<li>Restart Finder.
 +
The command <code>ps awx|grep [F]inder</code> will list the PID as the first number,
 +
then running <code>kill PID</code> will kill it.</li>
 +
</ol>
 +
 
 +
<p>If you have the Apple TV drive mounted on your local system, the correct path
 +
is on the OSBoot volume.</p>
 +
 
 +
<p>If you have the drive installed in the Apple TV, you will likely have to mount
 +
the root partition as read-write (using <code>sudo /sbin/mount -uw /</code>) to copy it.
 +
The command <code>sudo /sbin/mount -ur /</code> will reverse the above action.</p>
  
 
== Usage ==
 
== Usage ==
Line 62: Line 103:
 
The preferences available are:
 
The preferences available are:
  
RootDirectory: The path it looks at when first entering the plugin.
+
<p>RootDirectory: The path it looks at when first entering the plugin.</p>
: 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)
+
<blockquote>
: Default: NO
+
  <p>Default: <code>/Users/frontrow/Movies</code></p>
EnableFileDurations: Boolean, disable scanning files for their duration, as it can be slow.
+
 
: Default: YES
+
  <p>The default is actually whatever user the ATV interface is running. On an Apple TV, this user is <code>frontrow</code>.</p>
ShowFileExtensions: Boolean, show filename extensions
+
</blockquote>
: Default: YES
+
 
ShowFileSize: Boolean, show file size
+
<p>EnableAC3Passthrough: Boolean, enable AC3 passthrough support in A52Codec (see 0.3.0 release notes for details)</p>
: Default: YES
+
 
ShowUnplayedDot: Boolean, show the blue unplayed dot
+
<blockquote>
: Default: YES
+
  <p>Default: NO</p>
VideoExtensions: Array of file extensions (without leading ".") that are video files.
+
</blockquote>
: 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.
+
<p>EnableFileDurations: Boolean, disable scanning files for their duration, as it can be slow.</p>
: 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.
+
<blockquote>
: Default: 0
+
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>ShowFileExtensions: Boolean, show filename extensions</p>
 +
 
 +
<blockquote>
 +
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>ShowFileSize: Boolean, show file size</p>
 +
 
 +
<blockquote>
 +
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>ShowUnplayedDot: Boolean, show the blue unplayed dot</p>
 +
 
 +
<blockquote>
 +
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>VideoExtensions: Array of file extensions (without leading &#8220;.&#8221;) that are video files.</p>
 +
 
 +
<blockquote>
 +
  <p>Default:
 +
    <code>(m4v, 3gp, m3u, pls, divx, xvid, avi, mov, wmv, asx, asf,  
 +
      ogm, mpg, mpeg, mp4, mkv, avc, flv, dv, fli, m2v, ts)</code></p>
 +
</blockquote>
 +
 
 +
<p>AudioExtensions: Array of file extensions (without leading &#8220;.&#8221;) that are audio files.</p>
 +
 
 +
<blockquote>
 +
  <p>Default:  
 +
    <code>(m4b, m4a, mp3, wma, wav, aif, aiff, flac, alac, m3u, mp2)</code></p>
 +
</blockquote>
 +
 
 +
<p>ResumeOffset: Integer, number of seconds to add to the bookmark time when resuming. Negative will go back in time.</p>
 +
 
 +
<blockquote>
 +
  <p>Default: 0</p>
 +
</blockquote>
 +
 
 +
<p>EnableStacking: Boolean, enable stacking of files</p>
 +
 
 +
<blockquote>
 +
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>StackRegexps: Array of regular expressions to group for stacking</p>
 +
 
 +
<blockquote>
 +
  <p>These are in PCRE format, if one group to match it is the part number,
 +
    if multiple groups, the second one is the part number.</p>
 +
 
 +
  <p>Default: <code>(
 +
      [ _\\.-]+cd[ _\\.-]*([0-9a-d]+),
 +
      [ _\\.-]+dvd[ _\\.-]*([0-9a-d]+),
 +
      [ _\\.-]+part[ _\\.-]*([0-9a-d]+),
 +
      ()([a-d])(\\....)$
 +
    )</code></p>
 +
</blockquote>
 +
 
 +
<p>EnableSubtitlesbyDefault: Boolean, enable subtitles when starting playback</p>
 +
 
 +
<blockquote>
 +
  <p>Default: NO</p>
 +
</blockquote>
 +
 
 +
<p>EnterAutomatically: Boolean, automatically enter ATVFiles at boot.</p>
 +
 
 +
<blockquote>
 +
  <p>Default: NO</p>
 +
</blockquote>
 +
 
 +
<p>ShowFileIcons: Boolean, show the playlist/stack icons in the file listings.</p>
 +
 
 +
<blockquote>
 +
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>MountBlacklist: Array, paths to mount points to never show.</p>
 +
 
 +
<blockquote>
 +
  <p>Default: (&#8220;/&#8221;)</p>
 +
</blockquote>
 +
 
 +
<p>EnableFolderParades: Boolean, enable showing folder parades when a folder has no cover.jpg.</p>
 +
 
 +
<blockquote>
 +
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>ShowPlacesOnMenu: Boolean, show the Places menu item on the main menu (Apple TV 2.0 only)</p>
 +
 
 +
<blockquote>
 +
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>ShowSettingsOnMenu: Boolean, show the Settings menu item on the main menu (Apple TV 2.0 only)</p>
 +
 
 +
<blockquote>
 +
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>UsePlaybackMenu: Boolean, show the in-playback menu when pressing MENU during playback</p>
 +
 
 +
<blockquote>
 +
  <p>Default: YES</p>
 +
</blockquote>
 +
 
 +
<p>Places: Array, paths for &#8220;places&#8221;</p>
 +
 
 +
<blockquote>
 +
  <p>Default: (<em>RootDirectory</em>)</p>
 +
</blockquote>
 +
 
 +
<p>PlacesMode: String, places mode enabled.</p>
 +
 
 +
<blockquote>
 +
  <p>This setting has no effect on Apple TV 2.0.</p>
 +
 
 +
  <p>Default: <code>On</code></p>
 +
</blockquote>
 +
 
 +
<p>Valid values for <code>PlacesMode</code> are:</p>
 +
 
 +
<ul>
 +
<li><code>On</code>: Enabled, with volumes and bookmarked folders on the initial list.</li>
 +
<li><code>Volumes</code>: Show contents of <code>RootDirectory</code> along with any mounted volumes.</li>
 +
<li><code>Off</code>: Do not show bookmarks or volumes in the initial listing.</li>
 +
</ul>
 +
 
 +
<p>Bookmarks/volumes will always be accessible from the context menu.  On Take 2, this setting
 +
is ignored.</p>
  
 
Note: Files with extensions not listed in either VideoExtensions or AudioExtensions
 
Note: Files with extensions not listed in either VideoExtensions or AudioExtensions
Line 151: Line 325:
  
 
== Release Notes ==
 
== Release Notes ==
 +
<h3 id="november12009">1.2.1.1 (491) November 1, 2009</h3>
 +
 +
<ul>
 +
<li>Rebuild with latest SapphireCompatibilityClasses to fix compatibility with newer Sapphire releases.</li>
 +
<li>Fix crash when deleting files.</li>
 +
</ul>
 +
 +
<h3 id="june282009">1.2.1 (485) June 28, 2009</h3>
 +
 +
<ul>
 +
<li>Support for Apple TV 2.4
 +
<ul><li>Limited support for the new iPhone Remote (basically, the gesture navigation).</li></ul></li>
 +
</ul>
 +
 +
<h3 id="december142008">1.2.0 (479) December 14, 2008</h3>
 +
 +
<ul>
 +
<li>Support for Apple TV 2.2 and 2.3.
 +
<ul><li>Use a more robust implementation of stacking and playlist playback.</li>
 +
<li>Perian 1.1.2 (or newer) is required for AC3 passthrough on Apple TV 2.2 or newer.</li></ul></li>
 +
<li>Drop official support for Apple TV versions older than 2.1.</li>
 +
</ul>
 +
 +
<h3 id="july142008">1.1.1 (444) July 14, 2008</h3>
 +
 +
<ul>
 +
<li>Various crash fixes for Apple TV 2.1:
 +
<ul><li>Fix AC3 passthrough</li>
 +
<li>Fix folder parades</li>
 +
<li>Fix not returning to menu on end of video playback</li></ul></li>
 +
</ul>
 +
 +
<h3 id="march172008">1.1.0 (435) March 17, 2008</h3>
 +
 +
<ul>
 +
<li>Add support for running on Apple TV Take Two.
 +
<ul><li>Places is always enabled on Take Two, as the right side of the main menu shows all the manually set ones.</li></ul></li>
 +
<li>Fix music player on Leopard.</li>
 +
<li>Speed up the folder parades a bit.
 +
<ul><li>Added entry in the Settings menu to enable/disable folder parades.</li></ul></li>
 +
<li>Fix music playback not stopping when leaving ATVFiles when Places is in use.</li>
 +
<li>Add preferences <code>ShowPlacesOnMenu</code>, <code>ShowSettingsOnMenu</code> and <code>UsePlaybackMenu</code> for advanced tweaks.
 +
<ul><li><code>Show...OnMenu</code> preferences enable/disable Places or Settings on the Take Two main menu (Take Two only).</li>
 +
<li><code>UsePlaybackMenu</code> disables the menu when pressing MENU during playback.</li></ul></li>
 +
</ul>
 +
 +
<h3 id="february102008">1.0.2 (379) February 10, 2008</h3>
 +
 +
<ul>
 +
<li>Fix &#8220;blinking&#8221; of in-playback menu when choosing &#8220;Return to file listing.&#8221;</li>
 +
<li>Swap the positions of &#8220;resume&#8221; and &#8220;return to file listing&#8221; options on the in-playback menu, to make it two presses instead of three to return to the menu.</li>
 +
<li>Fix incorrect duration when first playing back a previously unseen audio file.</li>
 +
<li>Fix potential crash when returning to browser from video player.</li>
 +
<li>Add prefix option to .run installer for automated installs (i.e. Patchstick).
 +
<ul><li>Usage: <code>sh ATVFiles-1.0.2.run install /path/to/root</code></li></ul></li>
 +
</ul>
 +
 +
<h3 id="january202008">1.0.1 (362) January 20, 2008</h3>
 +
 +
<ul>
 +
<li>Don&#8217;t include playlists and other folders when gathering assets for folder art parades.
 +
<ul><li>Add a preference <code>EnableFolderParades</code> to completely disable folder parades (pre-1.0 behavior).</li></ul></li>
 +
<li>Fix display of folder cover art when a cover image is present.</li>
 +
<li>Fix display of cover art on Apple TV just not working.</li>
 +
</ul>
 +
 +
<h3 id="january132008">1.0.0 (361) January 13, 2008</h3>
 +
 +
<ul>
 +
<li>Add menu on MENU press during playback.
 +
<ul><li>Playlist previous/next navigation for video playlists</li>
 +
<li>Subtitle toggling</li></ul></li>
 +
<li>Add option to toggle subtitles.
 +
<ul><li>Add <code>EnableSubtitlesByDefault</code> preference to enable them by default.</li></ul></li>
 +
<li>Fix the &#8220;unknown&#8221; genre problem, now any genre can be displayed with the metadata, and &#8220;unknown&#8221; will not be displayed when not specified.</li>
 +
<li>Move file size (still optional) to the metadata display instead of in the file listing.</li>
 +
<li>Add cover art preview of playlist/folder contents.</li>
 +
<li>Fix crashes with cover art and unicode file names.</li>
 +
<li>Delay resolving symlinks until playback, allowing metadata/cover art to be displayed for the symlink
 +
instead of that for the target.</li>
 +
<li>Add option to delete entire folders.</li>
 +
<li>Fix file deletion not deleting all stack segments and metadata.</li>
 +
<li>Add <code>EnterAutomatically</code> preference to automatically enter ATVFiles at boot.</li>
 +
<li>Add <code>ShowFileIcons</code> preference to hide the playlist/stack icons in the listing.</li>
 +
<li>Add Places feature, which are essentially bookmarks for favorite folders.
 +
<ul><li>Mounted volumes are listed independently (no need for mounting/symlinking under <code>~/Movies</code>).</li>
 +
<li>Folders can be added/removed from places by pressing RIGHT with the folder highlighted.</li></ul></li>
 +
<li>Leopard compatibility, thanks to the Sapphire team!
 +
<ul><li>Add pkg file for easy Leopard installation.</li></ul></li>
 +
<li>The settings menu now takes up the full width of the screen, instead of just the right-hand side.</li>
 +
<li>Now open-sourced under GPL 3.</li>
 +
</ul>
 +
 +
0.5.1 (273) October 15, 2007
 +
<ul>
 +
<li>Fix memory leak, which was holding files open after playback.</li>
 +
<li>Actually add the Finnish translations. Sorry about that.</li>
 +
</ul>
 +
 +
0.5.0 (45) September 29, 2007
 +
<ul>
 +
<li>Now requires Apple TV OS 1.1 (full or safe update).</li>
 +
<li>Fix extensions being stripped from non-filename titles.</li>
 +
<li>Add file stacking and seamless playback.</li>
 +
<li>Delay duration scanning until file playback.  Files will show duration of 0 until they
 +
are played, or it is specified in the XML file.  The detected duration will be saved
 +
regardless of if it&#8217;s in the XML.</li>
 +
<li>Added playlist support (only m3u files for now).</li>
 +
<li>Added context menu accessed by pressing right on any file browser item.
 +
<ul>
 +
<li>Options for: deleting files, playing entire selected directory contents, viewing detailed info
 +
on a file.</li>
 +
</ul></li>
 +
<li>Add support for adjusting most preferences in the app.</li>
 +
<li>Add German translation from teldec and Finnish translation from ryokale.</li>
 +
<li>Added icons in file list for playlists and file stacks.</li>
 +
<li>Added self-extracting shell script to automate manual installation.</li>
 +
</ul>
 +
 
0.4.0 (22) July 23, 2007
 
0.4.0 (22) July 23, 2007
 
* Add new icon from Telusman.
 
* Add new icon from Telusman.
Line 202: Line 495:
 
0.2.0 (5) April 8, 2007
 
0.2.0 (5) April 8, 2007
 
* Don't show the menu item when viewing remote sources
 
* Don't show the menu item when viewing remote sources
** This can be changed by setting the value of <tt>FRRemoteAppliance</tt> in Info.plist to <tt>
+
** This can be changed by setting the value of <tt>FRRemoteAppliance</tt> in Info.plist to <tt>&lt;true/&gt;</tt>
 +
* Cleaner plugin whitelist handling that doesn't raise an exception
 +
* Add basic metadata preview, including cover art
 +
* Don't show Movies folder title as root ATVFiles menu title (match root menu title)
 +
* Update icon to a non-Apple icon, and show it on all menu titles
 +
* Add basic German and Dutch localizations
 +
* Filter filenames based on extension to predefined list
 +
* Added preferences to deal with root directory
 +
* Distribute as .tar.gz instead of .dmg
 +
* Change directory content scanning method, fixes some AFP problems but not all.
 +
 
 +
0.1.0 (2) March 30, 2007
 +
* First release
 +
 
 +
== Known Issues ==
 +
<ul>
 +
<li>Files on AFP shares sometimes don&#8217;t play even if they show up and are
 +
supported. (Seems to be a BackRow problem, try restarting the ATV.)</li>
 +
<li>There is lag when a directory is first visited since it has to load and
 +
scan all metadata, and no indiciation is displayed.  This will only happen
 +
the first time, future visits should be faster (as it only loads changed
 +
metadata)</li>
 +
<li>Metadata is not read from the media files themselves (ID3, etc.)</li>
 +
<li>Some stuttering of playing music can occur when browsing files.</li>
 +
<li>Playlist issues:
 +
<ul><li>Video playlist playback shows seek bar for every entry after first one.</li>
 +
<li>No UI for creating/managing playlists.</li></ul></li>
 +
<li>No adjustment of root directory from the preferences UI.</li>
 +
<li>Front Row issues:
 +
<ul><li>Subtitles don&#8217;t work, displaying a black image instead (seems to be a bug in either Perian or QT, not ATVFiles).</li>
 +
<li>The &#8220;File Info&#8221; option on the context menus is disabled (ATV2 as well).</li></ul></li>
 +
<li>Apple TV 2.1 displays the menu between video playlist entries.</li>
 +
</ul>
 +
 
 +
== Plans ==
 +
* Support running an external editor (i.e. VLC) for specific file extensions
 +
* Minimize delays on opening directories
 +
* Read ID3 and similar tags
 +
* Cover art url tag in XML, and cache cover art
 +
 
 +
<h2 id="building">Building</h2>
 +
 
 +
<p>Requires Xcode 3 on Mac OS X 10.5 to build.</p>
 +
 
 +
<p>You need to do some setup beforehand.  See [http://wiki.awkwardtv.org/wiki/Create_Environment_for_stock_ATV_1.1_Development_with_Leopard the wiki] for details.</p>
 +
 
 +
<h2 id="license">License</h2>
 +
 
 +
<p>Copyright (C) 2007-2009 Eric Steil III.</p>
 +
 
 +
<p>ATVFiles is licensed under GPL3.  The full license can be found in LICENSE.txt.</p>
 +
 
 +
<p>This program is free software: you can redistribute it and/or modify
 +
  it under the terms of the GNU General Public License as published by
 +
  the Free Software Foundation, either version 3 of the License, or
 +
  (at your option) any later version.</p>
 +
 
 +
<p>This program is distributed in the hope that it will be useful,
 +
  but WITHOUT ANY WARRANTY; without even the implied warranty of
 +
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 +
  GNU General Public License for more details.</p>
 +
 
 +
<p>You should have received a copy of the GNU General Public License
 +
  along with this program.  If not, see http://www.gnu.org/licenses/.</p>
 +
 
 +
<h2 id="notice">Notice</h2>
 +
 
 +
<p>This program is provided at your own risk.  The author claims no responsibility
 +
for any damage or other outcome that may occur from use of this software.</p>
 +
 
 +
<p>The author is not affiliated with Apple, Inc.</p>
 +
 
 +
<h2 id="acknowledgements">Acknowledgements</h2>
 +
 
 +
<p>Contains AGRegex, copyright (c) 2002 Aram Greenman, which in turns contains
 +
PCRE, both of which are available under the BSD license.</p>
 +
 
 +
<p>Leopard compatibility code is based off the work of the Sapphire team,
 +
which they made available under the GPL 3 license.</p>
 +
 
 +
<h2 id="specialthanks">Special Thanks</h2>
 +
 
 +
<ul>
 +
<li>alan_quatermain (#awkwardtv) for his magic code to bypass the plugin
 +
whitelist.</li>
 +
<li>Telusman (http://telusman.deviantart.com/) for the new icon.</li>
 +
<li>The Sapphire Team (http://appletv.nanopi.net) for the Leopard compatibility code.</li>
 +
<li>jsh, Marco Schreijen, tomoto, GoldstarQC, elchubi, Valdemar, Stefan
 +
Christiansson, slump, BABAPUS, teldec and ryokale for translations. </li>
 +
</ul>
 +
 
 +
 
 +
== Donations ==
 +
If you wish, you may donate to ATVFiles via PayPal [https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=donate%40atvfiles%2ecom&item_name=ATVFiles&no_shipping=1&no_note=1&tax=0&currency_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8 here].
 +
 
 +
[[Category:Plugins]]

Latest revision as of 08:25, 30 December 2012

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.

ATVFiles README
Version 1.2.1.1 (491)
November 1, 2009

Screenshot gallery: http://www.tuaw.com/photos/atv-files-beta/
Download (ATV): http://ericiii.net/sa/appletv/ATVFiles-1.2.1.1.run (549KB)
Download (ATV Beta w/ 3.x support): http://ericiii.net/sa/appletv/ATVFiles-1.3.0b1.run
Download (Leopard): http://ericiii.net/sa/appletv/ATVFiles-1.2.1.1.pkg (450KB)
(manual: http://ericiii.net/sa/appletv/ATVFiles-1.2.1.1.tar.gz (450KB)
Discussion forum: http://forum.awkwardtv.org/viewforum.php?f=18
Development site: http://atvfiles.googlecode.com

Copyright (c) 2007-2009 Eric Steil III (ericiii.net)

Description

ATVFiles is an Apple TV 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.

Please note that ATVFiles does not provide the codecs. Perian is highly recommended as it provides all the common codecs.

Screenshot

Installation

Apple TV

NOTE: As of version 1.2.0, ATVFiles requires at least the Apple TV 2.1 update to run.

ATVFiles can be installed via Software Menu, or manually via the ATVFiles-1.2.0.run file.

To install manually,

  1. Copy the file ATVFiles-1.2.0.run to the Apple TV.
  2. SSH into the Apple TV, and run the following command: sudo sh ATVFiles-1.2.0.run

It does not matter what the file is named, if Safari renames it to something like ATVFiles-1.2.0.run.sh it will still work fine.

Leopard

NOTE: Leopard is not officially supported for 1.2.0, but it should work.

Double click on ATVFiles-1.2.0.pkg, and follow the prompts.

Manual method

Engadget posted a pretty good tutorial on installing this.

  1. Copy ATVFiles.frappliance to this folder: /System/Library/CoreServices/Finder.app/Contents/PlugIns 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.

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.

Usage

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.

NOTE: 0.3 MAY HAVE A DELAY UPON ENTERING A DIRECTORY FOR THE FIRST TIME WHILE IT CACHES METADATA AND FILE DURATIONS. FOR A LARGE DIRECTORY THIS MAY TAKE A FEW MINUTES, DURING WHICH THERE IS NO INDICATION OF ANY ACTIVITY.

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.

Preferences

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.

Default: /Users/frontrow/Movies

The default is actually whatever user the ATV interface is running. On an Apple TV, this user is frontrow.

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

EnableStacking: Boolean, enable stacking of files

Default: YES

StackRegexps: Array of regular expressions to group for stacking

These are in PCRE format, if one group to match it is the part number, if multiple groups, the second one is the part number.

Default: ( [ _\\.-]+cd[ _\\.-]*([0-9a-d]+), [ _\\.-]+dvd[ _\\.-]*([0-9a-d]+), [ _\\.-]+part[ _\\.-]*([0-9a-d]+), ()([a-d])(\\....)$ )

EnableSubtitlesbyDefault: Boolean, enable subtitles when starting playback

Default: NO

EnterAutomatically: Boolean, automatically enter ATVFiles at boot.

Default: NO

ShowFileIcons: Boolean, show the playlist/stack icons in the file listings.

Default: YES

MountBlacklist: Array, paths to mount points to never show.

Default: (“/”)

EnableFolderParades: Boolean, enable showing folder parades when a folder has no cover.jpg.

Default: YES

ShowPlacesOnMenu: Boolean, show the Places menu item on the main menu (Apple TV 2.0 only)

Default: YES

ShowSettingsOnMenu: Boolean, show the Settings menu item on the main menu (Apple TV 2.0 only)

Default: YES

UsePlaybackMenu: Boolean, show the in-playback menu when pressing MENU during playback

Default: YES

Places: Array, paths for “places”

Default: (RootDirectory)

PlacesMode: String, places mode enabled.

This setting has no effect on Apple TV 2.0.

Default: On

Valid values for PlacesMode are:

  • On: Enabled, with volumes and bookmarked folders on the initial list.
  • Volumes: Show contents of RootDirectory along with any mounted volumes.
  • Off: Do not show bookmarks or volumes in the initial listing.

Bookmarks/volumes will always be accessible from the context menu. On Take 2, this setting is ignored.

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">
   <title>Title</title>
   <artist>Artist</artist>
   <summary>Summary of Media</summary>
   <description>Description of Media</description>
   <publisher>Publisher</publisher>
   <composer>Composer</composer>
   <copyright>Copyright</copyright>
   <userStarRating>5</userStarRating>
   <starRating>5</starRating>
   <rating>TV-PG</rating>
   <seriesName>Veronica Mars</seriesName>
   <broadcaster>The CW</broadcaster>
   <episodeNumber>101</episodeNumber>
   <season>1</season>
   <episode>1</episode>
   <published>2006-01-01</published>
   <acquired>2006-01-01</acquired>
   <duration>3600</duration>
   
   <genres>
     <genre primary="true">Mystery</genre>
     <genre>Drama</genre>
   </genres>
   
   <cast>
     <name>Kristen Bell</name>
   </cast>
   
   <producers>
     <name>Rob Thomas</name>
   </producers>
   
   <directors>
     <name>Rob Thomas</name>
   </directors>
 </media>
 

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

1.2.1.1 (491) November 1, 2009

  • Rebuild with latest SapphireCompatibilityClasses to fix compatibility with newer Sapphire releases.
  • Fix crash when deleting files.

1.2.1 (485) June 28, 2009

  • Support for Apple TV 2.4
    • Limited support for the new iPhone Remote (basically, the gesture navigation).

1.2.0 (479) December 14, 2008

  • Support for Apple TV 2.2 and 2.3.
    • Use a more robust implementation of stacking and playlist playback.
    • Perian 1.1.2 (or newer) is required for AC3 passthrough on Apple TV 2.2 or newer.
  • Drop official support for Apple TV versions older than 2.1.

1.1.1 (444) July 14, 2008

  • Various crash fixes for Apple TV 2.1:
    • Fix AC3 passthrough
    • Fix folder parades
    • Fix not returning to menu on end of video playback

1.1.0 (435) March 17, 2008

  • Add support for running on Apple TV Take Two.
    • Places is always enabled on Take Two, as the right side of the main menu shows all the manually set ones.
  • Fix music player on Leopard.
  • Speed up the folder parades a bit.
    • Added entry in the Settings menu to enable/disable folder parades.
  • Fix music playback not stopping when leaving ATVFiles when Places is in use.
  • Add preferences ShowPlacesOnMenu, ShowSettingsOnMenu and UsePlaybackMenu for advanced tweaks.
    • Show...OnMenu preferences enable/disable Places or Settings on the Take Two main menu (Take Two only).
    • UsePlaybackMenu disables the menu when pressing MENU during playback.

1.0.2 (379) February 10, 2008

  • Fix “blinking” of in-playback menu when choosing “Return to file listing.”
  • Swap the positions of “resume” and “return to file listing” options on the in-playback menu, to make it two presses instead of three to return to the menu.
  • Fix incorrect duration when first playing back a previously unseen audio file.
  • Fix potential crash when returning to browser from video player.
  • Add prefix option to .run installer for automated installs (i.e. Patchstick).
    • Usage: sh ATVFiles-1.0.2.run install /path/to/root

1.0.1 (362) January 20, 2008

  • Don’t include playlists and other folders when gathering assets for folder art parades.
    • Add a preference EnableFolderParades to completely disable folder parades (pre-1.0 behavior).
  • Fix display of folder cover art when a cover image is present.
  • Fix display of cover art on Apple TV just not working.

1.0.0 (361) January 13, 2008

  • Add menu on MENU press during playback.
    • Playlist previous/next navigation for video playlists
    • Subtitle toggling
  • Add option to toggle subtitles.
    • Add EnableSubtitlesByDefault preference to enable them by default.
  • Fix the “unknown” genre problem, now any genre can be displayed with the metadata, and “unknown” will not be displayed when not specified.
  • Move file size (still optional) to the metadata display instead of in the file listing.
  • Add cover art preview of playlist/folder contents.
  • Fix crashes with cover art and unicode file names.
  • Delay resolving symlinks until playback, allowing metadata/cover art to be displayed for the symlink instead of that for the target.
  • Add option to delete entire folders.
  • Fix file deletion not deleting all stack segments and metadata.
  • Add EnterAutomatically preference to automatically enter ATVFiles at boot.
  • Add ShowFileIcons preference to hide the playlist/stack icons in the listing.
  • Add Places feature, which are essentially bookmarks for favorite folders.
    • Mounted volumes are listed independently (no need for mounting/symlinking under ~/Movies).
    • Folders can be added/removed from places by pressing RIGHT with the folder highlighted.
  • Leopard compatibility, thanks to the Sapphire team!
    • Add pkg file for easy Leopard installation.
  • The settings menu now takes up the full width of the screen, instead of just the right-hand side.
  • Now open-sourced under GPL 3.

0.5.1 (273) October 15, 2007

  • Fix memory leak, which was holding files open after playback.
  • Actually add the Finnish translations. Sorry about that.

0.5.0 (45) September 29, 2007

  • Now requires Apple TV OS 1.1 (full or safe update).
  • Fix extensions being stripped from non-filename titles.
  • Add file stacking and seamless playback.
  • Delay duration scanning until file playback. Files will show duration of 0 until they are played, or it is specified in the XML file. The detected duration will be saved regardless of if it’s in the XML.
  • Added playlist support (only m3u files for now).
  • Added context menu accessed by pressing right on any file browser item.
    • Options for: deleting files, playing entire selected directory contents, viewing detailed info on a file.
  • Add support for adjusting most preferences in the app.
  • Add German translation from teldec and Finnish translation from ryokale.
  • Added icons in file list for playlists and file stacks.
  • Added self-extracting shell script to automate manual installation.

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 <true/>
  • Cleaner plugin whitelist handling that doesn't raise an exception
  • Add basic metadata preview, including cover art
  • Don't show Movies folder title as root ATVFiles menu title (match root menu title)
  • Update icon to a non-Apple icon, and show it on all menu titles
  • Add basic German and Dutch localizations
  • Filter filenames based on extension to predefined list
  • Added preferences to deal with root directory
  • Distribute as .tar.gz instead of .dmg
  • Change directory content scanning method, fixes some AFP problems but not all.

0.1.0 (2) March 30, 2007

  • First release

Known Issues

  • Files on AFP shares sometimes don’t play even if they show up and are supported. (Seems to be a BackRow problem, try restarting the ATV.)
  • There is lag when a directory is first visited since it has to load and scan all metadata, and no indiciation is displayed. This will only happen the first time, future visits should be faster (as it only loads changed metadata)
  • Metadata is not read from the media files themselves (ID3, etc.)
  • Some stuttering of playing music can occur when browsing files.
  • Playlist issues:
    • Video playlist playback shows seek bar for every entry after first one.
    • No UI for creating/managing playlists.
  • No adjustment of root directory from the preferences UI.
  • Front Row issues:
    • Subtitles don’t work, displaying a black image instead (seems to be a bug in either Perian or QT, not ATVFiles).
    • The “File Info” option on the context menus is disabled (ATV2 as well).
  • Apple TV 2.1 displays the menu between video playlist entries.

Plans

  • Support running an external editor (i.e. VLC) for specific file extensions
  • Minimize delays on opening directories
  • Read ID3 and similar tags
  • Cover art url tag in XML, and cache cover art

Building

Requires Xcode 3 on Mac OS X 10.5 to build.

You need to do some setup beforehand. See the wiki for details.

License

Copyright (C) 2007-2009 Eric Steil III.

ATVFiles is licensed under GPL3. The full license can be found in LICENSE.txt.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Notice

This program is provided at your own risk. The author claims no responsibility for any damage or other outcome that may occur from use of this software.

The author is not affiliated with Apple, Inc.

Acknowledgements

Contains AGRegex, copyright (c) 2002 Aram Greenman, which in turns contains PCRE, both of which are available under the BSD license.

Leopard compatibility code is based off the work of the Sapphire team, which they made available under the GPL 3 license.

Special Thanks

  • alan_quatermain (#awkwardtv) for his magic code to bypass the plugin whitelist.
  • Telusman (http://telusman.deviantart.com/) for the new icon.
  • The Sapphire Team (http://appletv.nanopi.net) for the Leopard compatibility code.
  • jsh, Marco Schreijen, tomoto, GoldstarQC, elchubi, Valdemar, Stefan Christiansson, slump, BABAPUS, teldec and ryokale for translations.


Donations

If you wish, you may donate to ATVFiles via PayPal here.