What is it?

TS3VIDEO is very simple. It doesn’t blow your mind with a full set of new features to communicate with your friends. It just adds video to the already existing audio, text-chat and file-sharing TeamSpeak experience.


After downloading the plugin, it can simply be installed with a double click on the *.ts3_plugin file. This will start the TeamSpeak plugin installer.

It’s highly recommended to close TeamSpeak before trying to install or update the plugin.

TeamSpeak 3 plugin installer

How to start a video conference

In short: Right-click any channel in TeamSpeak and choose the Video-option.

TODO: Add long description with screenshot.



The server package is usually a ZIP/TAR archive, which can be extracted everywhere.

Windows (ZIP archive)

Download and extract to e.g.: C:\ts3video

Linux (TAR archive)

mkdir /opt/ts3video
cd /opt/ts3video
tar -xf ts3video-server.tar


The server can be configured in multiple ways. Currently it’s possible to use command line parameters or a simple configuration file.

Command line parameters

Parameter Description Example value
--config Absolute path to configuration file. /opt/ts3video/default.ini
--service This parameter is required when started as a Windows Service.

TODO: Document all possible parameters.

Saving the configuration in a file might be the better way to backup the configuration. See the comments inside the config file for further details.

Beta note: It’s not possible to run more than one virtual video server. Support for multiple virtual servers will be implemented in the next releases.

# Default values for each server configuration.
# Special IP address values:
#   Any IPv4   =
#   Any IPv6   = ::
#   Any IPv4&6 = any

# The IP address on which to listen for new connections.
# @version 0.1

# The port for new connections and media data (TCP & UDP).
# @version 0.1

# The IP address on which to listen for new web-socket (status) connections.
# It's recommended to allow only local access. You may allow restricted access via ProxyPass (Apache).
# @version 0.1

# The port for new web-socket (status) connections.
# @version 0.1

# Maximum number of parallel client connections (slots).
# @version 0.1

# Maximum READ transfer rate the server is allowed to use (bytes/second).
# @version 0.1

# Maximum WRITE transfer rate the server is allowed to use (bytes/second).
# @version 0.1

# Comma separated list of valid channel-IDs, which are allowed to be used.
# This property maintains a list of raw channel IDs - not TS3 channel IDs.
# Leave empty to allow all.
# @todo Add "macro" to create raw-ids from TS3-Channel-ID.
# @version 0.1

# Password to server.
# Leave empty to allow access to everyone.
# @version 0.1

# Virtual server's administrator password.
# @version 0.3

# Bridge to TeamSpeak via it's Query-Console.
# The bridge requires a user with the following permissions:
# - b_serverquery_login
# - b_virtualserver_select
# - b_virtualserver_client_list
# - i_channel_subscribe_power
# - i_channel_needed_subscribe_power
# @version 0.4
# Enables the bridge to TeamSpeak.
# @version 0.4

# Address of the TeamSpeak server.
# It usually runs on the same host (
# @version 0.4

# The port of the TeamSpeak server query-console.
# @version 0.4

# Login information for the query-console.
# @version 0.4

# The connection will change the visible nickname of the query-console user.
# NOTE: Do not use yet! Leave it empty for now! Or at least not more than 10 characters!
# @version 0.4

# Port of the virtual server used for authorization.
# @version 0.4

# Comma separated list of server group IDs (sgid),
# which are allowed to use the video server.
# Leave empty to allow all groups.
# @version 0.4

The own configuration file can be passed with the --config parameter.

./ --config "/opt/ts3video/myconfig.ini"

Start the server

It’s not recommended to use this way in production. Production systems should always use the Windows-Service/Linux-Daemon way.


"C:\ts3video\videoserver.exe" --config "C:\ts3video\default.ini"

Linux: On linux you need to use the script, which prepares the system environment.

/opt/ts3video/ start --config "/opt/ts3video/default.ini"

Run as Windows Service

Installing the server process as a service can be done with the built-in Windows tool sc.

All upcoming commands need to run as a privileged Administrator!

Install as service

sc create "TS3VIDEO" binPath= "C:\ts3video\videoserver.exe --service --config \"C:\ts3video\myconfig.ini\"" start= auto

Even though it might look weird, the space after binPath=, start= and other parameters you might append is important!

Uninstall service

sc delete "TS3VIDEO"


Problem: The service doesn’t start or exits immediately. - Make sure that the user who runs the service has permissions to run the process.

Run as Linux Daemon (Debian - SysV)

The server comes with a script which makes it possible to control the server process in background.

_Note: You have to be logged in as root._

1. Create system user and set permissions

useradd --home-dir /opt/ts3video --system --shell /bin/sh --user-group ts3video
chown -R ts3video:ts3video /opt/ts3video

2. Prepare the start-up script

Open the file for editing and update the variables on top to fit your system.


3. Install the script as start-up script

You can either copy or link the script into /etc/init.d/ before updating your run levels with it.

cp /opt/ts3video/ /etc/init.d/ts3video
update-rc.d ts3video defaults

4. Test it

That’s it! You can now test it with the following commands.

/etc/init.d/ts3video start
/etc/init.d/ts3video stop

You should also reboot and test whether the VideoServer has been started automatically.

The running process name may be different than expected. You shouldn’t see a videoserver process. The running process name will be

Why is that? The server is shipped with its own set of common libraries and a dynamic library loader because of portability issues. This might change in future releases. On some systems it’s possible to run the videoserver binary directly (e.g. Ubuntu 14.04).

Server status web-app

Please head to the server status web-app documentation page.


The server is configured to log into $TEMP/ts3video-server.log. Upcoming releases will allow you to configure the location and verbose level by your self.

Kick / ban clients

Since: 0.3

The server stores all bans to $WORKDIR/bans.ini. If you need to unban the client’s IP address, you must remove the IP from this configuration file. Upcoming releases will provide a more user-friendly way of managing those bans.