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