amulegui(1)

NAME

amulegui - aMule control program with GUI

SYNOPSIS

[-c <path>] [-geometry <geom>] [-t <num>] [eD2k-link|collection-file]

DESCRIPTION

amulegui is a client program, and can be connected to amule or amuled via EC. You can manage your amule program with it. It provides almost the same functionalities as amule, even if the core works on another computer.

[ -c <path>, --config-dir=<path> ]: Read config from <path> instead of home

[ --log-file=<file> ]: Write logs to the specified filename instead of the default log file. Overrides the LogFilePath setting under [eMule] in remote.conf for this run only. Relative paths are resolved against the configuration directory. The parent directory must already exist and be writable; it is not created automatically. An empty or absent configuration setting uses remotelogfile in the configuration directory. On startup, the previous log is backed up to the same path with .bak appended. If the backup cannot be created, a warning is logged and the current session is appended to the existing log. Configuration changes take effect after restart.

[ -geometry <geom> ]: Sets the geometry of the app. <geom> uses the same format as standard X11 apps: [=][<width>{xX}<height>][{+-}<xoffset>{+-}<yoffset>]

Prints log messages to stdout.

Resets config to default values.

Skip connection dialog.

Enable or disable starting amulegui on user login, then exit.: The OS-specific store is selected automatically: Windows registry Run key, macOS LaunchAgent, Linux XDG .desktop autostart entry.

Enable or disable aMule as the current user's default handler for ed2k:// and magnet: links, then exit.: <value> is on or off for both kinds of link, or ed2k:on, ed2k:off, magnet:on or magnet:off for one of them. The OS-specific store is selected automatically: Windows registry, macOS LaunchServices, Linux XDG mimeapps.list.

Enable or disable aMule as the current user's handler for .emulecollection files, then exit.: The OS-specific store is selected automatically: Windows registry, macOS LaunchServices, Linux XDG mimeapps.list.

Don't catch fatal exceptions and don't block exit on assertions.: Useful for headless / supervised setups (systemd, watchdog scripts) where the otherwise-modal assertion dialog prevents auto-restart.

Does not disable stdin.

[ -t, --category=<num> ]: Set category for passed eD2k links to <num>

Prints a short usage description.

Displays the current version number.

[ eD2k-link | collection-file ]: Sends an eD2k-link, or every link in an eMule collection file, to the connected core.

The eD2k link to be added can be:

•: a file link (ed2k://|file|...), it will be added to the download queue;

•: a server link (ed2k://|server|...), it will be added to the server list;

•: a serverlist link, in which case all servers in the list will be added to the server list;

•: a magnet link.

Alternatively the argument can be the path to an .emulecollection file, or a file:// URL naming one, in which case every link it contains is added to the download queue. This is what lets a file manager open a collection with aMule.

NOTES

Paths

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

FILES

~/.aMule/remote.conf: Settings, including the core to connect to.

~/.aMule/remotelogfile: The log.

~/.aMule/ED2KLinks: Links passed on the command line, waiting to be sent to the core.

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 General Public License.

AUTHOR

This manpage was written by Julien Delange for Debian <julien AT gunnm DOT org>

This manpage was rewritten by Vollstrecker <[email protected]>