summaryrefslogtreecommitdiffstats
path: root/manual/getting_started/ipod_install.tex
blob: 3ee4e9d78b3f2960cf5a69933c37aa4240eb9e28 (plain)
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
\subsubsection{Bootloader installation from Windows}

\begin{enumerate}

\item Download ipodpatcher.exe from
\download{bootloader/ipod/ipodpatcher/win32/ipodpatcher.exe}
and run it whilst logged in with an administrator account.

\item If all has gone well, you should see some information displayed about
your \dap{} and a message asking you if you wish to install the Rockbox
bootloader. Press i followed by ENTER, and ipodpatcher will now
install the bootloader. After a short time you should see the message
``[INFO] Bootloader installed successfully.'' Press ENTER again to exit
ipodpatcher.

\item \note{If ipodpatcher fails to install the bootloader for you, please
be certain that you do indeed have a supported iPod model and are logged in
as an administrator. If you do, run
ipodpatcher once more and try again. If you don't, then do not attempt to
install again.}

\end{enumerate}

\subsubsection{Bootloader installation from Mac OS X}

\begin{enumerate}

\item Attach your \dap{} to your Mac and wait for its icon to appear in
Finder.

\item Download and open ipodpatcher.dmg from
\download{bootloader/ipod/ipodpatcher/macosx/ipodpatcher.dmg}
and then double-click on the ipodpatcher icon inside. You can also
drag the ipodpatcher icon to a location on your hard drive and launch
it from the Terminal.

\item If all has gone well, you should see some
information displayed about your \dap{} and a message asking you if you
wish to install the Rockbox bootloader. Press i followed by ENTER, and
ipodpatcher will now install the bootloader. After a short time you
should see the message ``[INFO] Bootloader installed successfully.'' Press
ENTER again to exit ipodpatcher and then quit the Terminal application.

\item \note{If ipodpatcher fails to install the bootloader for you, please
be certain that you do indeed have a supported iPod model. If you do, run
ipodpatcher once more and try again. If you don't, then do not attempt to
install again.}

\item Your \dap{} will now automatically reconnect itself to your Mac.
Wait for it to connect, and then eject and unplug it in the normal way.
\note{You should unplug your ipod immediately after ejecting it to
prevent Rockbox immediately rebooting your \dap{} into disk mode when it
detects that your \dap{} is attached to a computer. }

\end{enumerate}

\subsubsection{Bootloader installation from Linux}

\begin{enumerate}

\item Download ipodpatcher from
\download{bootloader/ipod/ipodpatcher/linux32x86/ipodpatcher} (32-bit x86
binary) or \download{bootloader/ipod/ipodpatcher/linux64amd64/ipodpatcher}
(64-bit amd64 binary). You can save this anywhere you wish, but the next
steps will assume you have saved it in your home directory.

\item Attach your \dap{} to your computer.

\item Open up a terminal window and type the following commands:

\begin{code}
    cd $HOME
    chmod +x ipodpatcher
    ./ipodpatcher
\end{code}

\note{You need to be the root user in order for ipodpatcher to have
sufficient permission to perform raw disk access to your \dap{}.}

\item If all has gone well, you should see some information displayed about
your \dap{} and a message asking you if you wish to install the Rockbox
bootloader. Press i followed by ENTER, and ipodpatcher will now install the
bootloader. After a short time you should see the message ``[INFO] Bootloader
installed successfully.'' Press ENTER again to exit ipodpatcher.

\end{enumerate}