Difference between revisions of "ATVFiles"

From AwkwardTV
Jump to: navigation, search
m
Line 1: Line 1:
[http://lylovec.info/tagliatella/ Tagliatella] [http://itliks.info/powerranger/ Power ranger] [http://joekla.info/blog/rivistaacconciatura.html Rivista acconciatura femminile] [http://natesos.info/transexit/ Transex it] [http://joekla.info/blog/rimorchiotrattorino.html Rimorchio trattorino] [http://laseris.info/scarpaconverse.html Scarpa converse anarchy peace] [http://moratet.info/temisvoltipena.html Temi svolti pena morte] [http://melolis.info/sextv1/ Sextv1] [http://kliorte.info/scaricafilm/ Scarica film dvd] [http://jirvoje.info/pisciatedi.html Pisciate di figa] [http://melolis.info/sessobizzarro/ Sesso bizzarro] [http://kevcan.info/prestitopiacenza.html Prestito piacenza] [http://kevcan.info/prestitofinanziamento.html Prestito finanziamento] [http://jirvoje.info/pillolapoco.html Pillola poco costosa dieta tenuate] [http://jasenti.info/blog/prototipotoyota.html Prototipo toyota] [http://meximep.info/tesiscuola.html Tesi scuola] [http://kliorte.info/samsungsghz140/ Samsung sgh z140 prezzo] [http://kevcan.info/prestitopistoia.html Prestito pistoia] [http://kevcan.info/prestitocalabria.html Prestito calabria online] [http://melolis.info/sexycasalinghe/ Sexy casalinghe] [http://natesos.info/tranny/ Tranny] [http://kevcan.info/prestitoabruzzo.html Prestito abruzzo online] [http://lerofne.info/solleticopiedi/ Solletico piedi] [http://kwyndex.info/text/ravenriley.html Ravenriley askjolene] [http://jasenti.info/blog/primaldefense.html Primal defense] [http://itliks.info/pps/ Pps] [http://lylovec.info/suzuky/ Suzuky] [http://itliks.info/pornocasalinga/ Porno casalinga] [http://lerofne.info/snakesexfree/ Snake sex free porno gallery] [http://mikylir.info/spidermancolorare.html Spiderman colorare] [http://jirvoje.info/pompinididiciottenni.html Pompini di diciottenni] [http://kirtose.info/topic/raffaellazardo.html Raffaella zardo] [http://lyndjie.info/sexypompini.html Sexy pompini] [http://kliorte.info/scalaachiocciola/ Scala a chiocciola dwg] [http://laseris.info/schedaaudio.html Scheda audio usb] [http://isitale.info/articles/oscavibratori.html Osca vibratori] [http://isitale.info/articles/orologiodepoca.html Orologio d epoca] [http://kwyndex.info/text/regcleaner.html Regcleaner download] [http://mikylir.info/sportnutrition.html Sport nutrition] [http://jasenti.info/blog/puliziaindustriali.html Pulizia industriali] [http://lylovec.info/tariffatelefonica/ Tariffa telefonica] [http://lyndjie.info/simonavalli.html Simona valli pornostar] [http://lyndjie.info/sfondididdl.html Sfondi diddl per cellulare] [http://melolis.info/settimanali/ Settimanali] [http://lerofne.info/skinhead/ Skinhead] [http://mikylir.info/strudelmele.html Strudel mele] [http://meximep.info/termoli.html Termoli] [http://melolis.info/serramenta/ Serramenta pvc] [http://laseris.info/scicli.html Scicli] [http://laseris.info/scioperi.html Scioperi] [http://jirvoje.info/porchebrasiliane.html Porche brasiliane] [http://mikylir.info/spicegirls.html Spice girls] [http://laseris.info/schermopiatto.html Schermo piatto pc] [http://isitale.info/articles/orologio.html Orologio vendita on line] [http://jisegyn.info/pavimentidaesterno/ Pavimenti da esterno veneto] [http://itliks.info/pornocavalli/ Porno cavalli] [http://mikylir.info/stampantea.html Stampante a sublimazione] [http://joekla.info/blog/rossanacasale.html Rossana casale] [http://isitale.info/articles/parcheggioaeroporto.html Parcheggio aeroporto treviso] [http://meximep.info/tettonenegre.html Tettone negre] [http://lylovec.info/surveillance/ Surveillance camera] [http://lerofne.info/sloveniaandvacanza/ Slovenia and vacanza] [http://jasenti.info/blog/pureafavascarola.html Purea fava scarola pecorino] [http://lerofne.info/smorfianapoletana/ Smorfia napoletana] [http://jasenti.info/blog/puttanenude.html Puttane nude] [http://itliks.info/pornostorie/ Pornostorie] [http://meximep.info/testpsicologico.html Test psicologico] [http://jirvoje.info/pissdrinking.html Piss drinking] [http://kliorte.info/scaricareemule/ Scaricare emule] [http://lylovec.info/tarareid/ Tara reid] [http://kevcan.info/prestazioni.html Prestazioni occasionali] [http://meximep.info/testofrancesco.html Testo francesco renga] [http://isitale.info/articles/ortaggiocoltivazione.html Ortaggio coltivazione] [http://lyndjie.info/sexysegretarie.html Sexy segretarie] [http://kliorte.info/sakurahentai/ Sakura hentai] [http://melolis.info/sexmature/ Sex mature] [http://meximep.info/texasristorante.html Texas ristorante] [http://laseris.info/scherzopcfinti.html Scherzo pc finti virus] [http://laseris.info/seicentofiat.html Seicento fiat] [http://natesos.info/toremarlivorno/ Toremar livorno] [http://melolis.info/sexylegs/ Sexy legs] [http://lyndjie.info/simboligiapponesi.html Simboli giapponesi] [http://joekla.info/blog/rubinettolavabo.html Rubinetto lavabo bagno] [http://jisegyn.info/pentolawok/ Pentola wok] [http://kirtose.info/topic/raiuno.html Rai uno] [http://jasenti.info/blog/psicologia.html Psicologia scuola] [http://joekla.info/blog/russianteen.html Russian teen sex] [http://moratet.info/tazza.html Tazza] [http://natesos.info/tirreno/ Tirreno] [http://mikylir.info/structuredsettlement.html Structured settlement payment] [http://kliorte.info/sanfrancisco/ San francisco intrattenimento] [http://joekla.info/blog/rivistaitaliana.html Rivista italiana medicina legale] [http://melolis.info/sexanimalzoo/ Sex animal zoo] [http://mikylir.info/statuagrande.html Statua grande seno] [http://melolis.info/sextoondragon/ Sextoon dragon ball] [http://jisegyn.info/pianteofficinali/ Piante officinali] [http://lyndjie.info/sicurezzainformatica.html Sicurezza informatica] [http://itliks.info/pornoveramente/ Porno veramente gratis] [http://jasenti.info/blog/programmaraiuno.html Programma raiuno] [http://jasenti.info/blog/programmatelevisivo.html Programma televisivo oggi] [http://laseris.info/scatolapizza.html Scatola pizza] [http://moratet.info/teenfotonude.html Teen foto nude] [http://jisegyn.info/phicanet/ Phica net] [http://lerofne.info/soggiornare/ Soggiornare casa vacenze info] [http://laseris.info/scopatavideo.html Scopata video foto orgia] [http://jisegyn.info/penetrazioni/ Penetrazioni gay] [http://itliks.info/pornosesso/ Pornosesso com] [http://lylovec.info/svilupposostenibile/ Sviluppo sostenibile ed economia] [http://jirvoje.info/piscinacostruzione.html Piscina costruzione] [http://lylovec.info/suoneriaericson/ Suoneria ericson] [http://meximep.info/testogirlfriend.html Testo girlfriend in italiano] [http://laseris.info/scopate.html Scopate] [http://jisegyn.info/piediesolletico/ Piedi e solletico] [http://isitale.info/articles/orologiofalso.html Orologio falso] [http://mikylir.info/stampadvdrom.html Stampa dvd rom] [http://lyndjie.info/simonaventura.html Simona ventura nuda] [http://lylovec.info/superhentai/ Super hentai] [http://kevcan.info/premiostrega.html Premio strega] [http://lyndjie.info/shittingfree.html Shitting free] [http://isitale.info/articles/palermoballaro.html Palermo ballaro] [http://jirvoje.info/pornazzigratis.html Pornazzi gratis] [http://isitale.info/articles/ozzyosbourne.html Ozzy osbourne biografia] [http://meximep.info/tettexxx.html Tette xxx] [http://kevcan.info/prestitoanticipo.html Prestito anticipo immediato] [http://kliorte.info/sandalopositano/ Sandalo positano] [http://melolis.info/serviziocliente/ Servizio cliente visa] [http://meximep.info/termetoscana.html Terme toscana] [http://lylovec.info/tampasanpetersburg/ Tampa san petersburg ristorante] [http://isitale.info/articles/parcocornelle.html Parco cornelle] [http://lylovec.info/superculi/ Super culi] [http://joekla.info/blog/rivideomediaset.html Rivideo mediaset it] [http://jisegyn.info/personalemilitare/ Personale militare prestito pensionato] [http://mikylir.info/spigola.html Spigola] [http://lylovec.info/sulmona/ Sulmona] [http://kevcan.info/prestitocatanzaro.html Prestito catanzaro] [http://isitale.info/articles/oscarwildetesina.html Oscar wilde tesina] [http://jasenti.info/blog/puttaneroma.html Puttane roma] [http://joekla.info/blog/risultato.html Risultato superenalotto it] [http://isitale.info/articles/oroscopoascendente.html Oroscopo ascendente] [http://jirvoje.info/polskinuda.html Polski nuda] [http://kliorte.info/sanmarinocepu/ San marino cepu open] [http://jirvoje.info/piscinamanutenzione.html Piscina manutenzione] [http://lerofne.info/sostituzione/ Sostituzione serranda] [http://lylovec.info/suoreputtane/ Suore puttane] [http://kwyndex.info/text/ricambioauto.html Ricambio auto] [http://jisegyn.info/pennasfera/ Penna sfera] [http://kevcan.info/pressapiegatrice.html Pressa piegatrice elettrica] [http://laseris.info/segretarietettone.html Segretarie tettone] [http://kwyndex.info/text/randyingerman.html Randy ingerman] [http://meximep.info/tinitadsl.html Tin it adsl numero fax] [http://moratet.info/tavolehentai.html Tavole hentai] [http://meximep.info/thumbzilla.html Thumbzilla] [http://jisegyn.info/pensionieconomiche/ Pensioni economiche roma] [http://lerofne.info/softwarepaga/ Software paga asp] [http://meximep.info/thespecialist.html The specialist roberta missoni] [http://melolis.info/sessocom/ Sesso com] [http://kevcan.info/preventivoon.html Preventivo on line assicurazione auto] [http://moratet.info/taylorrain.html Taylor rain] [http://natesos.info/traduzionein/ Traduzione in russo gratis] [http://laseris.info/scuoladimoda.html Scuola di moda napoli] [http://moratet.info/tatuaggigladiatore.html Tatuaggi gladiatore] [http://joekla.info/blog/rinegoziare.html Rinegoziare mutuo] [http://mikylir.info/sportpress.html Sportpress] [http://lylovec.info/superporno/ Super porno gratis] [http://isitale.info/articles/outletntoscana.html Outlet n toscana] [http://jisegyn.info/pergolatoinlegno/ Pergolato in legno] [http://jasenti.info/blog/puttanellein.html Puttanelle in calore] [http://natesos.info/trannysexfree/ Tranny sex free pic] [http://lerofne.info/slysoft/ Slysoft] [http://lylovec.info/supercock/ Super cock] [http://melolis.info/sexzoo/ Sex zoo] [http://mikylir.info/squallor.html Squallor] [http://moratet.info/teatrolacometa.html Teatro la cometa] [http://lyndjie.info/sfondi3dwindows.html Sfondi 3d windows] [http://moratet.info/tendacampeggio.html Tenda campeggio casetta] [http://isitale.info/articles/oroscopooggi.html Oroscopo oggi tutti amico] [http://itliks.info/ppssexi/ Pps sexi] [http://melolis.info/serviziobanco/ Servizio banco sicilia it] [http://kevcan.info/prestitoemilia.html Prestito emilia] [http://natesos.info/tortedecorate/ Torte decorate] [http://kevcan.info/prestitoaquila.html Prestito aquila] [http://lerofne.info/soleglitter/ Sole glitter] [http://moratet.info/telaiobicicletta.html Telaio bicicletta] [http://moratet.info/tendearredo.html Tende arredo casa] [http://natesos.info/trailerporno/ Trailer porno gratis] [http://jisegyn.info/pescainmare/ Pesca in mare] [http://itliks.info/ppssexygratis/ Pps sexy gratis] [http://jirvoje.info/pinodaniele.html Pino daniele] [http://itliks.info/pornocartoni/ Porno cartoni gratis] [http://mikylir.info/stromboli.html Stromboli] [http://mikylir.info/speedometer.html Speedometer sunrise] [http://melolis.info/sexshemaleon/ Sex shemale on orgy] [http://natesos.info/tonycolombo/ Tony colombo] [http://jirvoje.info/pompininere.html Pompini nere] [http://lyndjie.info/sfondosimpsons.html Sfondo simpsons x] [http://isitale.info/articles/pamela-anderson-nuda.html Pamela-anderson-nuda] [http://jirvoje.info/pontedilegno.html Ponte di legno] [http://laseris.info/index1_100.html homepage] [http://kevcan.info/preservativo.html Preservativo] [http://kwyndex.info/text/ricettalasagna.html Ricetta lasagna vegetale] [http://lerofne.info/softwaretotocalcio/ Software totocalcio] [http://melolis.info/sexwifepantyhose/ Sex wife pantyhose] [http://lerofne.info/smsdamorededica/ Sms d amore dedica messaggio] [http://mikylir.info/spiaggenaturiste.html Spiagge naturiste versilia] [http://lerofne.info/sogei/ Sogei] [http://natesos.info/trampi/ Trampi] [http://joekla.info/blog/rivistafemminili.html Rivista femminili] [http://kliorte.info/scaricamsn/ Scarica msn messenger plus] [http://kwyndex.info/text/realizzazione.html Realizzazione sito web firenze] [http://moratet.info/tedesche.html Tedesche troie] [http://lerofne.info/sophiemoone/ Sophie moone playing game rs] [http://joekla.info/blog/ristorantecina.html Ristorante cina] [http://melolis.info/sessoincontro/ Sesso incontro cosenza] [http://lylovec.info/suoneriapaolo/ Suoneria paolo meneguzzi] [http://kirtose.info/topic/raccontierotici.html Racconti erotici zia nipote] [http://lylovec.info/tarinatarantino/ Tarina tarantino] [http://kliorte.info/sansevero/ San severo] [http://lerofne.info/soscartuccia/ Sos cartuccia] [http://lerofne.info/smackdown/ Smackdown mediaset it] [http://itliks.info/pornogay/ Porno gay maturi] '''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  
+
'''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.
5A8
 
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<br>
 
ATVFiles README<br>
Line 27: Line 25:
 
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.
 
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.
  
 
5A8
 
 
2. Restart Finder.
 
2. 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.  The Finder will be automatically restarted.
 
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.
Line 51: Line 47:
 
and can be either <tt>jpg</tt>, <tt>tif</tt>, <tt>tiff</tt>, or <tt>png</tt>):
 
and can be either <tt>jpg</tt>, <tt>tif</tt>, <tt>tiff</tt>, or <tt>png</tt>):
  
For folders: Either <tt>folder.jpg</t
+
For folders: Either <tt>folder.jpg</tt> or <tt>cover.jpg</tt> in the folder.
5A8
 
t> or <tt>cover.jpg</tt> in the folder.
 
  
 
For other files: The same as the filename without the extension, and the image
 
For other files: The same as the filename without the extension, and the image
Line 83: Line 77:
 
: Default: YES
 
: Default: YES
 
VideoExtensions: Array of file extensions (without leading ".") that are video files.
 
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,  
+
: Default: (m4v, 3gp, m3u, pls, divx, xvid, avi, mov, wmv, asx, asf, ogm, mpg, mpeg, mp4, mkv, avc, flv, dv, fli, m2v, ts)
5A8
 
mkv, avc, flv, dv, fli, m2v, ts)
 
 
AudioExtensions: Array of file extensions (without leading ".") that are audio files.
 
AudioExtensions: Array of file extensions (without leading ".") that are audio files.
 
: Default: (m4b, m4a, mp3, wma, wav, aif, aiff, flac, alac, m3u, mp2)
 
: Default: (m4b, m4a, mp3, wma, wav, aif, aiff, flac, alac, m3u, mp2)
Line 110: Line 102:
 
available internally.
 
available internally.
  
Example file, see the wiki for mo
+
Example file, see the wiki for more complete examples:
5A8
 
re complete examples:
 
  
 
   <media type="TV Show">
 
   <media type="TV Show">
Line 154: Line 144:
 
Random Notes about the data:
 
Random Notes about the data:
 
* All these are optional
 
* All these are optional
* duration is only to override if the QuickTime scannin
+
* duration is only to override if the QuickTime scanning gets it wrong, otherwise it should not be used.
5A8
 
g gets it wrong, otherwise it should not be used.
 
 
* rating will display graphics for the usual ones (R, TV-PG, etc.)
 
* 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
 
* 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
Line 178: Line 166:
  
 
0.3.2 (14) June 20, 2007
 
0.3.2 (14) June 20, 2007
* Update for compatibility with the Apple TV 1.1 u
+
* Update for compatibility with the Apple TV 1.1 update.
5A8
 
pdate.
 
  
 
0.3.1 (13) May 20, 2007
 
0.3.1 (13) May 20, 2007
Line 207: Line 193:
 
* Fix problem with absolute symlinks
 
* Fix problem with absolute symlinks
 
* Use natural sorting for files with numbers
 
* Use natural sorting for files with numbers
* Add preferences  
+
* Add preferences to hide filename extensions and file sizes
5A8
 
to hide filename extensions and file sizes
 
  
 
0.2.1 (6) April 8, 2007
 
0.2.1 (6) April 8, 2007
Line 220: Line 204:
 
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 ==
 +
* 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.)
 +
* Non-video files are played back using the QT player.
 +
* 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.)
 +
* Symlinks are shown with the target's name, not the symlink name.
 +
** Metadata is also only read matching for the target.
 +
** In summary, symlinks are resolved as soon as they're seen and otherwise treat it exactly like the destination.
 +
* Some stuttering of playing music can occur when browsing files.
 +
 
 +
== Plans ==
 +
* Support running an external editor (i.e. VLC) for specific file extensions
 +
* Minimize delays on opening directories
 +
* Use media parades for folders without explicit cover art
 +
* Read ID3 and similar tags
 +
* Cover art url tag in XML, and cache cover art
 +
 
 +
== License ==
 +
It's free to use, however please don't redistribute it without my permission.
 +
 
 +
== Support ==
 +
For support please use either the IRC channel or the [http://forum.awkwardtv.org/viewforum.php?f=18 discussion forum].  Please do not contact me via e-mail for support with the plugin.  Thanks :)
 +
 
 +
You might also want to look at [[Mount a Remote Drive via AFP]] or [[Mount a Remote Drive via SMBFS]]
 +
 
 +
== 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.
 +
 
 +
== Special Thanks ==
 +
* alan_quatermain (#awkwardtv) for his magic code to bypass the plugin whitelist.
 +
* Telusman (http://telusman.deviantart.com/) for the new icon.
 +
* jsh, Marco Schreijen, tomoto, GoldstarQC and elchubi for translations.
 +
 
 +
== Source Code ==
 +
The source code is not yet available.  I have not yet decided on anything on that matter.  I do not have any plans to charge for the plugin though, so don't worry about that.
 +
 
 +
== 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]]

Revision as of 11:53, 21 September 2007

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 0.4.0 (22)
July 23, 2007

Screenshot gallery: http://www.tuaw.com/photos/atv-files-beta/
Download: http://ericiii.net/sa/appletv/ATVFiles-0.4.0.tar.gz (3.1MB)
Discussion forum: http://forum.awkwardtv.org/viewforum.php?f=18

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

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.

Screenshot

See http://wiki.awkwardtv.org/ for more details.

Installation

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

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.

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

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.)
  • Non-video files are played back using the QT player.
  • 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.)
  • Symlinks are shown with the target's name, not the symlink name.
    • Metadata is also only read matching for the target.
    • In summary, symlinks are resolved as soon as they're seen and otherwise treat it exactly like the destination.
  • Some stuttering of playing music can occur when browsing files.

Plans

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

License

It's free to use, however please don't redistribute it without my permission.

Support

For support please use either the IRC channel or the discussion forum. Please do not contact me via e-mail for support with the plugin. Thanks :)

You might also want to look at Mount a Remote Drive via AFP or Mount a Remote Drive via SMBFS

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.

Special Thanks

  • alan_quatermain (#awkwardtv) for his magic code to bypass the plugin whitelist.
  • Telusman (http://telusman.deviantart.com/) for the new icon.
  • jsh, Marco Schreijen, tomoto, GoldstarQC and elchubi for translations.

Source Code

The source code is not yet available. I have not yet decided on anything on that matter. I do not have any plans to charge for the plugin though, so don't worry about that.

Donations

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