dmapd(8)

✨ dmapd ✨

okay bestie, pull up a chair because we're talking about dmapd — a server that provides DAAP and DPAP shares. yes it's a System Manager's Manual situation, yes it's section 8, and yes it's about to be your new obsession. 💖

---

🌸 SYNOPSIS 🌸

dmapd [options]

that's it. that's the whole vibe. you run it, you hand it options, it serves media. iconic behavior honestly. 💅

---

🦋 OVERVIEW 🦋

so the dmapd project is a GObject-based, Open Source implementation of DMAP sharing, and it comes with the following features, no cap:

• Support for both DAAP and DPAP ✨
• Support for realtime transcoding of media formats not natively supported by clients
• Support for many metadata formats, such as those associated with Ogg Vorbis and MP3 (e.g., ID3)
• Detection of video streams so that clients may play them as video 🎬
• Use of GStreamer to support a wide range of audio and video CODECs
• Caching of photograph thumbnails to avoid regenerating them each time the server restarts 📸

dmapd runs on Linux and other POSIX operating systems. it has literally 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. like… it's giving tiny-but-mighty. 🧚

---

💜 DETAILS 💜

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

---

🌈 Environment Variables 🌈

dmapd also supports the following environment variables, bestie:

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

---

🫶 Clients & Devices 🫶

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

• Apple iTunes
• Apple iPhoto
• Rhythmbox
• Roku SoundBridge

---

🎀 GStreamer Metadata Situation 🎀

dmapd can read metadata from any music file supported by GStreamer. but listen — 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:

• app
• decodebin
• typefindfunctions

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

• mad (MP3)
• id3demux (MP3)
• ogg (Ogg Vorbis, etc.)
• vorbis (Ogg Vorbis)
• flac (FLAC)
• mpeg2dec (MPEG video)
• theora (Ogg Theora video)

ok so real talk: no plugins, no metadata. it's giving "you had one job." go install them. 💀

---

👑 AUTHORS 👑

W. Michael Petullo <mike@flyn.org> — thank you for your service, king. 🫡💖

---

and that's the whole page, bestie! this one came to you from the System Manager's Manual, dmapd(8), and it was serving absolute main character energy the whole time. mwah. 💅✨🎀🦋🌸