MobileMule 0.9b

MobileMule is a small subproject of eMule, which lets you control your eMule with any java-enabled mobile phone (actually not any, but most). Note that MobileMule is NOT a eMule for your mobile phone, but a remote control for your eMule.
Which mobile phones are supported?
Basically all java enabled mobile phones which have 40 KB free fixed memory and about 150-200KB Heap. A color display is strongly recommended (many older phone types - especially from Nokia - with non color display do not have enough free Heap anyway. Also you need to be able to access the Internet via HTTP. All java-enabled mobile phones should supported this, however it is possible that your contract doesnt allows internet access (prepaid) or that your carrier offers only restricted access. Anyway, the best way to find out is to try it.
Anything else needed?
Yes, your port 80 must be open reachable for incoming connections. So if you have a router or firewall you have to open this port.
Installation
1. Before Installing MobileMule
Before you beginn to install MobileMule make sure you meet all Requirements:
- You have a Java-enabled mobile phone (which is not on the "blacklist")
- You can access the Internet (WAP Gateway or direct Web access)
- Port 80 on your Box is reachable for incomming connection
2. Downloading
Ok, now that you know you could theoretically use MobileMule, it is worth a try to install it ;) Go to the download site and get the most current eMule version. This version is based on the latest official Release, but makes also sure that the MobileMule implementation is the most current one. It is possible that the last eMule release has already the most current MobileMule protocol, in this case you will find a notice about it on the download site. Unpack the Zip-File and replace the your old Exe-File with the new one you just downloaded.
There are two possibilities to download MobileMule: WAP/OTA direct into your mobile phone or saving it on your PC and then transfer it to your handy with a datalink cable. If you have a datalink cable, the second method is recommended, because your Operator will probably charge you for OTA transfer, while the second method doesnt cause any costs. A guide to install MobileMule via WAP can be found on the download site. IF you dont know how to use your datacable, check your phone manual - it is impossible to explain this for all mobile phone types here.
3. Setup
MobileMule needs no further setup. However make sure that your phone settings (WAP, Security) are ok, so that MobileMule can access the internet. In most cases you wont have to change anything.
In eMule you have to activate the MobileMule server. Open the preferences -> Webinterface and click on "MobileMule enabled". Now enter a password, which you will need later to log in. If you use the webserver, make sure it is not assigned to Port 80, or the MobileMule server will not work.
Now you have MobileMule installed, read the rest of the guide to learn more about using MobileMule.
Preferences
You can reach the preferences form the loginscreen. Here is a description of all available options:
Port
With this option you can change the port which MobileMule uses to connect to eMule. You have to choose the same port in the preferences of eMule. Note: Some WAP Gateways do not allow to connections on ports other than 80. If you do not use a WAP gatway there should be no problem with choosing other ports.
Login Method
Here you can select which address format MobileMule should use to find your eMule. If you choose Client ID you have to enter the (high) ID which was assigned to your eMule when it connected to a server, for example "16777343". DynIP or IP lets you choose between your real IP of your PC (for example "212.101.30.14") or the address of a dynamic DNS, which allows you to connect to your eMule even if it changed its IP and you do not know the new IP(only if you installed a dynamic ip programm, please look into the manuals of your favourite dynamic DNS service). An example: "myMule.dyns.net"
Save Password
If you want MobileMule to save your password, enable this option. If you want more security and enter the password everytime you start MobileMule disable it.
Login
ClientID: Enter here the ID which was assigned to your eMule when it connected to a server. LowIDs will not work. Also your ID will change everytime when your IP changes. In future version there will be additional and easier options, which replace the ID (like Dynamic IPs, or an Accountname for an MobileMule account which you can create on this page).
Password: The password you selected in your eMule preferences for MobileMule.
If everthing works, you should now be able to loging, if not you will (probably) get an error message. here are some of the possible errormessages and their meaning:
Unexpected Servererror - MobileMule could not access the internet or it could not find your ID (IP). Make sure you securit settings allow MobileMule to access the internet and that your WAP/Web settings are right.
Wrong opcode received - The responding server was no MobileMule server. If you use a WAP gateway it could also mean that it could not find your ID/IP or that you operator does not allow to access the internet.
Password rejected - Well this should be quite clear :)
Wrong server version - Your eMule version is not compatible to your MobileMule version. Download the latest MobileMule and eMule files and try again
General Servererror - The server (emule) reported an error for some reason. Maybe there is a problem with your WAP Gateway which corrupted the message, but it could have many reasons
Important:
If you have any problems logging in, first try to use the option "Connection test". MobileMule will then try to connect to a server, which is for sure available and will response. If this test succeeds, but you cannot log into your eMule then the problem is located somewhere on your PC. Recheck if you started the MobileMule Server in eMule, if there was no Errormessage in the log and if you have set it to the default port, if you have used the correct ID or IP and if you firewall or router allows/forwards incoming connections on this port.
Status Overview
You can find some basic information about what your eMule does right now here. Everything should be selfexplaining (ok that sounds strange for a HowTo ;) ).
Downloads
On this screen you will see all current downloads and their status. Two red rectangles means this file is paused, a green circle indicates that this file has the waiting state while a filled green circle is a file which is currently receiving data.
You have 4 options here: Cancel, Delete and Pause/Resume should be clear. However be warned: currently there MobileMule will not ask you to confirm your selection if you choose to delete a file. The detail option leads you to the detail screen.
Preview
MobileMule can preview all movie files, which your eMule is currently loading or finished in its current session. Go into the "Finished Files" or "Downloads" screen and select Preview. eMule will try to grab the first frame from the selected movie, resize it to your mobile phones display size and send it.
The preview works with most codecs and video types, but there are some exception were eMule is not able to get a frame. In this case you will see an error message or a complete black image. Also you will only be able to use the preview if your phone has a color display and enough memory to recieve and draw the picture.
Also please keep in mind that the picture has a size of about 5-10KB (depending on the size of your display). This means that it will take a moment until the picture is loaded and it also means that if your operator charges you for transferred volume you should use this option careful.
File Details
This screen contains all information about a file, which you could also find in the eMule download window.
Search
Type the keyword you want to search for into the field (in the prior screen), select a file type and then click start. MobileMule will show you up the 15 results which have the most sources available. The number on the right will you you how many sources this file has. However it has max. 2 digits, meaning if there are more than 99 sources it will show 99.
You have two options here: Detail will show you more details about the selected file like the full name, filesize and how many sources it has and Download will tell eMule to download this file.
Commands
There are currently two commands available here. You can shut down your PC (and turn off power) or shut down eMule. Of course shutting down your PC will result in shutting down eMule too. Another note: Do not expect to be able to connect to your eMule after you used one of those commands ;)
System requirements:
- Java-enabled mobile phone
- Internet connection (WAP Gateway or direct Web access)
- port 80 must be open reachable for incoming connections