rockbox/manual/appendix/file_formats.tex

% $Id$ %
\chapter{File formats}
\section{\label{ref:Supportedfileformats}Supported file formats}
\begin{rbtabular}{\textwidth}{clp{7em}X}%
{\textbf{Icon} & \textbf{File Type} & \textbf{Extension} 
  & \textbf{Action when selected}}{}{}
\includegraphics[width=0.37cm]{appendix/images/icon-directory.png} 
  & Directory & \emph{none} & Enter the directory \\
\opt{recorder,recorderv2fm,ondiofm,ondiosp}{
  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
  & Rockbox firmware & \fname{.ajz} & Load the new firmware with ROLO \\
}
\opt{swcodec}{
  \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png} 
  & Audio file & \emph{various}\newline%
  (see \ref{ref:Supportedaudioformats})%
  % do NOT use \reference{} here as that will break the table.
  & Start playing the file and show the WPS\\
}
  & Bookmark & \fname{.bmark} & Display all bookmarks for an audio file\\
\opt{lcd_bitmap}{
  & Game of Life & \fname{.cells} & Show the configuration with the
     ``Rocklife'' plugin\\
}
\includegraphics[width=0.37cm]{appendix/images/icon-config.png} 
  & Configuration File & \fname{.cfg} & Load the settings file\\
\includegraphics[width=0.37cm]{appendix/images/icon-chip8.png} 
  & Chip8 game & \fname{.ch8} & Play the Chip8 game \\
\opt{lcd_color}{
  & Colours & \fname{.colours} & Open the colours file for editing.
    See \reference{ref:ChangingFiletypeColours}.\\
}
\includegraphics[width=0.37cm]{appendix/images/icon-cuesheet.png} 
  & Cuesheet & \fname{.cue} & View the cuesheet file \\
\opt{radio}{
  & FM Presets & \fname{.fmr} & Load the FM Presets (previous are discarded)\\
}
\includegraphics[width=0.37cm]{appendix/images/icon-font.png} 
  & Font & \fname{.fnt} & Change the user interface font to this one\\
\opt{gigabeat}{
  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
  & Rockbox firmware & \fname{.gigabeat} & Load the new firmware with ROLO \\
}
\opt{iaudio}{
  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
  & Rockbox firmware & \fname{.iaudio} & Load the new firmware with ROLO \\
}
\opt{ipod}{
  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
  & Rockbox firmware & \fname{.ipod} & Load the new firmware with ROLO \\
}
\opt{h100,h300}{
  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
  & Rockbox firmware & \fname{.iriver} & Load the new firmware with ROLO \\
}
\includegraphics[width=0.37cm]{appendix/images/icon-image-file.png} 
  & Image & \fname{.jpg} & View the JPEG image \\
  & Link & \fname{.link} & Display list of target files and directories;
    selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\\
\includegraphics[width=0.37cm]{appendix/images/icon-lang.png} 
  & Language File & \fname{.lng} & Load the language file \\
\includegraphics[width=0.37cm]{appendix/images/icon-playlist.png}
  & Playlist & \fname{.m3u, .m3u8} & Load the playlist and start playing 
    the first file \\
\opt{h10,h10_5gb,sansa,vibe500}{
  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
  & Rockbox firmware & \fname{.mi4} & Load the new firmware with ROLO \\
}
\opt{player}{
  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
  & Rockbox firmware & \fname{.mod} & Load the new firmware with ROLO \\
}
\opt{masd,masf}{
  \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png} 
  & Audio file & \fname{.mp2, .mp3} & Start playing the file and show the WPS\\
}
\opt{swcodec}{
 \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png}
 & Video & \fname{.mpg, .mpeg, .mpv, .m2v} & Play the MPEG1/2 video \\
}
\includegraphics[width=0.37cm]{appendix/images/icon-rock.png} 
  & Plugin & \fname{.rock} & Start the plugin\\
\opt{masf}{\opt{lcd_bitmap}{
  \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png} 
    & Rockbox Video & \fname{.rvf} & View the movie (Rockbox format)\\}
}
\opt{sansaAMS}{
  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
  & Rockbox firmware & \fname{.sansa} & Load the new firmware with ROLO \\
}
\includegraphics[width=0.37cm]{appendix/images/icon-text.png} 
  & Text File & \fname{.txt} & Display the text file using the text viewer plugin\\
\opt{archos}{
  \includegraphics[width=0.37cm]{appendix/images/icon-ucl.png} 
    & Flash Image & \fname{.ucl} & Flash the Rockbox image into the ROM \\
  }
  & Voice file & \fname{.voice} & Allow Rockbox to speak menus\\
