View source for Mac specific usage

== Description ==

This article is a guideline for Mac-specific issues in [[aMule]]. It should help anyone to use on Mac all the features aMule offers and help setting it up easily and comfortably.

What's more, you might learn some new things about Macs which will be usefull far beyond aMule.

== Right-clicking and pop-up menus ==

aMule contains a lot of features that are only accessible through pop-up menus,
which you invoke by right-clicking a certain item. For instance, if you want to
[[pause]] or [[cancel]] a [[download]], change the [[upload]] or download [[priority]] of a [[file]], see [[Usage_File_Details|file details]], etc, you need to do this via a right-click.

If you haven't bought an additional multi-button mouse with your Mac, you only have one mouse button (the one that corresponds to a left-click or "normal" click on a multi-button mouse). Fortunately, you can emulate the second button by '''holding down the control-key on the keyboard while you click'''. For example, do a "control-click" now on a file that you are downloading and see how a pop-up menu shows up with further option.

If you want to discover all of aMule's hidden functionalities just try to control-click everything that moves. This includes all the lists of files, [[client]]s and [[server]]s, all the labels on the top of these lists (e.g. "File Name"), the bar "all" at the top of the download window, ...

By the way, these emulated right-clicks work system-wide. Just try control-clicking a file in the [[MacOS X|Finder]], an icon in the [[MacOS X|Dock]], a marked word in [[MacOS X|TextEdit]] or [http://office.microsoft.com MS Word].

== Handling ed2k-Links ==

There are basically four ways to download files with aMule:

#[[Search]] for files using aMule's [[Usage_Search|search dialog]] and double click those search results that you want to download.

#Copy [[ed2k link|ed2k-links]] from a web page into the "[[Usage_ED2K_Link_Handler|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.

#Import ed2k-links directly from your browser into aMule. See http://forum.amule.org/thread.php?threadid=5679 for more details.

#Use a text editor (e.g. TextEdit) to paste ed2k-links into a "[[ED2KLinks_file|ED2Links]]" file inside ''~/Library/Application Support/aMule/'' and aMule will automatically import those links.

== Setting up aMule's video preview feature ==

You can use a video player like [http://www.videolan.org VLC] or [http://www.mplayerhq.hu Mplayer] to preview incomplete downloads of video files. To set up aMule properly for this, go to Preferences -> Directories. 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"

For additional information, see [[Usage_Preferences|this article]].