Remote.conf file - Revision history

Reorder: /* Example */

2012-06-20T11:04:45Z

‎Example

Vollstrecker: Removed Version Tag

2008-06-29T09:22:15Z

Removed Version Tag

83.38.117.24: /* Keys specific to Remote GUI */ rv

2008-02-16T01:17:55Z

‎Keys specific to Remote GUI: rv

Vollstrecker: Adjusted Links, Added Version-Tag

2008-01-23T13:50:09Z

Adjusted Links, Added Version-Tag

Felipe1982: /* Keys specific to Remote GUI */

2007-12-18T16:00:27Z

‎Keys specific to Remote GUI

Colin: =Description=

2006-12-17T16:23:53Z

=Description=

Jacobo221 at 19:24, 27 August 2005

2005-08-27T19:24:32Z

GonoszTopi at 16:12, 27 August 2005

2005-08-27T16:12:31Z

New page

== File ==

'''Name:''' ''remote.conf''

'''Location:''' ''~/.aMule/''

== Description ==

This is the common configuration file for all remote tools ([[aMuleCMD]], [[aMuleWeb]], [[aMuleGUI|remote gui]]). The above mentioned name and location is the default name and location for this file, but, unlike all other config files, they can be changed via the ''-f'' (''--config-file'') command-line parameter.

'''Note''': Whenever I refer to command-line switches and parameters, they're only available for aMuleCmd and aMuleWeb. aMule remote GUI does not yet implement these switches.

== Format ==

