dmapd man page

dmapd — A server that provides DAAP and DPAP shares


dmapd [options]


The dmapd project provides a GObject-based, Open Source implementation of DMAP sharing with the following features:

o Support for both DAAP and DPAP

o Support for realtime transcoding of media formats not natively
supported by clients

o Support for many metadata formats, such as those associated with Ogg
Vorbis and MP3 (e.g., ID3)

o Detection of video streams so that clients may play them as video

o Use of GStreamer to support a wide range of audio and video CODECs

o Caching of photograph thumbnails to avoid regenerating them each time
the server restarts

Dmapd runs on Linux and other POSIX operating systems. It has been used on OpenWrt Linux-based systems with as little as 32MB of memory to serve music, video, and photograph libraries containing thousands of files.


Dmapd supports the following command line options:

-?, --help
Show help options
-f, --foreground
Do not fork; remain in foreground
-n, --name
Name of media shares
-m, --music-dir
Music directory
-p, --picture-dir
Picture directory
-M, --music-format
Acceptable music format
-P, --picture-format
Acceptable picture format
-l, --lockpath
Path to lockfile
-i, --pidpath
Path to PID file
-d, --db-dir
Media database directory
-u, --user
User to run as
-g, --group
Group to run as
-t, --transcode-mime-type
Target MIME type for transcoding
-r, --rt-transcode
Perform transcoding in real-time
-w, --max-thumbnail-width
Maximum thumbnail size (may reduce memory use)
-c, --directory-containers
Serve DMAP containers based on filesystem heirarchy

Dmapd supports the following environment variables:

Enable verbose debugging messages
Path to an alternate configuration file
Directory containing dmapd modules
Name of an alternate AV module
Name of an alternate AV render module; when applicable may also specify a host, e.g.: DMAPD_AV_RENDER_MODULE=gst:host=
Name of an alternate photograph module
Name of an alternate database module

Dmapd can provide content to any client that supports DAAP or DPAP. This includes the following software clients and hardware devices:

o Apple iTunes

o Apple iPhoto

o Rhythmbox

o Roku SoundBridge

Dmapd can read metadata from any music file supported by GStreamer. In order to use this feature you must have the appropriate GStreamer plugins installed. The following plugins are always required if you wish to use this feature:

o app

o decodebin

o typefindfunctions

The following GStreamer plugins are required for the corresponding media types:

o mad (MP3)

o id3demux (MP3)

o ogg (Ogg Vorbis, etc.)

o vorbis (Ogg Vorbis)

o flac (FLAC)

o mpeg2dec (MPEG video)

o theora (Ogg Theora video)


W. Michael Petullo <mike@flyn.org>