SourceForge Logo

Go to the SourceForge project home page








Launching HeavyMole

Go to documentation index

Table of contents

A. Launching

UNIX system: if you haven't used a rpm or haven't made a "make install", you then need to cd into the directory where you extracted the package and to type ./heavymole, otherwise you can directly type heavymole, wherever you are.

MS Windows system: use the shortcut on the desktop, the startup menu or go to the installation directory and launch heavymole.exe.

There are few options available to the "heavymole" command:

  • -V, --version: display version number of the release
  • -c, --config <config_file>: force use of config file
  • -q, --quicklogin <user_name>: launch the main window with the specified user
  • -u, --users: list all users that have an account
  • -w, --forcewindow: force the login window to be displayed (useful to bypass the "always use this user" option)
  • -v, --verbose: displays comments about search on config files
  • -h, --help: displays help message

B. User creation

UNIX system: The first time you create a user, the directory $(HOME)/heavymole/data will be created: this is the directory where the user accounts and other user-specific data are stored.

You first need to create a user. When creating a user, you need principally to choose:
  • in the "General" panel: your nickname, the foreground & background colors and the font that will be used in chat and to display your nickname, the language of the interface, and whether or not you are behind a NAT (also known as proxy, gateway...). If so, you will need to configure it.
  • in the "Sharing" panel: the paths to share, which are the list of paths containing files you want to be accessible to the other users.
  • in the "Downloads" panel: the download directory, which is the directory where the files you download will be stored (default is $HOME/heavymole/downloads for UNIX, and C:\Program Files\HeavyMole 0.7.0\downloads for MS Windows).

C. NAT configuration

If you are behind a NAT (ie several computers sharing the internet connection with only one IP address, also known as proxy, gateway...), you will need to configure it so that messages coming from the Internet are followed to your HeavyMole application.

To configure it:

  • Once you have created a user in HeavyMole, go to the "Preferences" window. Make sure you have selected "I'm behind a Nat" in the "General" panel.
  • Still in the "Preferences" window, go to the "Network" panel. Here are written the port number used for this user.
  • You will then need to configure your NAT to transmit packets using these port numbers to your machine. The protocols to be used are:
    • File Transfert port number: TCP
    • Peer-2-Peer port number: UDP
    • Request Transport port number: UDP
    • Chat port number: UDP

D. The stat frame

Once launched, you will find in the bottom right of the window a small frame with:
  • a first light indicating the state of the connections with neighbours. It's red if you don't know any online neighbours. Else it will go from orange to yellow and to green. Green is when you know a lot of online neighbours. It is useless if you launch a query while this light is red.
  • a second light indicating the state of the connections with central servers. It needs to be green to find new neighbours or to connect to or create chat rooms.
  • a color bar indicating the number of queries waiting to be processed (this is only for your information).

You can read these lights as follows:

  • if none of the two lights are red, then everything is ok
  • if the first light is red and the second green, it means you must be the only one connected to the server(s); you can then connect to a chat room or let heavymole run until some new users connect to the network
  • if the first light is not red and the second is red, it means you can't connect to a server, but that you already know some online neighbours; you won't be able to use chat rooms but you still can launch queries, download files and use the explorer
  • if both lights are red, it means you can't connect to a server and that you don't know any online neighbours; you can wait a little bit to see if it evolves.

Note that if you click on this stat frame, it will pass to text mode, with more details. - This page was last updated on November, 5th 2003