特殊:Badtitle/NS100:FrostWire

{{#ifexist: :FrostWire/zh | | {{#ifexist: FrostWire/zh | | {{#ifeq: {{#titleparts:FrostWire|1|-1|}} | zh | | }} }} }} {{#ifeq: {{#titleparts:FrostWire|1|-1|}} | zh | | }}

This How-To will explain how to install the free P2P Gnutella client called FrostWire. It is very much a LimeWire clone (it is in fact a descendant of LimeWire). This software is Java based, so you will need Java installed. See the Java How-To for more on that.

This guide is for Ubuntu using the Gnome desktop. Enter code via the terminal (Applications > Accessories > Terminal). Since this guide was first written FrostWire has made available a Debian .deb file which will work with Ubuntu. This makes installation much easier, but the original install method has been left for those who would like a more hands-on approach to install the software.

Installing FrostWire using the Debian .deb file (preferred method)

Download the Debian/Ubuntu installation file from the FrostWire website at [1].

Open a terminal window and if necessary use the cd command to navigate to the directory you placed the .deb file on your computer. For example, if the file is on your Desktop, you would first do: cd ~/Desktop

Use dpkg to install FrostWire on your computer.

sudo dpkg -i FrostWire-4.10.9-2.i586.deb

The file version above was current at the time of this writing. Your downloaded version may be different. Use the file name of the version you downloaded.

Note: Version 4.10.9-1 of Frostwire's Debian/Ubuntu deb contains a file that is improperly formatted. The 4.10.9-2 version no longer has this problem. If, after installing the .deb, you receive the following errors when running frostwire from a terminal:

: command not found:
: No such file or directory
: command not found:
: command not found3:
'unFrost.sh: line 24: syntax error near unexpected token `
'unFrost.sh: line 24: `look_for_java()

you should do the following. You must first install the sysutils package (sudo aptitude install sysutils). Then issue the following command to change the format from dos to unix: sudo dos2unix /usr/lib/frostwire/runFrost.sh

Note: Version 4.10.9-2 of Frostwire's Debian/Ubuntu deb contains a shell script that incompatible with the default installation of Ubuntu. If, after installing the .deb, you receive the following errors when running frostwire from a terminal:

runFrost.sh: 44: Syntax error: "(" unexpected (expecting "}")

You should run the following command:

gksudo gedit /usr/bin/frostwire

or if you're using Kubuntu:

kdesu kate /usr/bin/frostwire

Changing line 3 from:

sh runFrost.sh

To:

bash runFrost.sh

Installing FrostWire using the AnyOS .zip file

First start by getting the zip file for FrostWire by downloading it from the Frost'Wire website at [2].

Open a terminal window and if necessary use the cd command to navigate your way to where you downloaded the zip file on your computer.

Extract the zip file to the /opt directory and change the directory permissions.

sudo unzip -u FrostWire-4.10.3-0-AnyOS.zip -d /opt/

The file version above was current at the time of this writting. Your downloaded version may be different. Use the file name of the version you downloaded.

sudo chown -R root:root /opt/FrostWire/

Now add a shell script to the /usr/bin/ directory. Create the script file using a text editor.

gksudo gedit /usr/bin/runFrostWire.sh

or if you're using Kubuntu:

kdesu kate /usr/bin/runFrostWire.sh

Enter the script code into the text editor that just opened.

cd /opt/FrostWire/
java -jar FrostWire.jar

Save and close the text editor.

Next make the script file executable.

sudo chmod +x /usr/bin/runFrostWire.sh

Now add a menu item to the applications menu. Again use the text editor to write a script.

gksudo gedit /usr/share/applications/FrostWire.desktop

or if you're using Kubuntu:

kdesu kate /usr/share/applications/FrostWire.desktop

Enter the following code in the text editor.

[Desktop Entry]
Name=FrostWire
GenericName=Free P2P Gnutella client
Comment=Search and share all kinds of files on the Gnutella network
Exec=/usr/bin/runFrostWire.sh
Icon=/opt/FrostWire/FrostWire.ico
Terminal=false
Type=Application
Categories=Application;Network;

Save and close the file.

That should be it. Go to your Applications menu and look under Internet. You should see an entry for Frost'Wire. Click on it and fire it up!

Common Problems and Work Arounds

Invalid JRE

If you recieve an error such as this

#
Starting FrostWire...
#
Java exec found in PATH. Verifying...
#
OOPS, you don't seem to have a valid JRE. FrostWire works best with Sun JRE available at http://www.java.com
#
OOPS, unable to locate java exec in  /usr/lib/  hierarchy
#
You need to upgrade to JRE 1.4.x or newer from http://www.java.com
#
ls: /usr/java/j*: No such file or directory
#
OOPS, unable to locate java exec in  /usr/java/  hierarchy
#
You need to upgrade to JRE 1.4.x or newer from http://www.java.com
#
ls: /opt/j*: No such file or directory
#
OOPS, unable to locate java exec in  /opt/  hierarchy
#
You need to upgrade to JRE 1.4.x or newer from http://www.java.com 

Simply type in sudo update-alternatives --config java then select the alternative that includes "sun" in the name. See also UbuntuHelp:Java.

Always "Starting Connection"

Assuming your firewall, router, etc., are all set up properly, then there is a known issue in which a hosts-like file is out of date. Make sure you shut down Frostwire first (i.e. right click the tray icon and select "exit", do not just minimize it). Get http://mc3.electronicbox.net/gnutella.net and save it to ~/.frostwire/gnutella.net. If there is already a gnutella.net file, it is prudent to copy the old one to gnutella.net.old. Frostwire apparently creates its own backups of the file, and you may have to delete gnutella.net~ in order for it to find the new one.

Lock up During Search

A possible fix is to go to Tools -> Options -> Searching -> Basic and uncheck the "Show License Warning" box.

Network Settings

It is beyond the scope of this article to explain port forwarding and UPNP. Use Google, the Forums, or another resource to learn about those things. The relevant Frostwire-specific informations/settings can be found in Tools -> Options -> Advanced -> Firewall Configuration.

External Links

• Official Website
• Frostwire Forums

---