---
name: "amule"
section: "1"
platform: "linux"
package: "amule"
version: "1:3.2.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/amule"
---

# amule(1)

the all-platform eMule p2p client

## NAME

amule - the all-platform eMule p2p client

## SYNOPSIS

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

## DESCRIPTION

- **\[ -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 *amule.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 *logfile* 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.

  - 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.

- 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*.

- **\[ -w** *\<path\>*, **--use-amuleweb**=*\<path\>* **\]**

  Specify location of amuleweb binary to *\<path\>*.

- 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\>*

- Displays the current version number.

  - 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

## AUTHOR

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