Difference between revisions of "Mac specific usage"

From AMule Project FAQ
Jump to: navigation, search
 
m (Reverted edits by JohnatanButton (Talk) to last revision by PacoBell)
 
(20 intermediate revisions by 16 users not shown)
Line 1: Line 1:
 +
<center>
 +
'''English''' |
 +
[[Mac_specific_usage-fr|Fran&ccedil;ais]]
 +
</center>
 +
 
== Description ==
 
== 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.
  
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.
+
== Right/control-click to activate pop-up menus ==
  
What's more, you might learn some new things about Macs which will be usefull far beyond aMule.
+
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 [[Usage_File_Details|file details]], etc.
  
== Right-clicking and pop-up menus ==
+
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.
  
aMule contains a lot of features that are only accessible through pop-up menus,
+
There are no visual cues to where these menus exist, so you need to experiment. You may for example try any list of files, [[client]]s and [[server]]s, all the labels on the top of these lists (e.g. "File Name") and the bar "all" at the top of the download window.
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.
+
== 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:<br>
 +
1. Go to Apple Menu > System Preferences.<br>
 +
2. Click on the "Security" Preferences Pane.<br>
 +
3. Click on the "Firewall" tab.<br>
 +
4. Click "New..." on the right side of the tab, which will bring up a drop-down dialogue box.<br>
 +
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".<br>
 +
6. Returning to the "Firewall" tab, be sure that the port you just created (i.e. "aMule") is checked. <br>
  
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, ...
+
Now you should be good to go. You can see if you have correctly opened the port by testing [http://www.amule.org/testport.php here] .<br>
 
+
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 ==
 
== Handling ed2k-Links ==
 
 
There are basically four ways to download files with aMule:
 
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.
+
#[[Search]] for files using aMule's [[Usage_Searches|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.
#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
+
#Import ed2k-links directly from your browser into aMule. See http://forum.amule.org/index.php?topic=5679.0 for more details.
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.
 
#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.
 +
#Install [http://www.monkeyfood.com/software/MoreInternet/ More Internet Preference Pane] or [http://www.rubicode.com/Software/RCDefaultApp/ RCDefaultApp] and set it to handle ed2k links with ''/Applications/aMule.app/Contents/MacOS/ed2kHelperScript.app''
  
 
== Setting up aMule's video preview feature ==
 
== 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 -> General. Under "Video Player", you have to enter "/usr/bin/open -a" together with the path of your video player program.
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:
 
For example:
Line 38: Line 42:
 
  /usr/bin/open -a "/Applications/vlc-0.8.4a/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"
 
  /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 [[Usage_Preferences|this article]].
 
For additional information, see [[Usage_Preferences|this article]].

Latest revision as of 21:18, 29 July 2010

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.