1dmapd(8)                    System Manager's Manual                   dmapd(8)
2
3
4

NAME

6       dmapd - A server that provides DAAP and DPAP shares
7

SYNOPSIS

9       dmapd [options]
10

OVERVIEW

12       The  dmapd project provides a GObject-based, Open Source implementation
13       of DMAP sharing with the following features:
14
15        o Support for both DAAP and DPAP
16
17        o Support for realtime transcoding of media formats not natively
18        supported by clients
19
20        o Support for many metadata formats, such as those associated with Ogg
21        Vorbis and MP3 (e.g., ID3)
22
23        o Detection of video streams so that clients may play them as video
24
25        o Use of GStreamer to support a wide range of audio and video CODECs
26
27        o Caching of photograph thumbnails to  avoid  regenerating  them  each
28       time
29        the server restarts
30
31
32       Dmapd runs on Linux and other POSIX operating systems. It has been used
33       on OpenWrt Linux-based systems with as little  as  32MB  of  memory  to
34       serve  music,  video,  and photograph libraries containing thousands of
35       files.
36
37

DETAILS

39       Dmapd supports the following command line options:
40
41
42       -?, --help
43              Show help options
44
45       -f, --foreground
46              Do not fork; remain in foreground
47
48       -n, --name
49              Name of media shares
50
51       -m, --music-dir
52              Music directory
53
54       -p, --picture-dir
55              Picture directory
56
57       -M, --music-format
58              Acceptable music format
59
60       -P, --picture-format
61              Acceptable picture format
62
63       -l, --lockpath
64              Path to lockfile
65
66       -i, --pidpath
67              Path to PID file
68
69       -d, --db-dir
70              Media database directory
71
72       -u, --user
73              User to run as
74
75       -g, --group
76              Group to run as
77
78       -t, --transcode-mime-type
79              Target MIME type for transcoding
80
81       -r, --rt-transcode
82              Perform transcoding in real-time
83
84       -w, --max-thumbnail-width
85              Maximum thumbnail size (may reduce memory use)
86
87       -c, --directory-containers
88              Serve DMAP containers based on filesystem heirarchy
89
90       Dmapd supports the following environment variables:
91
92
93       DMAPD_DEBUG
94              Enable verbose debugging messages
95
96       DMAPD_CONFIG_FILE
97              Path to an alternate configuration file
98
99       DMAPD_MODULEDIR
100              Directory containing dmapd modules
101
102       DMAPD_AV_META_READER_MODULE
103              Name of an alternate AV module
104
105       DMAPD_AV_RENDER_MODULE
106              Name of an alternate AV render module; when applicable may  also
107              specify       a       host,      e.g.:      DMAPD_AV_RENDER_MOD‐
108              ULE=gst:host=192.168.0.1
109
110       DMAPD_PHOTO_META_READER_MODULE
111              Name of an alternate photograph module
112
113       DMAPD_DB_MODULE
114              Name of an alternate database module
115
116       Dmapd can provide content to any client that  supports  DAAP  or  DPAP.
117       This includes the following software clients and hardware devices:
118
119
120        o Apple iTunes
121
122        o Apple iPhoto
123
124        o Rhythmbox
125
126        o Roku SoundBridge
127
128
129       Dmapd  can read metadata from any music file supported by GStreamer. In
130       order to use this feature you must have the appropriate GStreamer plug‐
131       ins installed. The following plugins are always required if you wish to
132       use this feature:
133
134
135        o app
136
137        o decodebin
138
139        o typefindfunctions
140
141
142       The following GStreamer plugins  are  required  for  the  corresponding
143       media types:
144
145
146        o mad (MP3)
147
148        o id3demux (MP3)
149
150        o ogg (Ogg Vorbis, etc.)
151
152        o vorbis (Ogg Vorbis)
153
154        o flac (FLAC)
155
156        o mpeg2dec (MPEG video)
157
158        o theora (Ogg Theora video)
159
160

AUTHORS

162       W. Michael Petullo <mike@flyn.org>
163
164
165
166                                                                      dmapd(8)