1MEDIATOMB(1)                     User commands                    MEDIATOMB(1)
2
3
4

NAME

6       mediatomb - UPnP MediaServer
7

SYNOPSIS

9       mediatomb [-i IP address ] [-e interface ] [-p port ] [-c config file ]
10                 [-d] [-m home dir ] [-f config dir ] [-P PID file ]
11                 [-u user ] [-g group ] [-a path ] [-l logfile ] [-D]
12                 [--compile-info] [--version] [-h]
13

DESCRIPTION

15       This manual page describes the command line parameters for MediaTomb.
16       For a detailed documentation please see the README file which is
17       distributed with MediaTomb or visit http://mediatomb.cc/.
18

OPTIONS

20       -i, --ip
21           The server will bind to the given IP address, currently we can not
22           bind to multiple interfaces so binding to 0.0.0.0 will not be
23           possible.
24
25       -e, --interface
26           The server will bind to the given network interface, currently we
27           can only bind to one interface at a time.
28
29       -p, --port
30           Specify the server port that will be used for the web user
31           interface, for serving media and for UPnP requests, minimum allowed
32           value is 49152. If this option is omitted a default port will be
33           chosen, however, in this case it is possible that the port will
34           change upon server restart.
35
36       -c, --config
37           By default MediaTomb will search for a file named "config.xml" in
38           the ~/.mediatomb directory. This option allows you to specify a
39           config file by the name and location of your choice. The file name
40           must be absolute.
41
42       -d, --daemon
43           Run the server in background, MediaTomb will shutdown on SIGTERM,
44           SIGINT and restart on SIGHUP.
45
46       -m, --home
47           Specify an alternative home directory. By default MediaTomb will
48           try to retrieve the users home directory from the environment, then
49           it will look for a .mediatomb directory in users home. If
50           .mediatomb was found we will try to find the default configuration
51           file (config.xml), if not found we will create both, the .mediatomb
52           directory and the default config file.
53
54           This option is useful in two cases: when the home directory can not
55           be retrieved from the environment (in this case you could also use
56           -c to point MediaTomb to your configuration file or when you want
57           to create a new configuration in a non standard location (for
58           example, when setting up daemon mode). In the latter case you can
59           combine this parameter with the parameter described in Section 5.6,
60           "Config Directory"
61
62       -f, --cfgdir
63           The default configuration directory is combined out of the users
64           home and the default that equals to .mediatomb, this option allows
65           you to override the default directory naming. This is useful when
66           you want to setup the server in a nonstandard location, but want
67           that the default configuration to be written by the server.
68
69       -P, --pidfile
70           Specify a file that will hold the server process ID, the filename
71           must be absolute.
72
73       -u, --user
74           Run MediaTomb under the specified user name, this is especially
75           useful in combination with the daemon mode.
76
77       -g, --group
78           Run MediaTomb under the specified group, this is especially useful
79           in combination with the daemon mode.
80
81       -a, --add
82           Add the specified directory or file name to the database without UI
83           interaction. The path must be absolute, if path is a directory then
84           it will be added recursively. If path is a file, then only the
85           given file will be imported.
86
87       -l, --logfile
88           Do not output log messages to stdout, but redirect everything to a
89           specified file.
90
91       -D, --debug
92           Enable debug log output.
93
94       --compile-info
95           Print the configuration summary (used libraried and enabled
96           features) and exit.
97
98       --version
99           Print version information and exit.
100
101       -h, --help
102           Print a summary about the available command line options.
103

AUTHORS

105       Sergey Bostandzhyan
106
107       Leonhard Wimmer
108

110       Copyright © 2005 Gena Batsyan, Sergey Bostandzhyan
111       Copyright © 2006-2008 Gena Batsyan, Sergey Bostandzhyan, Leonhard
112       Wimmer
113
114       This manual page is part of MediaTomb.
115
116       Permission is granted to copy, distribute and/or modify this document
117       under the terms of the GNU General Public License version 2 as
118       published by the Free Software Foundation.
119
120
121
122
123MediaTomb 0.11.0                  2008-02-23                      MEDIATOMB(1)
Impressum