This is a text file, in the format of the [http://www.microsoft.com/windows Windows] .INI files.

In the file, configuration options are set in key-value pairs. Each line contains exactly one key-value pair, in the form of <''key''>=<''value''> (except for group headers and comments, see below). Keys are organized into groups, and even groups may have sub-groups. Any line starting with a ';' (semicolon) character is considered to be a comment. Comments and empty lines are ignored. Group headers are in the form '['<''group name''>']'.

Keys are referenced as if they were files in a file system where directories are the groups. For example, the key '' 'Password' '' in the group '' 'EC' '' is referenced as '' '/EC/Password' ''. Hopefully the following descriptions and the example will make it clear.

== Keys description ==

=== General notes ===

*For keys that accept an [http://en.wikipedia.org/wiki/MD5 MD5] hash, the value is always case insensitive.
*For keys that enable/disable something (or at least have a boolean type value), '0' means 'false' or 'disabled', '1' means 'true' or 'enabled'.

=== Common keys ===

; '''/Locale''' : Selects language that remote tools should use. Possible values are the language codes for the given language, such as ''de'', ''en_GB''; or the proper english name of the language, e.g. ''french''. Defaults to an empty value, which means '' 'use system default language' ''. Can be overridden by the ''-l'' (''--locale'') command-line parameter.

; '''/EC/Host''' : Hostname or IP address of the remote running core ([[aMule]] or [[aMuled]]). Defaults to '' 'localhost' ''. Can be overridden by the ''-h'' (''--host'') command-line parameter.

; '''/EC/Port''' : Port number where remote core listens to external connections. Defaults to '' '4712' ''. Can be overridden by the ''-p'' (''--port'') command-line parameter.

; '''/EC/Password''' : MD5 hash of the password used for EC connection. Can be overridden by the ''-P'' (''--password'') command-line parameter, which accepts a plain-text password!

=== Keys specific to aMuleCmd ===

None.

=== Keys specific to aMuleWeb ===

; '''/Webserver/Port''' : Port number, where aMuleWeb listens for connections from browsers. Defaults to '' '-1' '', which means '' 'query from remote core' ''. If query fails for some reason, '' '4711' '' will be used, but aMuleWeb will most likely be unusable (if such a simple query fails, what to expect from more complex queries?). Can be overridden by the ''-s'' (''--server-port'') command-line parameter.

; '''/Webserver/Template''' : Name of the web template to use. Defaults to '' 'default' ''. The current version of aMuleWeb installs one another template, named '' 'chicane' ''. Can be overridden by the ''-t'' (''--template'') command-line parameter.

; '''/Webserver/UseGzip''' : Enables or disables [http://www.gzip.org/ gzip] compression of [http://www.w3.org/MarkUp/ HTML] pages. Defaults to disabled. Can be overridden by the ''-z'' (''--enable-gzip'') or ''-Z'' (''--disable-gzip'') command-line switches.

; '''/Webserver/AllowGuest''' : Enables or disables guest mode logins to the web interface. Defaults to disabled. Can be overridden by the ''-a'' (''--allow-guest'') or ''-d'' (''--deny--guest'') command-line switches.

; '''/Webserver/AdminPassword''' : MD5 password for admin login. Can be overridden by the ''-A'' (''--admin-pass'') command-line parameter, which accepts a plain-text password!

; '''/Webserver/GuestPassword''' : MD5 password for guest login. Makes sense only when guest login is enabled. Can be overridden by the ''-G'' (''--guest-pass'') command-line parameter, which accepts a plain-text password!

; '''/Webserver/PageRefreshTime''' : Time interval in seconds between page reloads. '' '0' '' means '' 'page refresh disabled' ''. Defaults to '' '120' '', i.e. 2 minutes.

; '''/Webserver/GraphHeight''' : Height (in pixels) of the statistics graphs. Default is '' '149' ''.

; '''/Webserver/GraphWidth''' : Width (in pixels) of the statistics graphs. Default is '' '500' ''.

; '''/Webserver/GraphScale''' : Scaling of the statistics graphs. This means '' 'each pixel in the graph represents '' 'x' '' seconds' ''. Default is 3 seconds/pixel.

=== Keys specific to Remote GUI ===

Remote GUI currently messes up remote.conf, saves a lot of irrelevant keys and does not save some important ones. When this will be fixed, I'll describe its keys too.

== Example ==

The example below shows a default remote.conf file, with the exception of the EC password, which is set to dummy (but valid) value.

Locale=
[EC]
Host=localhost
Port=4712
Password=5D41402ABC4B2A76B9719D911017C592
[Webserver]
Port=-1
Template=default
UseGzip=0
AllowGuest=0
AdminPassword=
GuestPassword=
PageRefreshTime=120
GraphHeight=149
GraphWidth=500
GraphScale=3

← Older revision		Revision as of 11:04, 20 June 2012
Line 76:		Line 76:
	GraphWidth=500		GraphWidth=500
	GraphScale=3		GraphScale=3
		+
		+
		+
		+	[[Category:Program Files]]

← Older revision		Revision as of 09:22, 29 June 2008
Line 76:		Line 76:
	GraphWidth=500		GraphWidth=500
	GraphScale=3		GraphScale=3
−
−	~~== Version ==~~
−	~~Created by GonoszTopi on 27.08.05 at 18:12<br>~~
−	~~Updated by Vollstrecker on 23.01.08 at 14:50~~

@@ Line 9: / Line 9: @@
 This is the common configuration [[aMule_files|file]] for all remote tools ([[aMuleCMD]], [[aMuleWeb]], [[aMuleGUI|remote gui]]). The above mentioned name and location is the default name and location for this file, but, unlike all other config files, they can be changed via the ''-f'' (''--config-file'') command-line parameter.
-'''Note''': Whenever I refer to command-line switches and parameters, they're only available for aMuleCmd and aMuleWeb. aMule remote GUI does not yet implement these switches.
+'''Note''': command-line switches and parameters apply only to aMuleCmd and aMuleWeb. aMule remote GUI does not yet implement them.
 == Format ==

@@ Line 56: / Line 56: @@
 === Keys specific to Remote GUI ===
 Remote GUI currently messes up remote.conf, saves a lot of irrelevant keys and does not save some important ones. When this will be fixed, I'll describe its keys too.<br/>
 == Example ==

@@ Line 1: / Line 1: @@
 == File ==
 '''Name:''' ''remote.conf''
@@ Line 6: / Line 5: @@
 == Description ==
 This is the common configuration [[aMule_files|file]] for all remote tools ([[aMuleCMD]], [[aMuleWeb]], [[aMuleGUI|remote gui]]). The above mentioned name and location is the default name and location for this file, but, unlike all other config files, they can be changed via the ''-f'' (''--config-file'') command-line parameter.
@@ Line 12: / Line 10: @@
 == Format ==
 This is a text file, in the format of the [http://www.microsoft.com/windows Windows] .INI files.
@@ Line 20: / Line 17: @@
 == Keys description ==
 === General notes ===
 *For keys that accept an [http://en.wikipedia.org/wiki/MD5 MD5] [[hash]], the value is always case insensitive.
 *For keys that enable/disable something (or at least have a boolean type value), '0' means 'false' or 'disabled', '1' means 'true' or 'enabled'.
 === Common keys ===
 ; '''/Locale''' : Selects language that remote tools should use. Possible values are the language codes for the given language, such as ''de'', ''en_GB''; or the proper english name of the language, e.g. ''french''. Defaults to an empty value, which means '' 'use system default language' ''. Can be overridden by the ''-l'' (''--locale'') command-line parameter.
-; '''/EC/Host''' : Hostname or [[IP]] address of the remote running core ([[aMule]] or [[aMuled]]). Defaults to '' 'localhost' ''. Can be overridden by the ''-h'' (''--host'') command-line parameter.
+; '''/EC/Host''' : Hostname or [[IP address|IP]] address of the remote running core ([[aMule]] or [[aMuled]]). Defaults to '' 'localhost' ''. Can be overridden by the ''-h'' (''--host'') command-line parameter.
 ; '''/EC/Port''' : [[Port]] number where remote core listens to [[External Connections]] (EC). Defaults to '' '4712' ''. Can be overridden by the ''-p'' (''--port'') command-line parameter.
@@ Line 37: / Line 31: @@
 === Keys specific to aMuleCmd ===
 None.
 === Keys specific to aMuleWeb ===
 ; '''/Webserver/Port''' : Port number, where aMuleWeb listens for connections from browsers. Defaults to '' '-1' '', which means '' 'query from remote core' ''. If query fails for some reason, '' '4711' '' will be used, but aMuleWeb will most likely be unusable (if such a simple query fails, what to expect from more complex queries?). Can be overridden by the ''-s'' (''--server-port'') command-line parameter.
@@ Line 63: / Line 55: @@
 === Keys specific to Remote GUI ===
 Remote GUI currently messes up remote.conf, saves a lot of irrelevant keys and does not save some important ones. When this will be fixed, I'll describe its keys too.<br/>
 '''Is this still true? --[[User:Felipe1982|Felipe1982]]'''
 == Example ==
 The example below shows a default ''remote.conf'' file, with the exception of the EC password, which is set to dummy (but valid) value.
@@ Line 87: / Line 77: @@
   GraphWidth=500
   GraphScale=3