\opt{masf}{
  \includegraphics[width=0.37cm]{appendix/images/icon-wav-file.png} 
    & Wave Audio File & \fname{.wav} & Play the WAV file \\%
}
\includegraphics[width=0.37cm]{appendix/images/icon-wps.png} 
  & While Playing Screen & \fname{.wps} & Load the new WPS display configuration\\
\end{rbtabular}

\opt{swcodec}{
  \section{\label{ref:Supportedaudioformats}Supported audio formats}
  \subsection{Lossy Codecs}
  \begin{rbtabular}{\textwidth}{lp{6em}X}%
  {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
    ATSC A/52 & \fname{.a52, .ac3} & Supports downmixing for playback of 5.1 streams in stereo. \\
    ADX & \fname{.adx} & \\
    Advanced Audio Coding & \fname{.m4a, .m4b, .mp4} & \\
    MPEG audio & \fname{.mp1, .mpa, .mp2, .mp3} & \\
    Musepack & \fname{.mpc} & Supports SV7 and SV8 in mono/stereo \\
    OGG/Vorbis & \fname{.ogg, .oga} & Playback of some old ``floor 0'' files may fail. \\
    Sony Audio & \fname{.oma, .aa3} & \\
    RealAudio & \fname{.rm, .ra, .rmvb} & \\
    Speex & \fname{.spx} & \\
    Dialogic telephony type & \fname{.vox} & \\
    Windows Media Audio & \fname{.wma, .wmv, .asf} & \\
  \end{rbtabular}

  \subsection{Lossless Codecs}
  \begin{rbtabular}{\textwidth}{lp{6em}X}%
  {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
    Audio Interchange File Format & \fname{.aif, .aiff} & AIFF supports following formats: \\
                                  &                     & linear pcm 8/16/24/32 bit. \\
                                  &                     & IEEE float 32/64 bit\\
                                  &                     & ITU-T G.711 a-low/$\mu$-low\\
                                  &                     & QuickTime IMA ADPCM\\
    \opt{gigabeatf,h100,h300,x5,m5,m3,ipodnano2g,clipv1}{
      Monkey's Audio & \fname{.ape, .mac} & -c1000 to -c3000
      files decode fast enough to be useful.}
    \opt{gigabeats}{
      Monkey's Audio & \fname{.ape, .mac} & }
    \nopt{ipodnano2g}{
      \opt{ipod,h10,h10_5gb,mrobe100,sansa,vibe500}{
        Monkey's Audio & \fname{.ape, .mac} & Only -c1000 files decode fast
        enough to be useful.}
    }
    \\
    Sun Audio & \fname{.au, .snd} & Sun Audio supports following formats: \\
              &                   & linear pcm 8/16/24/32 bit. \\
              &                   & IEEE float 32/64 bit\\
              &                   & ITU-T G.711 a-low/$\mu$-low\\
    Free Lossless Audio & \fname{.flac} & \\
    Apple Lossless & \fname{.m4a, .mp4} & \\
    Shorten & \fname{.shn} & Seeking not supported.\\
    True Audio & \fname{.tta} & Decoding is not real time on some targets.\\
    Wave64 & \fname{.w64} & Wave/Wave64 supports following formats: \\
    Waveform audio format & \fname{.wav} & linear pcm 8/16/24/32 bit. \\
                          &              & IEEE float 32/64 bit\\
                          &              & ITU-T G.711 a-low/$\mu$-low\\
                          &              & Microsoft ADPCM\\
                          &              & Intel DVI ADPCM(IMA ADPCM) 2/3/4/5 bit\\
                          &              & Dialogic OKI ADPCM\\
                          &              & YAMAHA ADPCM\\
                          &              & Adobe SWF ADPCM\\
    Wavpack & \fname{.wv} & \\
  \end{rbtabular}

  \subsection{Other Codecs}
  \begin{rbtabular}{\textwidth}{lp{6em}X}%
  {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
    Atari Sound Format & \fname{.cmc, .cm3, .cmr, .cms, .dmc, .dlt, .mpt, .mpd} & \\
    Synthetic music Mobile Application Format & \fname{.mmf} & Supports PCM/ADPCM only \\
    MOD & \fname{.mod} & \\
    NES Sound Format & \fname{.nsf, .nsfe} & \\
    Atari SAP & \fname{.sap} & \\
    Sound Interface Device & \fname{.sid} & \\
    SPC700 & \fname{.spc} & \\
  \end{rbtabular}
}