Mac specific usage

From AMule Project FAQ
Jump to: navigation, search

English | Français

Description

This article is a guideline for Mac-specific issues in aMule. It should help anyone use all the features aMule has to offer on Macs and help with an easy and comfortable setup.

Right/control-click to activate pop-up menus

Many of aMule's features are only accessible through pop-up menus, e.g. pause or cancel a download change the upload or download priority of a file, see file details, etc.

You activate a pop-up menu either by clicking the right mouse button or, if you have a one-button mouse, by holding down the control key on your keyboard and clicking.

There are no visual cues to where these menus exist, so you need to experiment. You may for example try any list of files, clients and servers, all the labels on the top of these lists (e.g. "File Name") and the bar "all" at the top of the download window.

Setting up firewall access

In addition to properly configuring your router to handle port forwarding, you need to configure the settings of the built-in firewall that comes included with Mac OS X. To do so:
1. Go to Apple Menu > System Preferences.
2. Click on the "Security" Preferences Pane.
3. Click on the "Firewall" tab.
4. Click "New..." on the right side of the tab, which will bring up a drop-down dialogue box.
5. For "Port Name" select "Other"; for "TCP Port Number(s)" enter the same port number as you used in your "Connection" preferences in aMule; for "Description" enter something handy to remember what you did, like "aMule"; click "OK".
6. Returning to the "Firewall" tab, be sure that the port you just created (i.e. "aMule") is checked.

Now you should be good to go. You can see if you have correctly opened the port by testing here .

Handling ed2k-Links

There are basically four ways to download files with aMule:

  1. Search for files using aMule's search dialog and double click those search results that you want to download.
  2. Copy ed2k-links from a web page into the "ED2K-Link Handler" field at the bottom of the search window of aMule and press the commit button. If the ed2k-link is longer than that text field is wide you need to make the aMule window wider until the link fits completely into the field (you can make the aMule window wider than your screen if necessary). We are working on eliminating this issue.
  3. Import ed2k-links directly from your browser into aMule. See http://forum.amule.org/index.php?topic=5679.0 for more details.
  4. Use a text editor (e.g. TextEdit) to paste ed2k-links into a "ED2Links" file inside ~/Library/Application Support/aMule/ and aMule will automatically import those links.
  5. Install More Internet Preference Pane or RCDefaultApp and set it to handle ed2k links with /Applications/aMule.app/Contents/MacOS/ed2kHelperScript.app

Setting up aMule's video preview feature

You can use a video player like VLC or Mplayer to preview incomplete downloads of video files. To set up aMule properly for this, go to Preferences -> General. Under "Video Player", you have to enter "/usr/bin/open -a" together with the path of your video player program.

For example:

/usr/bin/open -a "/Applications/VLC.app"
/usr/bin/open -a "/Applications/vlc-0.8.4a/VLC.app"
/usr/bin/open -a "/Applications/MPlayer OS X 2.0b8r5/MPlayer OS X 2.app"

Or just "/usr/bin/open" to use the default application for the specific file type - as set up in the finder.

For additional information, see this article.