As I did never write a howto before, I hope this is good enough to understand :)
I just show the steps I did to make my ipod touch working (sync video/music...) with gtkpod on my Debian testing system as the default packages did not work for me.
Note: This howto uses packages from the unstable section of debian!
Use every package and this howto at you own risk - it worked for me but that doesn't mean it will work for you. Worst case it might destroy your ipod's database.
It may be that I had some packages preinstalled so i forgot to mention them here.
Step 1 (install prerequisites):
apt-get build-dep libgpod gtkpod ifuse
apt-get install git libsqlite3-dev
Step 2 (get and install packages from sid/unstable):
dpkg -i usbmuxd*.deb lib*.deb
Step 3 (get and install ifuse):
Instead of make / make install i used "checkinstall" to generate debian packages.
git clone git://git.sukimashita.com/ifuse.git
Step 4 (get and install libgpod):
git clone git://gtkpod.git.sourceforge.net/gitroot/gtkpod/libgpod
WARNING!! amarok and some other apps use libgpod4. if you use checkinstall as i did, you have to change package name to libgpod4 and remove libgpod-common and libgpod-dev to avoid conflicts during installation.
Step 5 (get and install gtkpod):
git clone git://gtkpod.git.sourceforge.net/gitroot/gtkpod/gtkpod
Step 6 (make mountpoint and make it user-mountable - replace "myuser" with your username):
chown myuser:fuse /media/ipod
usermod -a -G fuse myuser
Step 7 (prepare ipod/iphone):
You have to completely log out (even end kde or gnome) and relogin before being able to mount as user
# (re)plug in your ipod/iphone
# mount ipod/iphone
# get serial info of the device
sudo lsusb -v | grep -i iSerial
-> ea343c78a3c22dec235eca4fc40131c020babc75 (e.g.)
# read ext sysinfo and write file
ipod-read-sysinfo-extended ea343c78a3c22dec235eca4fc40131c020babc75 /media/ipod
You can now run gtkpod and (hopefully) use it!
Remember you always have to run the ifuse mount command before starting gtkpod the first time.
Plase sync your ipod/iphone with itunes on a windows pc before using it with gtkpod.
Amarok (at least v2) does still not work with ipod/iphone after following these steps - if you get it to work, please tell me how ;)
To put your ogg files on the ipod they need to be converted to mp3 - gtkpod does this if you have installed the packages "vorbis-tools" and "lame" (found in debian-multimedia).
If you get an error 6 on ogg to mp3 converting try changing
decoder="oggdec" ; options="--output - --" ;;
decoder="oggdec" ; options="-Q --output - --" ;;
in the file