A modern Music Player Daemon based on Rockbox open source high quality audio player
libadwaita
audio
rust
zig
deno
mpris
rockbox
mpd
1% $Id$ %
2\appendix
3
4\input{appendix/file_formats.tex}
5
6\input{appendix/album_art_info.tex}
7
8\input{appendix/wps_tags.tex}
9
10\input{appendix/config_file_options.tex}
11
12\input{appendix/menu_structure.tex}
13
14\chapter{User feedback}\label{sec:feedback}
15\section{Bug reports}
16If you experience inappropriate performance from any supported feature,
17please file a bug report on our web page. Do not report missing
18features as bugs, instead file them as feature ideas (see below).
19
20For open bug reports refer to
21\url{https://www.rockbox.org/tracker/index.php?type=2}
22
23\subsection{Rules for submitting new bug reports}
24
25\begin{enumerate}
26\item Check that the bug has not already been reported
27\item Always include the following information in your bug report:
28
29\begin{itemize}
30\item Which exact \dap{} you have.
31\item Which exact Rockbox version you are using
32(Menu $\rightarrow$ System $\rightarrow$ Rockbox Info $\rightarrow$ Version)
33\item A step{}-by{}-step description of what you did and what happened
34\item Whether the problem is repeatable or a one{}-time occurrence
35\item All relevant data regarding the problem, such as playlists, MP3
36files etc. (IMPORTANT!)
37\end{itemize}
38\end{enumerate}
39
40\section{Feature ideas}
41To suggest an idea for a feature or to read those made by others, see
42\url{https://forums.rockbox.org/index.php?board=49.0}. Please keep in
43mind that this forum is for the discussion of feature ideas -- they are not
44 requests and there is no guarantee they will be acted upon.
45
46\subsection{Rules for submitting a new feature idea}
47
48\begin{enumerate}
49\item Check that the feature has not already been suggested.
50 Duplicates are really boring!
51\item Check that the feature has not already been implemented.
52 Download the latest current/daily build and/or search the mail list archive.
53\item Check that the feature is possible to implement (see \reference{ref:NODO}).
54\end{enumerate}
55
56\subsection{\label{ref:NODO}Features we will not implement}
57This is a list of Feature Requests we get repeatedly that we simply
58cannot do. View it as the opposite of a TODO!
59
60\begin{itemize}
61\nopt{iriverh300,iaudiox5}{
62\item Interfacing with other USB devices (like cameras) or 2 player games over USB.\\
63 The USB system demands that there is a master that talks to a slave. The
64 \dap{} can only serve as a slave, as most other USB devices such as
65 cameras can. Thus, without a master no communication between the slaves
66 can take place. If that is not enough, we have no way of actually
67 controlling the communication performed over USB since the USB circuit
68 in the \dap{} is strictly made for disk{}-access and does not allow us
69 to play with it the way we'd need for any good communication to work.
70}
71\item Support other file systems than FAT32 (like NTFS or ext2 etc.).\\
72 No. (Except perhaps for ExFAT)
73 Most \dap{}s can only start off FAT32 partitions, so adding support
74 for more file systems will just take away valuable ram for
75 unnecessary features. You can partition your \dap{} fine, just make sure
76 the first one is FAT32 and then make the other ones whatever file system
77 you want. Just do not expect Rockbox to understand them.
78\item Add scandisk{}-like features.\\
79 It would be a very slow operation that would drain the batteries and
80 take a lot of useful ram for something that is much better and faster
81 done when connected to a host computer.
82\item Alphabetical list skipping.\\
83 Skipping around the lists by jumping letters (i.e skip all C's and go
84 straight to the first D). This isn't feasible with the current list
85 implementation, if you really want this you can get similar effects using
86 the database (see \reference{ref:database}).
87\item Add support for non standard tag formats.\\
88APE tags in MP3 files has been rejected a few times already. Its not something we want.
89\item Implementing the ability to playback DRM files.\\
90 Firstly, this would be extremely difficult to implement legally -- Rockbox
91 is not legal entity as such, and therefore is unable to enter into license
92 agreements with providers of DRM technology.
93 Secondly, Rockbox is open source, which would mean that any DRM technology we
94 incorporated into our codebase would suddenly become visible to the whole world,
95 completely defeating its purpose. Remember, DRM achieves part of its security
96 through obscurity, and publishing the keys necessary to decrypt DRM'd
97 media would essentially render it useless.
98\end{itemize}
99
100\chapter{Credits}
101People that have contributed to the project, one way or another. Friends!
102%
103\begin{multicols}{2}
104\noindent\caps{\small{\input{CREDITS.tex}}}
105\end{multicols}
106
107\chapter{Licenses}
108
109\section{GNU Free Documentation License}
110\input{appendix/fdl.tex}
111\newpage
112\section{The GNU General Public License}
113\input{appendix/gpl-2.0.tex}