Move thread-sdl.[ch] into the target tree.
[kugel-rb.git] / manual / getting_started / ipod_install.tex
blob2ec5bf87980d16acfb9bc88b63038db1e9fa0239
1 % $Id$ %
3 \subsubsection{Bootloader installation from Windows}
5 \begin{enumerate}
7 \item Download ipodpatcher.exe from
8 \download{bootloader/ipod/ipodpatcher/win32/ipodpatcher.exe}
9 and run it whilst logged in with an administrator account.
11 \item If all has gone well, you should see some information displayed about
12 your \dap{} and a message asking you if you wish to install the Rockbox
13 bootloader. Press i followed by ENTER, and ipodpatcher will now
14 install the bootloader. After a short time you should see the message
15 ``[INFO] Bootloader installed successfully.'' Press ENTER again to exit
16 ipodpatcher.
18 \item \note{If ipodpatcher fails to install the bootloader for you, please
19 be certain that you do indeed have a supported iPod model and are logged in
20 as an administrator. If you do, run
21 ipodpatcher once more and try again. If you don't, then do not attempt to
22 install again.}
24 \end{enumerate}
26 \subsubsection{Bootloader installation from Mac OS X}
28 \begin{enumerate}
30 \item Attach your \dap{} to your Mac and wait for its icon to appear in
31 Finder.
33 \item Download and open ipodpatcher.dmg from
34 \download{bootloader/ipod/ipodpatcher/macosx/ipodpatcher.dmg}
35 and then double-click on the ipodpatcher icon inside. You can also
36 drag the ipodpatcher icon to a location on your hard drive and launch
37 it from the Terminal.
39 \item If all has gone well, you should see some
40 information displayed about your \dap{} and a message asking you if you
41 wish to install the Rockbox bootloader. Press i followed by ENTER, and
42 ipodpatcher will now install the bootloader. After a short time you
43 should see the message ``[INFO] Bootloader installed successfully.'' Press
44 ENTER again to exit ipodpatcher and then quit the Terminal application.
46 \item \note{If ipodpatcher fails to install the bootloader for you, please
47 be certain that you do indeed have a supported iPod model. If you do, run
48 ipodpatcher once more and try again. If you don't, then do not attempt to
49 install again.}
51 \item Your \dap{} will now automatically reconnect itself to your Mac.
52 Wait for it to connect, and then eject and unplug it in the normal way.
53 \note{You should unplug your ipod immediately after ejecting it to
54 prevent Rockbox immediately rebooting your \dap{} into disk mode when it
55 detects that your \dap{} is attached to a computer. }
57 \end{enumerate}
59 \subsubsection{Bootloader installation from Linux}
61 \begin{enumerate}
63 \item Download ipodpatcher from
64 \download{bootloader/ipod/ipodpatcher/linux32x86/ipodpatcher} (32-bit x86
65 binary) or \download{bootloader/ipod/ipodpatcher/linux64amd64/ipodpatcher}
66 (64-bit amd64 binary). You can save this anywhere you wish, but the next
67 steps will assume you have saved it in your home directory.
69 \item Attach your \dap{} to your computer.
71 \item Open up a terminal window and type the following commands:
73 \begin{code}
74 cd $HOME
75 chmod +x ipodpatcher
76 ./ipodpatcher
77 \end{code}
79 \note{You need to be the root user in order for ipodpatcher to have
80 sufficient permission to perform raw disk access to your \dap{}.}
82 \item If all has gone well, you should see some information displayed about
83 your \dap{} and a message asking you if you wish to install the Rockbox
84 bootloader. Press i followed by ENTER, and ipodpatcher will now install the
85 bootloader. After a short time you should see the message ``[INFO] Bootloader
86 installed successfully.'' Press ENTER again to exit ipodpatcher.
88 \end{enumerate}