1MEDIATOMB(1) User commands MEDIATOMB(1)
2
6 mediatomb - UPnP MediaServer
7
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 ] [-h]
12
14 This manual page describes the command line parameters for MediaTomb.
15 For a detailed documentation please see the README file which is
16 distributed with MediaTomb or visit http://mediatomb.cc/.
17
19 -i, --ip
20 The server will bind to the given IP address, currently we can not
21 bind to multiple interfaces so binding to 0.0.0.0 will not be
22 possible.
23 -e, --interface
25 The server will bind to the given network interface, currently we
26 can only bind to one interface at a time.
27 -p, --port
29 Specify the server port that will be used for the web user
30 interface, for serving media and for UPnP requests, minimum allowed
31 value is 49152. If this option is omitted a default port will be
32 chosen, however, in this case it is possible that the port will
33 change upon server restart.
34 -c, --config
36 By default MediaTomb will search for a file named "config.xml" in
37 the ~/.mediatomb directory. This option allows you to specify a
38 config file by the name and location of your choice. The file name
39 must be absolute.
40 -d, --daemon
42 Run the server in background, MediaTomb will shutdown on SIGTERM,
43 SIGINT and restart on SIGHUP.
44 -m, --home
46 Specify an alternative home directory. By default MediaTomb will
47 try to retrieve the users home directory from the environment, then
48 it will look for a .mediatomb directory in users home. If
49 .mediatomb was found we will try to find the default configuration
50 file (config.xml), if not found we will create both, the .mediatomb
51 directory and the default config file.
52 This option is useful in two cases: when the home directory can not
54 be retrieved from the environment (in this case you could also use
55 -c to point MediaTomb to your configuration file or when you want
56 to create a new configuration in a non standard location (for
57 example, when setting up daemon mode). In the latter case you can
58 combine this parameter with the parameter described in Section 5.6,
59 "Config Directory"
60 -f, --cfgdir
62 The default configuration directory is combined out of the users
63 home and the default that equals to .mediatomb, this option allows
64 you to override the default directory naming. This is useful when
65 you want to setup the server in a nonstandard location, but want
66 that the default configuration to be written by the server.
67 -P, --pidfile
69 Specify a file that will hold the server process ID, the filename
70 must be absolute.
71 -u, --user
73 Run MediaTomb under the specified user name, this is especially
74 useful in combination with the daemon mode.
75 -g, --group
77 Run MediaTomb under the specified group, this is especially useful
78 in combination with the daemon mode.
79 -a, --add
81 Add the specified directory or file name to the database without UI
82 interaction. The path must be absolute, if path is a directory then
83 it will be added recursively. If path is a file, then only the
84 given file will be imported.
85 -l, --logfile
87 Do not output log messages to stdout, but redirect everything to a
88 specified file.
89 -h, --help
91 Print a summary about the available command line options.
92
94 Sergey Bostandzhyan
95 Leonhard Wimmer
97
99 Copyright © 2005 Gena Batsyan, Sergey Bostandzhyan
100 Copyright © 2006-2008 Gena Batsyan, Sergey Bostandzhyan, Leonhard
101 Wimmer
102 This manual page is part of MediaTomb.
104 Permission is granted to copy, distribute and/or modify this document
106 under the terms of the GNU General Public License version 2 as
107 published by the Free Software Foundation.
108MediaTomb 0.11.0 2008-02-23 MEDIATOMB(1)