.\"Modified from man(1) of FreeBSD, the NetBSD mdoc.template, and mdoc.samples.
.\"See Also:
.\"man mdoc.samples for a complete listing of options
.\"man mdoc for the short list of editing options
.\"/usr/share/misc/mdoc.template
.Dd June 17, 2004
.Dt DAAPD 8
.Os POSIX
.Sh NAME
.Nm daapd
.Nd Digital Audio Access Protocol music server
.Sh SYNOPSIS
.Nm
.Op Fl dhqvz
.Op Fl c Ar config-file
.Op Fl C Ar cache-file
.Op Fl n Ar name
.Op Fl p Ar port
.Op Fl s Ar interval
.Op Fl t Ar vbr-limit
.Ar file/directory
.Ar ...
.Sh DESCRIPTION
.Nm
is a music server program for the Digital Audio Access Protocol (DAAP). The server scans 
.Ar file/directory ...
recursively for audio files in various formats and listens on TCP port 3689. An arbitrary number of directories and files (to the length of the command line) can be supplied on the command line.
.Pp
Files are recognizes by content (header, magic numbers etc.) and by file extension. File formats recognized are:
.Pp
.Bl -item -compact
.It 
MPEG 1 Audio Layer 3 (MP3)
.It 
Audio Interchange File Format (AIFF)
.It 
Microsoft Wave (WAV)
.It 
SoundDesigner II (SD2)
.It 
MPEG 4 Audio, AAC encoding (M4A, M4P)
.It 
WinAmp Playlists (M3U, M3U Extended, PLS); see http://www.scvi.net/pls.htm
.El
.Pp
Files in playlists are automatically added. Playlist files may also contain URLs in the format http://<path>.
.Pp
The presence of the server is advertised via the Multicast DNS service discovery protocol (mDNS-SD, part of zeroconf). 
.Nm
relies on the howl mDNS library for this task. For howl to be operational, the howl mDNSResponder has to be running.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl c Ar config-file
Read configuration options from
.Ar config-file .
If this option is not given, the default location of the configuration file is /usr/local/etc/daapd.conf.
.It Fl C Ar cache-file
Save and recover database of audio files to/from
.Ar cache-file .
.It Fl d
Start in daemon mode, detaching from the terminal. Implies 
.Fl q .
.It Fl h 
Print (on the standard output) a description of the command line options.
.It Fl n Ar name
Advertise
.Ar name
as server name.
.It Fl p Ar port
Listen on port
.Ar port .
.It Fl q
Quiet; suppress normal output.
.It Fl s Ar interval
Rescan filesystem every 
.Ar interval 
seconds
.It Fl t Ar vbr-limit
Scan MP3 files for duration:
.Pp
.Bl -tag -compact -width 2c
.It = -1
not at all
.It  = 0
entirely
.It > 0 
first n frames
.El
.It Fl v
Dump verbose debugging info to the standard output.
.It Fl z
Don't compress transmissions.
.El
.Sh BUGS 
The password is stored as plain text in the configuration files. This is an obvious security issue.
.\" .Sh RETURN VALUES \"Sections 2 and .\" .Sh ENVIRONMENT \"Sections 1, 6, 7, and 8
.\" .Sh FILES
.\" .Sh EXAMPLES
.\" .Ev PAGER
.\" .Sh DIAGNOSTICS \"Sections 1, 6, 7, and 8
.\" .Sh ERRORS \"Sections 2 and 3
.\" .Sh SEE ALSO 
.\" .Xr a 1 , 
.\" .Xr b 1 ,
.\" .Sh BUGS 
.\" .Sh HISTORY