FlexHub Beta	- Made by Daywalker, FlipFlop and en_dator


This hubsoft is dedicated to the memory of Daywalker, who died way too young in July of 2009.
We started this project together just to see if we were able to create a hubsoft supporting two different protocols, NMDC and ADC. It looks like it's working...

After keeping it a private version for a long time, it's now finally time to release the first public beta.
It's the hub only, the FlexGui will be released separately, but the hub contains all the commands to customize it fully.

Planned:
- Ptokax Lua API to support Ptokax scripts to run on Flexhub
- Multilingual support

Warning: this is still a beta version and there will be bugs lurking. When you encounter those, please report them on https://bugs.launchpad.net/flexhub with details about how to recreate it if possible.

To report a bug: 				https://bugs.launchpad.net/flexhub
For instructions, check the wiki: 		http://flexhub.org/wiki
For discussions, comments or questions:		http://flexhub.org
For support visit the hub: 			dchub://support.flexhub.org:8000 or adc://support.flexhub.org:8000



THANKS:

Many people have helped out with testing and advice on FlexHub and I owe them a big thank you.
Special thanks to LadyStardust, who's been part of the project since it started and spend a lot of time discussing and testing FlexHub. Without her kicking my ass this project probably would never have been released.

Big thanks to the FlexHub team:
	en_dator			Developer
	LadyStardust		Managing Director of bugtesting and Wiki
	TraN					Bugtester (Linux)
	iLEGALaLIEN		Bugtester (Win)
	MخWЙ	Bugtester (Win)
	oldindian				Bugtester (Win)
	Blackie				Bugtester (Win)
	exleper				Bugtester and Synology Package Builder
	sergius_s 			Bugtester and Russian support

Thanks: Hungarista/Thor for providing a great example to work from with the Ptokax Remote Admin software, Mutor for helping to track and fix some nasty bugs, and ofcourse everyone else who's helped out with tests, advice, and (constructive!) comments: thank you!

I hope you enjoy using this hubsoft, best regards,

FlipFlop




INSTALLATION:

For Windows:	Unzip the zip file to a new folder


For Linux: 	REQUIREMENTS: for GUI only: x11 wxGTK, x11 gtk+ 2.0 or higher, x11 xorg-server
		NOTE: Currently FlexHub doesn't run on x64 systems.

		Unpack the tgz file to a new folder
		To set proper permissions, goto the new FlexHub folder and use: chmod +x lua


FIRST USE:

For Windows:	Run FlexHub.exe

For Linux:	Type: ./lua ./FlexHub.lua from the FlexHub folder to start the hub

For Linux without gui you can use the following commandline options:

	--nogui							To disable the hub Console-GUI (use this when you get: error loading module 'wx')
	--noupdate							To disable the !update command in the hub
	--nochangeports						To disable the commands to add and remove ports inside a running hub
	--norestart							To disable the restart function from inside the hub
	--noshutdown						To disable the shutdown function from inside the hub
	--notouchrestartscript					To tell FlexHub to not touch the RestartScript.sh or RestartScript.bat used to restart the hub (it will still create one if its missing)
	--logdir=./logs/						The directory to store logfiles. For now this needs to be a subfolder in the FlexHub folder
	--configdir=./settings/					The directory to store and load configurationfiles, For now this needs to be a subfolder in the FlexHub folder

	--// The following settings will be saved on first use and do not need to be used on the command line again (unless you want to change them)
	--port=<port1>[,<port2>]				Regular port(s), to use multiple ports, just add them one after another comma separated, no spaces
	--sport=<secure port1>[,<secure port2>]	Secure port(s): EXPERIMENTAL (Can cause the hub to freeze when a secure socket is 'ghosting'.)
	--bind=<ip>						Will bind the port to a specific interface (IP), default = * and will bind to all local interfaces
	--userlimit=<number>					Host userlimit, there's no way to override this value from within the hub, but a lower value can be used in the hub to control max users with !set maxusers <number>

	--// Use these when you want to add a new Hubowner account from the commandline (needed on first run if you use --nogui)
	--nick=<nickname>					Nickname of master account
	--pass=<password>					Password of master account	(always use a unique and safe pass)
	--nickip=<ip>						Only allow connections from this ip for the master account (same as the bindip command in the hub)

Example: ./lua ./FlexHub.lua --nogui --nick=MyNick --pass=12345 --port=8000


IMPORTING ACCOUNTS FROM YNHUB OR PTOKAX (gui only)

First make sure that FlexHub contains the same profilenames as your Ynhub or Ptokax hub.
Click the 'Import accounts' button that opens an import dialogbox.

For Ynhub: Choose Ynhub, click Browse and select the accounts.xml file, then click 'Import accounts'

For Ptokax: Choose Ptokax, click Browse and select the RegisteredUsers.xml file, then click 'Import accounts'. The file Profiles.xml needs to in the same folder as the RegisteredUsers.xml for this to work.



