Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AMULEWEB(1)			 aMule utilities		     AMULEWEB(1)

NAME
     amuleweb - aMule web server

SYNOPSIS
     amuleweb  [-h <host>] [-p <port>] [-P <password>] [-f <path>] [-q] [-v] [-l
     <lang>] [-w] [-t <name>] [-s <port>] [-u] [-U <port>] [-z] [-Z] [-A  <pass-
     word>] [-G <password>] [-a | -d] [-L] [--no-php] [-N]

     amuleweb [--create-config-from=<path>]

     amuleweb [--help]

     amuleweb [--version]

     amuleweb [--amule-config-file=<path>]

DESCRIPTION
     amuleweb manages your access to amule through a web browser.  You can start
     amuleweb  together  with  amule(1), or separately, any time later.  Options
     can be specified via command-line or via config-file.  Command-line options
     take precedence over config-file options.

     [ -h <host>, --host=<host> ]
	    Host where aMule is running (default: 127.0.0.1).  <host>  might  be
	    an IP address or a DNS name

     [ -p <port>, --port=<port> ]
	    aMule's port for External Connections, as set in Preferences->Remote
	    Controls (default: 4712)

     [ -P <password>, --password=<password> ]
	    External Connections password.

     [ -f <path>, --config-file=<path> ]
	    Use  the  given  configuration  file.  Default configuration file is
	    ~/.aMule/remote.conf

     [ -q, --quiet ]
	    Do not print any output to stdout.

     [ -v, --verbose ]
	    Be verbose - show also debug messages.

     [ -l <lang>, --locale=<lang> ]
	    Sets program locale (language).  See the NOTES section for	the  de-
	    scription of the <lang> parameter.

     [ -w, --write-config ]
	    Write command line options to config file and exit

     [ -t <name>, --template=<name> ]
	    Loads  the	template  named <name>. See the SKIN SUPPORT section for
	    details.

     [ -s <port>, --server-port=<port> ]
	    Webserver's HTTP port. This is the port you must point your  browser
	    to (default: 4711).

     [ -u ]
	    Enable UPnP.

     [ -U <port>, --upnp-port=<port> ]
	    UPnP port.

     [ -z, --enable-gzip ]
	    Enables using gzip compression in HTTP traffic to save bandwidth.

     [ -Z, --disable-gzip ]
	    Disables using gzip compression (this is the default).

     [ -A <passwd>, --admin-pass=<passwd> ]
	    Full access password for webserver.

     [ -G <passwd>, --guest-pass=<passwd> ]
	    Guest password for webserver.

     [ -a, --allow-guest ]
	    Allows guest access.

     [ -d, --deny-guest ]
	    Denies guest access (default).

     [ -L, --load-settings ]
	    Load/save  webserver  settings  from/to  remote  aMule.  This causes
	    amuleweb to ignore command-line and config-file settings,  and  load
	    them  from	aMule.	 When saving preferences none will be written to
	    the config file, but to aMule.  (Of  course,  this	works  only  for
	    those  settings  that can be set in aMule's Preferences->Remote Con-
	    trols.)

     [ --no-php ]
	    Disable PHP interpreter (deprecated)

     [ -N, --no-script-cache ]
	    Recompiles PHP pages on each request.

     [ --create-config-from=<path> ]
	    Create config file based upon <path>, which must point  to	a  valid
	    aMule config file, and then exit.

     [ --force-zlib ]
	    Force ZLIB compression on the External Connection link regardless of
	    the  dialed-IP  locality.	Useful when the server side is reachable
	    over a VPN tunnel that resolves to a LAN IP and the heuristic  would
	    otherwise skip compression.

     [ --help ]
	    Prints a short usage description.

     [ --version ]
	    Displays the current version number.

     [ --amule-config-file=<path> ]
	    aMule  config  file path.  DO NOT USE DIRECTLY!  aMule uses this op-
	    tion when starting amuleweb at aMule startup.   This  option  causes
	    all other command-line and config-file settings to be ignored, pref-
	    erences  to be read from the given config file, and also implies the
	    -q -L options.

NOTES
   Paths
     For all options which take a <path> value, if the path contains  no  direc-
     tory  part  (i.e. just a plain filename), then it is considered to be under
     the aMule configuration directory, ~/.aMule.

   Languages
     The  <lang>  parameter  for  the  -l  option  has	 the   following   form:
     lang[_LANG][.encoding][@modifier]	where lang is the primary language, LANG
     is a sublanguage/territory, encoding is the character set to use and  modi-
     fier  allows  the	user  to select a specific instance of localization data
     within a single category.

     For example, the following strings are valid:
	    de
	    de_DE
	    de_DE.iso88591
	    de_DE@euro
	    de_DE.iso88591@euro

     Though all the above strings are accepted as  valid  language  definitions,
     encoding and modifier are yet unused.

     In  addition  to the format above, you can also specify full language names
     in English - so -l german is also valid and is equal to -l de_DE.

     When no locale is defined, either on command-line or in config file, system
     default language will be used.

SKIN SUPPORT
     amuleweb is capable of displaying information in  different  skins.   These
     skins  are called templates, and you can make amuleweb load a specific tem-
     plate via the -t command  line  option.   Templates  are  searched  in  two
     places:  first  in  ~/.aMule/webserver/  and  then in /usr/share/amule/web-
     server/ if you installed with --prefix=/usr.

     Each template must be in a subdirectory of the template name, and this  di-
     rectory must contain all files the template needs.

FILES
     ~/.aMule/remote.conf
     ~/.aMule/webserver/
     $(pkgdatadir)/webserver/

EXAMPLE
     Typically amuleweb will be first run as:

     amuleweb  -h  hostname -p ECport -P ECpassword -s HTTPport -A AdminPassword
     -w

     or

     amuleweb --create-config-from=/home/username/.aMule/amule.conf

     These will save settings to $HOME/.aMule/remote.conf, and	later  you  only
     need to type:

     amuleweb

     Of  course,  you  may specify any more or less options on the first example
     line, and you may also totally omit it.

REPORTING BUGS
     Please  report  bugs  either  on	our   forum   (https://github.com/amule-
     org/amule/discussions),  or  in  our  bugtracker (https://github.com/amule-
     org/amule/issues).  Please do not report bugs in  e-mail,	neither  to  our
     mailing list nor directly to any team member.

COPYRIGHT
     aMule  and  all of its related utilities are distributed under the GNU Gen-
     eral Public License.

SEE ALSO
     amule(1), amulecmd(1)

AUTHOR
     This manpage was written by Vollstrecker <amule@vollstreckernet.de>

aMule webserver v3.0.1		   August 2026			     AMULEWEB(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=amuleweb&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help