amulegui1

Usage

Overview

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:

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

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.