macOS

This guide covers macOS-specific considerations when using aMule: activating context menus with a single-button mouse, the Navigate menu, configuring the built-in macOS firewall, handling ed2k:// and magnet: links from the browser, and setting up video preview.

Right-Click / Context Menus

Many of aMule's features are only accessible through right-click context menus — for example:

• Pausing or cancelling a download.
• Changing the upload or download priority of a file.
• Viewing file details or client details.

On a modern trackpad or Magic Mouse, a normal secondary-click (two-finger tap, or right side) opens these menus. If you have a single-button mouse without secondary-click enabled, activate them by holding Control on the keyboard and clicking.

There are no visible indicators showing where context menus are available. Experiment by control-clicking on:

• Any list of files, clients, or servers.
• The column header labels at the top of any list (e.g., "File Name", "Size").
• The "All" bar at the top of the download window.

Menu Bar

On macOS aMule adds a Navigate menu to the menu bar. It lists the main windows — Networks, Searches, Downloads, Shared files, Clients, Messages, Statistics and, after a separator, Preferences — each with its ⌥+letter window shortcut (⌥N, ⌥S, ⌥T, ⌥F, ⌥C, ⌥M, ⌥G, ⌥P). Because these are real menu shortcuts, they keep working on every key press and can be reached with VoiceOver. ⌘Q quits aMule.

Setting Up Firewall Access

What actually matters for incoming connections is port forwarding on your router (forward aMule's TCP and UDP ports — default 4662/TCP and 4672/UDP, configured in Preferences → Connection).

The macOS built-in firewall is off by default, and when enabled it works per application, not per port — there is no place to type a port number. If you have turned it on, allow the aMule application through it:

1. Open System Settings → Network → Firewall (on macOS 12 and earlier: System Preferences → Security & Privacy → Firewall).
2. Click Options….
3. Add aMule.app to the list and set it to Allow incoming connections.

You can verify the ports are reachable as described in Testing your port status.

Handling eD2k and Magnet Links

aMule.app and aMuleGUI.app can be registered as the handler for ed2k:// and eD2k-compatible magnet: links and for .emulecollection files, so clicking a link in any browser, or double-clicking a collection in the Finder, queues it in aMule. Register aMule.app in the first-run wizard, or either app in Preferences → General. macOS cannot remove a default handler: once aMule is the handler, the Preferences checkbox is hidden, and you hand the scheme back by making another application the default.

Without registering aMule, you can still paste links into the Fast eD2k Links Handler field at the bottom of the Searches window, write them to ~/Library/Application Support/aMule/ED2KLinks, or use the bundled ed2k tool (/Applications/aMule.app/Contents/MacOS/ed2k). See eD2k and Magnet Links for every method and the accepted link formats.

Setting Up Video Preview

With no video player configured (the default), completed files already open with their default application. To preview incomplete downloads you need a media player like VLC or IINA, because an unfinished .part file has no type macOS can open on its own. To configure one, use an open-based command:

1. Open Preferences → General.
2. Under Video Player, enter the path to open your player with the /usr/bin/open -a command:

Player	Video Player field value
VLC	/usr/bin/open -a "/Applications/VLC.app"
IINA	/usr/bin/open -a "/Applications/IINA.app"

The command also supports the %PARTFILE and %PARTNAME placeholders, which aMule replaces with the full path and the file name of the file being previewed; if neither is present, the file path is appended to the command.