Web-GMUI

Web-GMUI is a remote web interface for MLdonkey, aMule, rTorrent, Transmission and giFT.

This GUI tries to combine different GUIs for p2p programs in one application/project
to save overall work and to cover many different needs and tastes.

Therefore it's aimed to be easy to modify and to extend.

Note:
Supported platforms so far are Windows, Linux (i386) and MacOSX* (i386).
It's still beta and may crash. No warranty.

Screenshots
Quick Start
Features
Future
FAQ
Contributions
Compiling from Sources
Thanks
Contact
Old homepage (PHP project)

Quick Start

Features:

• Three different web guis.
  • Plex: a server side html gui; feature rich; themes.
  • Clutch: a simple client side gui; based on Javascript/JSON; ported from Transmission.
  • Jay: client side Javascript/JSON; more features; alpha.
• Integrated web server.
• Modular source code.
• UTF-8 support
• Customizability (CSS/JS/HTML/D)
• No installation needed: download&run
• Settings are stored on disk
• SSL cryptography
• HTTP basic authentification
• Languages: english, german, spanish, polish, galician, brazilian portugese, dutch, danish, swedish, french
• Flexible api to cover most network features/designs.
• Preliminary account support.
• Download unfinished files for preview (also remote for MLDonkey)

Beta phase plans:

• bugfixes :P
• login page / authentification forwarding to client
• binaries for PPC/MIPS/ARM/SPARC; Windows64bit; *BSD
• save/restore settings (well, not complete)
• improved html/css design
• improved client support
• complete/more translations
• proper chunk display
• daemon mode

Future plans

• proper multi user support
• a remote window gui (GTK+,QTD)
• a remote console interface (curses?)
• more different web guis/styles/themes
• more supported clients / integrated clients

FAQ:

• Download and uncompress the program packet.
• Start it in your console/or double click on windows
• Open up your browser and go to http://127.0.0.1:8080.
• Click on the "Clients" tab.
• Enter connection settings and click on "Add", then on "Connect".
• Click on the downloads panel etc.

• rTorrent need to be compiled with xml-rpc support (./configure --with-xmlrpc-c)
• Create a file called .rtorrent.rc in your home and put this line into it: "scgi_port = localhost:5000".
• These steps were taken from the rTorrent XMLRPC Guide and Install Guide.

• You can switch between guis manually while you are logged in.
  • http://127.0.0.1:8080/plex
  • http://127.0.0.1:8080/clutch/
  • http://127.0.0.1:8080/jay/
• The default can be set with the Plex Gui => User Settings .

• Download the free GeoIP lite database from maxmind.com
• Put the decompressed file into the Web-GMUI settings directory (e.g. ".webgmui/")
• Restart Web-GMUI. The startup messages will tell you if the file was found.

• On Windows, you need to have OpenSSl libraries installed
• You can download it here.

• in the html gui, go to „User Settings“
• Enable SSL and click on "Apply"
• Change the current URL and change "http" to "https" and press enter.
• You will be prompted to accept the certificate.
• The default is a self signed certificate, so you need to make an exception (e.g. for FireFox)

• IE has a long (not finished) history for non standard compliant browsers.
• I have no time atm. for IE specific workarounds
• Hence, IE6/7 isn't supported atm., IE8 may work in standards mode
• Get Firefox, Opera etc.
• The Clutch GUI does support IE6/7

• Note: this will work only if Web-GMUI and the client have direct access to the clients temp directory
• select a client on the Clients panel
• go to the Client Settings panel and look for the temp directory setting
• set that setting to your clients temp directory
• Web-GMUI will now serve these files from hard disk instead using the gui protocol

• „Module Settings“ => „Core“
• Check the panel items and click „Apply“ to have items loaded/unloaded

• Write out the files in the bianry to disk by invoking Web-GMUI with "--write-out-files".
• [Plex Gui] Add another *.css file along with the others and it will be selecteable.
• More detailed information can be found in the README.txt from SVN.

• Web-GMUI started out as a PHP program (a fork of Zuul)
• The old PHP code is present in SVN, but unmaintained.
• Current Web-GMUI is a complete rewrite in D and does have different aims.
• Multi user capabilities are not useable yet, but will be extended at some point.

• The previous code base was written in PHP.
  But it lacks ways to handle binary data and was slow. Not very elegant. It's no fun.
• I wrote a Demo in Java with servlets.
  The code separation wasn't good and the language was bloated; framework overkill;
  the runtime size was big => not suited for routers
• I wrote a Demo in C/C++; a simple webserver and apache module.
  But it was difficult to code quickly. Error message ofuscation.
  A JSON handler template became a nightmare (~1000 LOC); ~500LOC in readable D
• D is similar in speed and grammar to C/C++;
  nice error messages; cleaner/more powerfull grammar; fast coding; fun.

Contributions

• Submit a bug report.
• Return feedback (e.g. Theme xy made me cry.).
• Add/improve translations.
• Add/improve CSS themes.
• Compile code for different platforms.
• Improve/extend the program code/api design.

Compiling from Sources

• Get the web-gmui sources: svn co http://web-gmui.svn.sourceforge.net/svnroot/web-gmui/trunk web-gmui
• Get and install the D compiler + Tango library, the repository snapshop is recommended
• Make sure you have OpenSSL and libz installed (mentioned in Quick Start).
• Compile the binary in the source directory: make dmd-linux32
• This won't include the webroot folder into the binary (mostly html, css and image files).
  Read the provided README.txt for these extra steps.
• You might want to clear the browser cache.

Thanks:

• #D on freenet and the Tango team for lots of help and good libraries.
• All people who provided Translations. They can be found in the ChangeLog.
• Zuul, for the starting ground.

Contact