GitHub - 3050860/soliloque-server: An open source alternative to the Teamspeak server with protocol compatibility.

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 218 Commits
control_packets		control_packets
database		database
tools		tools
COPYING		COPYING
README		README
acknowledge_packet.c		acknowledge_packet.c
acknowledge_packet.h		acknowledge_packet.h
array.c		array.c
array.h		array.h
audio_packet.c		audio_packet.c
audio_packet.h		audio_packet.h
ban.c		ban.c
ban.h		ban.h
channel.c		channel.c
channel.h		channel.h
compat.h		compat.h
configuration.c		configuration.c
configuration.h		configuration.h
connection_packet.c		connection_packet.c
connection_packet.h		connection_packet.h
control_packet.h		control_packet.h
crc.c		crc.c
crc.h		crc.h
database.h		database.h
db_generator.sql		db_generator.sql
db_sample.sql		db_sample.sql
documentation.dox		documentation.dox
gen_db.sh		gen_db.sh
log.c		log.c
log.h		log.h
main_serv.c		main_serv.c
main_serv.h		main_serv.h
packet_sender.c		packet_sender.c
packet_sender.h		packet_sender.h
packet_tools.c		packet_tools.c
packet_tools.h		packet_tools.h
player.c		player.c
player.h		player.h
player_channel_privilege.c		player_channel_privilege.c
player_channel_privilege.h		player_channel_privilege.h
player_stat.c		player_stat.c
player_stat.h		player_stat.h
queue.c		queue.c
queue.h		queue.h
registration.c		registration.c
registration.h		registration.h
server.c		server.c
server.h		server.h
server_privileges.c		server_privileges.c
server_privileges.h		server_privileges.h
server_stat.c		server_stat.c
server_stat.h		server_stat.h
sol-server.cfg		sol-server.cfg
toolbox.c		toolbox.c
waf		waf
wscript		wscript

Repository files navigation

Soliloque Server
================

Welcome to Soliloque Server!


Getting the code
----------------

Check out http://github.com/Youx/soliloque-server for the wiki, bug tracking, etc...
The bleeding edge code can be grabbed from the git repository on github :

	$ git clone git://github.com/Youx/soliloque-server.git

For information about Git, please see http://www.git-scm.com


How to build soliloque server
-----------------------------

To build soliloque server from source, you will need : 
- a C compiler (most likely gcc)
- libconfig (http://www.hyperrealm.com/libconfig/), a library to parse config files
- libdbi (http://libdbi.sf.net), a database abstraction library, and the specific drivers (mysql, sqlite3, ...)

Then run

	$ ./waf configure
	$ ./waf build

You can install it, which isn't really recommended yet...

	$ sudo ./waf install

Or use the binary output/default/soliloque-server


Preparing the database
======================

There are two scripts to prepare a database :

db_generator.sql	: generate the tables
db_sample.sql		: generate a server with some standard values

Those script are compatible with sqlite3, and may work with mysql or postgresql, for example :

	$ sqlite3 file.db3 < db_generator.sql
	$ sqlite3 file.db3 < db_sample.sql

Then edit your sol-server.cfg file accordingly (examples for mysql or sqlite3/sqlite are included)


Known Incompatibilities
-----------------------

Big endian processors (PowerPC, Sparc, ...) are not currently supported, but will be in a close future.

Full protocol support is not achieved yet.

Some problems seem to happen when using sqlite3 v3.5.9 + libdbi v0.8.2, but sqlite3 v3.6.10 + libdbi v0.8.3 works fine.


Hardware Requirements
---------------------

The application compiled takes ~67k or disk with debug flags, and 53-57k without the debug flags,
depending on the optimization level.

Soliloque server hopefully does not leak too much memory, and can run an empty server with ...
~500kBytes of RAM (~350kBytes of those being the database library). Each additional player or
channel takes about 300 Bytes, so it could probably run on an embedded linux device.


Author(s)
---------

Hugo Camboulive (Youx) <hugo.camboulive [AT] gmail.com>


Links
-----

For a documentation of the protocol (not complete yet) :
http://wiki.github.com/Youx/soliloque-server/teamspeak-protocol

To submit bugs, discuss, join the effort, etc etc :
http://github.com/Youx/soliloque-server/issues

The code is hosted and can be forked from here :
http://github.com/Youx/soliloque-server