summaryrefslogtreecommitdiffstats
path: root/manual/getting_started/ipod_install.tex
blob: a60d8a455d2b3d550b047da1f0f77411a7c53faa (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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
% $Id$ %

\opt{ipodnano}{\warn{If your Nano has a stainless steel back and plastic front 
it is a 1st generation and is compatible with Rockbox.  If, on the other hand, 
your Nano has a one-piece aluminum body it is a 2nd generation Nano and there 
is currently no Rockbox port available.  Do not attempt to install the 
bootloader on a 2nd generation Nano}}

In order to make your iPod load and execute the Rockbox firmware you
have just installed, you will need to install the Rockbox
bootloader. Unless bugs are found in the bootloader code, or
significant new feature are added, you will only have to perform this
step once.

\subsubsection{Bootloader installation from Windows}

\begin{enumerate}

\item Make sure you are logged into your computer as Administrator, or a 
user with Administrator privileges and connect your ipod.

\item Download ipodpatcher.exe from 
\download{bootloader/ipod/ipodpatcher/win32/ipodpatcher.exe} 
and run it.

\item If all has gone well, you should see some information displayed about
your ipod 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 Make sure you have a \fname{rockbox.ipod} file and a 
\fname{.rockbox} folder in the 
root of your Ipod's drive and that you have also installed the fonts
package - see \reference{sec:installing_firmware} for more information.

\item Disconnect your ipod in the usual way. The bootloader is now installed. 

\end{enumerate}

\subsubsection{Bootloader installation from Mac OS X}

\begin{enumerate}

\item Attach your ipod to your Mac and wait for its icon to appear in 
Finder. If you have configured itunes to open automatically when your
ipod is attached (the default behaviour), then wait for it to open and
then quit it. You also need to ensure the ``Enable use as disk'' option
is enabled for your ipod in itunes.

\item Open up Disk Utility (in Applications $\rightarrow$ Utilities) and click 
on the name of your ipod (e.g. DAVES IPOD) in the list on the left 
pane. Then click on the ``unmount'' icon at the top. \warn{NOTE: DO NOT click 
on the ``eject'' icon.}

\item Download and open ipodpatcher.dmg from 
\download{bootloader/ipod/ipodpatcher/macosx/ipodpatcher.dmg} 
and then double-click on the ipodpatcher icon inside. 

\item If all has gone well, you should see some 
information displayed about your ipod 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 \warn{NOTE: If you received a ``Resource busy'' error from 
ipodpatcher, then this means you didn't complete step 2). Go back to 
Disk Utility, unmount your ipod and then run ipodpatcher again.}

\item Your ipod 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 ipod into disk mode when it 
detects that your ipod is attached to a computer. 

\item Make sure you have a \fname{rockbox.ipod} file and a 
\fname{.rockbox} folder in the 
root of your Ipod's drive and that you have also installed the fonts
package - see \reference{sec:installing_firmware} for more information.

\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've saved it in your home directory.

\item Attach your ipod to your computer.

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

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

\warn{NOTE: You may need to be the root user in order for ipodpatcher to have
sufficient permission to perform raw disk access to your ipod.}

\item If all has gone well, you should see some information displayed about
your ipod 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 Make sure you have a \fname{rockbox.ipod} file and a 
\fname{.rockbox} folder in the 
root of your Ipod's drive and that you have also installed the fonts
package - see \reference{sec:installing_firmware} for more information.

\item Disconnect your ipod in the usual way. The bootloader is now installed. 

\end{enumerate}