1How to compile/install gtkpod:
2
3(For ubuntu/debian please refer to the end of this file for a quick round-up)
4
51. First, make sure you have compiled and installed the dependencies.
6   Most Linux distros will include them, except maybe for libid3tag
7   (http://sourceforge.net/project/showfiles.php?group_id=12349) and
8   libmp4v2 (http://mpeg4ip.sourceforge.net/).
9
10   Please do not confuse the libid3 library with the libid3tag
11   library -- they are not related. libid3tag is part of the MAD
12   project (http://sourceforge.net/projects/mad/).
13
14   Starting with version 0.96 gtkpod is using the gpod library.
15   libgpod should soon be available as a standard package for major
16   Linux distributions. You can also install the library from source.
17   Download instructions for the tarball or development snapshot can
18   be found at http://www.gtkpod.org/libgpod.html
19
20   The libmp4v2 package is ONLY NEEDED if you need AAC support.  You
21   don't need libmp4v2 if you don't use AAC files. Download's
22   available at
23
24        http://downloads.sourceforge.net/mpeg4ip/
25        (http://downloads.sourceforge.net/mpeg4ip/mpeg4ip-1.6.tar.gz)
26
27   libid3tag was successfully compiled and installed with
28
29       ./configure ; make ; make install
30
31   libmp4v2 was successfully compiled and installed with
32
33       ./bootstrap --disable-server ; make ; make install
34
35
36   The following packages are required for building gtkpod:
37
38        autoconf (at least 2.55)
39        flex (or lex)
40        gettext
41        glib (at least 2.8.0)
42        gtk+ (at least 2.8.0)
43        libglade (at least 2.4.0)
44        libgpod (at least 0.6.1)
45        libid3tag (at least 0.15)
46        perl XML::Parser module
47        pkgconfig
48
49   Optional packages:
50
51        libcurl (for coverart download support)
52        libflac (for FLAC support)
53        libgnome-vfs-2.0 >2.6 (for iPod autodetection under GNOME)
54        libhal >0.5 <0.6 (in combination with libgnome-vfs: better detection of iPods)
55        libvorbis (for ogg libvorbis support)
56        libmp4v2 (for AAC/M4A support)
57
58
592. If you install libraries to /usr/local/lib please don't forget to
60   add the path to LD_LIBRARY_PATH and PKG_CONFIG_PATH
61
62     LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib
63     PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig
64     export LD_LIBRARY_PATH
65     export PKG_CONFIG_PATH
66
67   You can add those lines to your ~/.bashrc or add it globally to
68   /etc/profile.
69
70   If you install packages from your Linux distribution, keep in mind
71   that you will need to install the "-dev" packages as well to be
72   able to compile.
73
74
753. Run the gtkpod 'configure' script to set up the compile
76
77   ./configure
78
79   The standard options to 'configure' apply.  For a list of options:
80
81   ./configure --help
82
83
844. Compile the gtkpod software:
85
86   make
87
88
895. Install the gtkpod software (may require root privileges):
90
91   make install
92
93
94   Note: You can test gtkpod without installing it. Some features
95   (translation catalogues, icons, scripts) may not be available,
96   however:
97
98   src/gtkpod
99
100
101
102----------------------------------------------------------------------
103
104** Note that you do not need to accept the default (usually
105   /usr/local) install path when you compile and install the software.
106   You may choose to install the software in a different location.
107   For example, with libid3tag and libmp4v2 in a non-standard
108   location, outside the $PATH and the usual build environment, you
109   need to configure the build of gtkpod appropriately.  You need to
110   set a CFLAGS variable during the 'configure' that sets the -I and
111   -L flags correctly.
112
113   As a practical example, let's say the libmp4v2 software was
114   installed in $HOME/Applications/mpeg4ip and the libid3tag software
115   was installed in $HOME/Applications/libid3tag, and you want to
116   install gtkpod into $HOME/Applications/gtkpod.  Do this instead:
117
118    CFLAGS="-I$HOME/Applications/mpeg4ip/include -L$HOME/Applications/mpeg4ip/lib -I$HOME/Applications/libid3tag/include -L$HOME/Applications/libid3tag/lib" ./configure --prefix=$HOME/Applications/gtkpod ; make ; make install
119
120------------------------------------------------------------------------
121
122Quick guide for Ubuntu/Debian
123
124The following steps were necessary to install libgpod and gtkpod on a fairly virgin Ubuntu Hardy (LTS 8.04) installation.
125
126# required packages
127sudo apt-get install autoconf flex gettext libglib2.0-dev libgtk2.0-dev libglade2-dev libid3tag0-dev libxml-parser-perl pkg-config automake gcc git-core gtk-doc-tools
128
129# recommended packages
130sudo apt-get install libcurl4-dev libflac-dev libgnomevfs2-dev libhal-dev libvorbis-dev libmp4v2-dev
131
132# checkout libgpod and gtkpod
133git clone git://gtkpod.git.sourceforge.net/gitroot/gtkpod/libgpod
134git clone git://gtkpod.git.sourceforge.net/gitroot/gtkpod/gtkpod
135
136# compile libgpod
137cd libgpod/
138./autogen.sh
139make
140sudo make install
141
142# compile gtkpod
143cd ../gtkpod/
144cd libgpod/
145./autogen.sh
146make
147sudo make install
148
149#start gtkpod
150gtkpod &
151