Scroll to navigation

AMULE(1) aMule AMULE(1)

NAME

amule - the all-platform eMule p2p client

SYNOPSIS

amule [-c <path>] [-geometry <geom>] [-o] [-r] [--configure-autostart <on|off>] [-w <path>] [-d] [-i] [-t <num>] [eD2k-link|collection-file]

amule [-v]

amule [-h]

DESCRIPTION

[ -c <path>, --config-dir=<path> ]
Read config from <path> instead of home
[ -geometry <geom> ]
Sets the geometry of the app. <geom> uses the same format as standard X11 apps: [=][<width>{xX}<height>][{+-}<xoffset>{+-}<yoffset>]
[ -o, --log-stdout ]
Prints log messages to stdout.
[ -r, --reset-config ]
Resets config to default values.
[ --configure-autostart=<on|off> ]
Enable or disable starting aMule on user login, then exit. The OS-specific store is selected automatically: Windows registry Run key, macOS LaunchAgent, Linux XDG .desktop autostart entry.
[ -w <path>, --use-amuleweb=<path> ]
Specify location of amuleweb binary to <path>.
[ -d, --disable-fatal ]
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.
[ -i, --enable-stdin ]
Does not disable stdin.
[ -t, --category=<num> ]
Set category for passed eD2k links to <num>
[ -v, --version ]
Displays the current version number.
[ -h, --help ]
Prints a short usage description.
[ eD2k-link | collection-file ]
Adds an eD2k-link, or every link in an eMule collection file, to the 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/*

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.

SEE ALSO

alc(1), alcc(1), amuled(1), amulecmd(1), amulegui(1), amuleweb(1), cas(1), ed2k(1), wxcas(1)

AUTHOR

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

October 2026 aMule v3.1.0