gmediaserver(1)

1GMEDIASERVER(1)             General Commands Manual            GMEDIASERVER(1)
2
3
4

NAME

6       GMediaServer - A UPnP compatible media server
7

SYNOPSIS

9       gmediaserver [OPTIONS]... DIRECTORIES...
10

DESCRIPTION

12       Run the UPnP compatible media server. The directories arguments specify
13       where audio files are located.
14
15       GMediaServer is a UPnP music media server.  It  implements  the  server
16       component  that  provides UPnP media devices with information on avail‐
17       able audio files. GMediaServer uses the built-in http server of libupnp
18       to stream the audio files to clients.
19
20       When  the main process receives the USR1 signal, all directories speci‐
21       fied on the command line will be rescanned. This functionality is  cur‐
22       rently  quite  crude  in that all files are rescanned even if they were
23       not changed.
24

OPTIONS

26       This program follow the  usual  GNU  command  line  syntax,  with  long
27       options starting with two dashes (`-').
28
29       --friendly-name=NAME
30              Set display name for media server.
31
32       --disable-tags
33              Do not scan files for tags.
34
35       --fs-charset=CHARSET
36              Specify  character  set  used  in file names. If the environment
37              variable `G_BROKEN_FILENAMES' (1) is set, this  is  if  possible
38              identified  automaticly  from  the  current  locale (usually the
39              environment variable `LC_CTYPE' affects this).  Otherwise  UTF-8
40              is assumed. Use this option to specify character set manually.
41
42              Run  `iconv  --list'  for  a list of accepted character encoding
43              names.
44
45       --device-charset=CHARSET
46              Specify character set used in the data  passed  to  the  control
47              point  (the  player device). If this option is not specified, no
48              translation will occur.
49
50              Run `iconv --list' for a list of accepted character encoding set
51              names.
52
53       --log-charset=CHARSET
54              Specify  character  set used in messages printed to standard out
55              and to the log file (if applicable). If this option is not spec‐
56              ified, it is if possible identified automaticly from the current
57              locale.
58
59       -v, --verbose[=LEVEL]
60              Set verbosity level (0-4).
61
62       --pid-file=FILE
63              Write pid to FILE when up and running.
64
65       -i, --interface=NAME
66              Listen on a specific interface. NAME can be either an IP address
67              (IPv4) or the name of a network device.
68
69       -p, --port=PORT
70              Listen on a specific port.
71
72       -o, --output=LOGFILE
73              File for logging.
74
75       -b, --background
76              Go to background (detach).
77
78       --no-timestamp
79              Do  not  prepend  timestamp to log entries.  See strftime(3) for
80              description of the timestamp format.
81
82       --timestamp[=FORMAT]
83              Prepend timestamp with optional time format.
84
85       --profile=NAME
86              Specify which profile to use.  Profiles  control  what  settings
87              are enabled for a certain control point (the player device). See
88              PROFILES below for a list of valid  values  for  --profile.  The
89              default is "generic".
90
91       --expire-time=SECONDS
92              Set  UPnP  advertisement  expire time. This may be necessary for
93              some devices.  The default is 100 seconds.
94
95       --file-types=TYPE[,..]
96              Specify which types of files are accepted by the control  point.
97              The  argument  is a comma separated list of accepted types. File
98              types are identified by contents and not  file  name  (i.e.  the
99              extension).   See FILE TYPES below for a list of valid types for
100              --file-types.  The default is "mp3,wma,m3u,pls".
101
102       --help Display this help and exit.
103
104       --version
105              Output version information and exit.
106

PROFILES

108       The following values are valid for --profile:
109
110       mp101  Netgear MP101. Implies --file-types=mp3,wma,m3u,pls.
111
112       dms1   Omnify     DMS1.     Implies      --expire-time=600      --file-
113              types=mp3,wma,m3u,pls.
114
115       generic
116              All other devices. Implies no custom settings.
117

FILE TYPES

119       The following types can be specified for --file-types:
120
121       mp3    The  regular MP3 files, or to be more specific `MPEG ADTS, layer
122              III, v1'. At the moment this does also include MP3 files  begin‐
123              ning with an ID3 tag.
124
125       wma    `Windows Media Audio' data encapsulated in Microsoft ASF files.
126
127       wav    Wave sound data encapsulated in RIFF files.
128
129       m4a    `iTunes AAC-LC' data encapsulated in an ISO Media MPEG v4 system
130              file.
131
132       ogg    Vorbis audio data encapsulated in an Ogg file.
133
134       pls    A playlist format used by Winamp and other programs.
135
136       m3u    Simple and extended M3U playlists used by Winamp and other  pro‐
137              grams.  Extended M3U playlists start with `#EXTM3U'.
138
139       unknown
140              Unidentified  files  (all  other).  Normally these files are not
141              served, but when unknown is included in the file types list they
142              will be.
143

REPORTING BUGS

145       Report bugs to <oskar@osk.mine.nu>.
146

AUTHOR

148       GMediaServer was written by Oskar Liljeblad <oskar@osk.mine.nu>.
149

COPYRIGHT

154       Copyright © 2005, 2006 Oskar Liljeblad
155
156       This is free software; see the source for copying conditions.  There is
157       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
158       PURPOSE.
159
160
161
162                               February 10, 2006               GMEDIASERVER(1)