Jorg Schuler


Christophe Fergeau


for libgpod 0.7.0

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy of the GNU Free Documentation License from the Free Software Foundation by visiting their Web site or by writing to: Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and those trademarks are made aware to the members of the GNOME Documentation Project, the names have been printed in caps or initial caps.


This manual documents the interfaces of the libgpod library and has some short notes to help get you up to speed with using the library.

Please see the programs in the tests/ directory of the source distribution for some usage examples. A more complete example can be found in the source for Gtkpod. You can also ask questions on the developer's mailing list:

I. iPod database
iPod database reading/writing — Functions to read, write, and create an iPod database
File handling functions — Managing files on the iPod
Time handling — [DEPRECATED] Helper functions to convert between Epoch time and Mac (iPod) time
Low-level functions — Low-level functions which shouldn't be needed in normal situations
iPod database components
Tracks — Data structure to store metadata about an iPod track
Playlists — Data structure to represent an iPod playlist
Smart Playlists — Data structure to represent an iPod smart playlist
Artwork — Data structure to store iPod artwork (album covers)
Chapter Data — Data structure to store chapter data for tracks
Device — Data structure holding information about the iPod (model, mount point, etc.)
II. Photo database
Photo database — Functions to create, read, write the photo database