summaryrefslogtreecommitdiffstats log msg author committer range
 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 % $Id$ % \chapter{Getting started} \section{Welcome} This is the manual for Rockbox. Rockbox is an open source firmware replacement for a growing number of MP3 players. Rockbox aims to be considerably more functional and efficient than your device's stock firmware while remaining easy to use and customizable. Rockbox is written by users, for users. Not only is it free to use, it's also released under the GNU public license, which means that it will always remain free both to use and to change. Rockbox has been in development since 2001, and recieves new features, tweaks and fixes each day to provide you with the best possible experience on your MP3 player. A major goal of Rockbox is to be simple and easy to use, yet remain very customizable and configurable. We believe that you should never need to go through a series of menus for an action you perform frequently. We also believe that you should be able to configure almost anything about Rockbox you could want, pertaining to functionality. Another top priority of Rockbox is audio playback quality -- Rockbox, for most models, includes a wider range of sound settings than that device's original firmware. A lot of work has been put into making Rockbox sound the best it can, and improvements are constantly being made. All models have access to a large number of plugins, including many games, applications, and graphical demos''. You can load different configurations quickly for different purposes (e.g. a large font for in your car, different sound settings for at home). Rockbox features a very wide range of languages, and all supported models also have the ability to talk to you -- menus can be voiced and filenames spelled out or spoken. \section{Getting more help} This manual is intended to be a comprehensive introduction to the Rockbox firmware. There is, however, more help available. The Rockbox website at \url{http://www.rockbox.org/} contains very extensive documentation and guides written by members of the Rockbox community and this should be your first port of call when looking for further help. If you can't find the informations you're searching for on the Rockbox website there are a number of support channels you should have a look at. You can try the Rockbox forums located at \url{http://forums.rockbox.org/}. Another option are the mailing lists which can be found at \url{http://www.rockbox.org/mail/}. From that page you can subscribe to the lists and browse the archives. For searching the list archives simply use the search field that is located on the left side of the web site. Also you can ask on IRC. The main channel for rockbox is \texttt{\#rockbox} on \url{irc://irc.freenode.net}. A bunch of helpful developers and users are usually around. Just join and ask -- if someone knows the answer you'll usually get an answer pretty quickly. More information including IRC logs can be found at \url{http://www.rockbox.org/irc/}. We also have a web client for joining the rockbox IRC channel so there is no need for you to install additional software to your computer. If you think you found a bug please make sure it actually is a bug and is still present in the most recent version of rockbox. You should try to confirm that by using the above mentioned support channels first. After that you can submit that issue to our tracker. Refer to \reference{sec:feedback} for details on how to use the tracker. \section{Naming conventions and marks} We have some conventions especially on naming that are intended to be consistent throughout this manual. Manufacturer and product names are formatted in accordance with the standard rules of English grammar, e.g. \playerman{} playback is currently unsupported''. Manufacturer and model names are proper nouns, and thus are written beginning with a capital letter. % write a bit more about names etc. here. \ifpdfoutput{ This manual has some parts that are marked with icons on the margin to help you finding important parts or parts you could skip. The following icons are used: \note{This indicates a note. A note starts always with the text Note''. For easier finding of notes we have put this an icon in the margin like here. Notes are used to mark informations that could help you or indicate a possible weirdness'' in rockbox that would be explained. } \warn{This is a warning. In contrast to notes as mentioned above a warning should be taken more seriously. While ignoring notes won't cause any serious damage ignoring warnings \emph{could} cause serious damage. If you're new to rockbox you should really read the warnings before doing anything that is warned about. } \blind{This icon marks a section that are intended especially for the blind and visually impaired. As they can't read the manual in the same way sighted people can do we've added some additional descriptions. If you aren't blind or visually impaired you most likely can completely skip these blocks. To make this easier, there is an icon shown in the margin like here. } }{}% end ifpdfoutput \input{getting_started/installation.tex}