blob: 03a41bb41bbbd842784f0b1618c1d3521897aa6f [file] [log] [blame]
Dominik Riebeling251e5192006-08-02 17:21:38 +00001% $Id$ %
2\chapter{File formats}
3\section{\label{ref:Supportedfileformats}Supported file formats}
Alexander Levinfb87e892009-08-24 21:22:18 +00004\begin{rbtabular}{\textwidth}{clp{7em}X}%
5{\textbf{Icon} & \textbf{File Type} & \textbf{Extension}
6 & \textbf{Action when selected}}{}{}
Dominik Riebeling251e5192006-08-02 17:21:38 +00007\includegraphics[width=0.37cm]{appendix/images/icon-directory.png}
Alexander Levine0eb7982009-03-21 19:49:09 +00008 & Directory & \emph{none} & Enter the directory \\
Yoshihisa Uchida50b03632010-02-28 10:42:56 +00009\opt{recorder,recorderv2fm,ondiofm,ondiosp}{
10 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
11 & Rockbox firmware & \fname{.ajz} & Load the new firmware with ROLO \\
12}
13\opt{swcodec}{
14 \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png}
15 & Audio file & \emph{various}\newline%
16 (see \ref{ref:Supportedaudioformats})%
Dominik Riebeling0eea6ce2009-04-02 19:21:15 +000017 % do NOT use \reference{} here as that will break the table.
Alexander Levine0eb7982009-03-21 19:49:09 +000018 & Start playing the file and show the WPS\\
Nils Wallméniusa7210832008-08-11 22:47:17 +000019}
Yoshihisa Uchida50b03632010-02-28 10:42:56 +000020 & Bookmark & \fname{.bmark} & Display all bookmarks for an audio file\\
21\opt{lcd_bitmap}{
22 & Game of Life & \fname{.cells} & Show the configuration with the
23 ``Rocklife'' plugin\\
24}
Dominik Riebeling251e5192006-08-02 17:21:38 +000025\includegraphics[width=0.37cm]{appendix/images/icon-config.png}
Alexander Levine0eb7982009-03-21 19:49:09 +000026 & Configuration File & \fname{.cfg} & Load the settings file\\
Dominik Riebeling251e5192006-08-02 17:21:38 +000027\includegraphics[width=0.37cm]{appendix/images/icon-chip8.png}
Alexander Levine0eb7982009-03-21 19:49:09 +000028 & Chip8 game & \fname{.ch8} & Play the Chip8 game \\
Alexander Levin71812ca2009-03-20 19:33:20 +000029\opt{lcd_color}{
30 & Colours & \fname{.colours} & Open the colours file for editing.
31 See \reference{ref:ChangingFiletypeColours}.\\
32}
Yoshihisa Uchida50b03632010-02-28 10:42:56 +000033\includegraphics[width=0.37cm]{appendix/images/icon-cuesheet.png}
34 & Cuesheet & \fname{.cue} & View the cuesheet file \\
35\opt{radio}{
36 & FM Presets & \fname{.fmr} & Load the FM Presets (previous are discarded)\\
37}
38\includegraphics[width=0.37cm]{appendix/images/icon-font.png}
39 & Font & \fname{.fnt} & Change the user interface font to this one\\
40\opt{gigabeat}{
41 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
42 & Rockbox firmware & \fname{.gigabeat} & Load the new firmware with ROLO \\
43}
44\opt{iaudio}{
45 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
46 & Rockbox firmware & \fname{.iaudio} & Load the new firmware with ROLO \\
47}
48\opt{ipod}{
49 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
50 & Rockbox firmware & \fname{.ipod} & Load the new firmware with ROLO \\
51}
52\opt{h100,h300}{
53 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
54 & Rockbox firmware & \fname{.iriver} & Load the new firmware with ROLO \\
55}
56\includegraphics[width=0.37cm]{appendix/images/icon-image-file.png}
57 & Image & \fname{.jpg} & View the JPEG image \\
58 & Link & \fname{.link} & Display list of target files and directories;
59 selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\\
60\includegraphics[width=0.37cm]{appendix/images/icon-lang.png}
61 & Language File & \fname{.lng} & Load the language file \\
62\includegraphics[width=0.37cm]{appendix/images/icon-playlist.png}
63 & Playlist & \fname{.m3u, .m3u8} & Load the playlist and start playing
64 the first file \\
Szymon Dzioka09152b2010-04-15 18:35:41 +000065\opt{h10,h10_5gb,sansa,vibe500}{
Yoshihisa Uchida50b03632010-02-28 10:42:56 +000066 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
67 & Rockbox firmware & \fname{.mi4} & Load the new firmware with ROLO \\
68}
69\opt{player}{
70 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
71 & Rockbox firmware & \fname{.mod} & Load the new firmware with ROLO \\
72}
73\opt{masd,masf}{
74 \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png}
75 & Audio file & \fname{.mp2, .mp3} & Start playing the file and show the WPS\\
76}
77\opt{swcodec}{
78 \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png}
79 & Video & \fname{.mpg, .mpeg, .mpv, .m2v} & Play the MPEG1/2 video \\
80}
81\includegraphics[width=0.37cm]{appendix/images/icon-rock.png}
82 & Plugin & \fname{.rock} & Start the plugin\\
83\opt{masf}{\opt{lcd_bitmap}{
84 \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png}
85 & Rockbox Video & \fname{.rvf} & View the movie (Rockbox format)\\}
86}
87\opt{sansaAMS}{
88 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
89 & Rockbox firmware & \fname{.sansa} & Load the new firmware with ROLO \\
90}
91\includegraphics[width=0.37cm]{appendix/images/icon-text.png}
92 & Text File & \fname{.txt} & Display the text file using the text viewer plugin\\
93\opt{archos}{
94 \includegraphics[width=0.37cm]{appendix/images/icon-ucl.png}
95 & Flash Image & \fname{.ucl} & Flash the Rockbox image into the ROM \\
96 }
97 & Voice file & \fname{.voice} & Allow Rockbox to speak menus\\
98\opt{masf}{
99 \includegraphics[width=0.37cm]{appendix/images/icon-wav-file.png}
100 & Wave Audio File & \fname{.wav} & Play the WAV file \\%
101}
102\includegraphics[width=0.37cm]{appendix/images/icon-wps.png}
103 & While Playing Screen & \fname{.wps} & Load the new WPS display configuration\\
Alexander Levinfb87e892009-08-24 21:22:18 +0000104\end{rbtabular}
Dominik Riebeling251e5192006-08-02 17:21:38 +0000105
Nils Wallméniusa7210832008-08-11 22:47:17 +0000106\opt{swcodec}{
107 \section{\label{ref:Supportedaudioformats}Supported audio formats}
Alexander Levin6a62e222010-03-01 21:10:04 +0000108 \subsection{Lossy Codecs}
Alexander Levinfb87e892009-08-24 21:22:18 +0000109 \begin{rbtabular}{\textwidth}{lp{6em}X}%
110 {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
Nils Wallméniusa7210832008-08-11 22:47:17 +0000111 ATSC A/52 & \fname{.a52, .ac3} & Supports downmixing for playback of 5.1 streams in stereo. \\
112 ADX & \fname{.adx} & \\
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000113 Advanced Audio Coding & \fname{.m4a, .m4b, .mp4} & \\
114 MPEG audio & \fname{.mp1, .mpa, .mp2, .mp3} & \\
Andree Buschmannb3d95782010-03-07 19:34:44 +0000115 Musepack & \fname{.mpc} & Supports SV7 and SV8 in mono/stereo \\
Nils Wallméniuscfd245e2010-04-03 03:37:27 +0000116 OGG/Vorbis & \fname{.ogg, .oga} & Playback of some old ``floor 0'' files may fail. \\
Alexander Levin499641c2010-02-19 20:50:24 +0000117 Sony Audio & \fname{.oma, .aa3} & \\
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000118 RealAudio & \fname{.rm, .ra, .rmvb} & \\
119 Speex & \fname{.spx} & \\
120 Dialogic telephony type & \fname{.vox} & \\
Mohamed Tarekf0aac622010-07-28 14:40:48 +0000121 Windows Media Audio Standard & \fname{.wma, .wmv, .asf} & \\
122 Windows Media Audio Professional & \fname{.wma, .wmv, .asf} & \\
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000123 \end{rbtabular}
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000124
Alexander Levin6a62e222010-03-01 21:10:04 +0000125 \subsection{Lossless Codecs}
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000126 \begin{rbtabular}{\textwidth}{lp{6em}X}%
127 {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
128 Audio Interchange File Format & \fname{.aif, .aiff} & AIFF supports following formats: \\
129 & & linear pcm 8/16/24/32 bit. \\
130 & & IEEE float 32/64 bit\\
131 & & ITU-T G.711 a-low/$\mu$-low\\
132 & & QuickTime IMA ADPCM\\
Marianne Arnold5b47b892010-08-16 09:43:48 +0000133 \opt{gigabeatf,h100,h300,iaudiox5,iaudiom5,iaudiom3,ipodnano2g,clipv1}{
Alex Parker268a4ae2009-08-24 11:16:06 +0000134 Monkey's Audio & \fname{.ape, .mac} & -c1000 to -c3000
135 files decode fast enough to be useful.}
Nils Wallménius4add1af2009-01-06 11:35:47 +0000136 \opt{gigabeats}{
Nils Wallménius22942db2010-05-17 08:12:07 +0000137 Monkey's Audio & \fname{.ape, .mac} & }
138 \nopt{ipodnano2g}{
139 \opt{ipod,h10,h10_5gb,mrobe100,sansa,vibe500}{
140 Monkey's Audio & \fname{.ape, .mac} & Only -c1000 files decode fast
141 enough to be useful.}
142 }
Nils Wallméniusa7210832008-08-11 22:47:17 +0000143 \\
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000144 Sun Audio & \fname{.au, .snd} & Sun Audio supports following formats: \\
145 & & linear pcm 8/16/24/32 bit. \\
146 & & IEEE float 32/64 bit\\
147 & & ITU-T G.711 a-low/$\mu$-low\\
148 Free Lossless Audio & \fname{.flac} & \\
149 Apple Lossless & \fname{.m4a, .mp4} & \\
150 Shorten & \fname{.shn} & Seeking not supported.\\
Nils Wallméniusa083b9a2010-07-19 11:12:21 +0000151 True Audio & \fname{.tta} & \\
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000152 Wave64 & \fname{.w64} & Wave/Wave64 supports following formats: \\
153 Waveform audio format & \fname{.wav} & linear pcm 8/16/24/32 bit. \\
154 & & IEEE float 32/64 bit\\
155 & & ITU-T G.711 a-low/$\mu$-low\\
156 & & Microsoft ADPCM\\
157 & & Intel DVI ADPCM(IMA ADPCM) 2/3/4/5 bit\\
158 & & Dialogic OKI ADPCM\\
159 & & YAMAHA ADPCM\\
160 & & Adobe SWF ADPCM\\
161 Wavpack & \fname{.wv} & \\
162 \end{rbtabular}
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000163
Alexander Levin6a62e222010-03-01 21:10:04 +0000164 \subsection{Other Codecs}
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000165 \begin{rbtabular}{\textwidth}{lp{6em}X}%
166 {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
167 Atari Sound Format & \fname{.cmc, .cm3, .cmr, .cms, .dmc, .dlt, .mpt, .mpd} & \\
168 Synthetic music Mobile Application Format & \fname{.mmf} & Supports PCM/ADPCM only \\
Nils Wallméniusa7210832008-08-11 22:47:17 +0000169 MOD & \fname{.mod} & \\
170 NES Sound Format & \fname{.nsf, .nsfe} & \\
Nils Wallméniusa7210832008-08-11 22:47:17 +0000171 Atari SAP & \fname{.sap} & \\
Yoshihisa Uchida50b03632010-02-28 10:42:56 +0000172 Sound Interface Device & \fname{.sid} & \\
173 SPC700 & \fname{.spc} & \\
Alexander Levinfb87e892009-08-24 21:22:18 +0000174 \end{rbtabular}
Nils Wallméniusa7210832008-08-11 22:47:17 +0000175}