TS6 Addon Installer

The TS6 Addon Installer is an unofficial tool that simplifies the process of installing and managing addons for TeamSpeak 6. It features a builtin patcher to re-enable addon support for the latest versions of TeamSpeak 6.

Important

Addons need to be reinstalled after every TeamSpeak update

Disclaimer

Since the release of TeamSpeak-beta5, client modifications violate the Terms of Service. Use at your own risk!

Installing Addons

The TS6 Addon Installer can automatically download and install addons or install them from zip files.

Requirements

1. Java Runtime Environment 17 or later

Running the installer

Windows exe

1. Double-click the exe file

Universal jar

Note

Depending on your TS6 installation directory, you need to run the installer with elevated privileges

1. Run java -jar TS6AddonInstaller.jar

Automatic Download

1. Select your TS6 installation directory
2. Select the addon you want to install
3. Optional: Select a specific version
   1. Click on "Load"
   2. Select the version you want to install
4. Click on "Install"

Local File or Folder

1. Select your TS6 installation directory
2. Select "Local Addon"
3. Select the addon you want to install
4. Click "Install"

Uninstalling Addons

The TS6 Addon Installer can automatically detect addons you have already installed with the installer and gives you the option to uninstall them again.

1. Select the "Uninstall" tab
2. Select your TS6 installation directory
3. Click on "Load"
4. Select the addon you want to uninstall
5. Click on "Uninstall"

Command Line Interface

The TS6 Addon Installer can be used from the command line with the following usage pattern:

$ java -jar TS6AddonInstaller.jar [OPTIONS] <TEAMSPEAK_PATH>

Option	Arguments	Description
help, h	n/a	Displays a help text for command line usage
version, v	n/a	Displays the version of the installer
install	<addon>	Installs an addon from zip, folder or url, and applies patches to the TeamSpeak installation if required
uninstall	<addon>	Uninstalls an addon by id or name
list-installed	n/a	Displays installed addons
patch	n/a	Patches the TeamSpeak installation to enable addon support
yes, y	n/a	Automatically answers all prompts with 'yes'
dev	n/a	Enables development mode

Compatibility

TeamSpeak	Windows	Linux	MacOS (Intel)	MacOS (ARM)
Beta 5	3.9.0+	3.9.0+	3.9.0+	3.9.0+
Beta 4.1	3.7.0+	3.7.0+	3.7.0+	3.7.0+
Beta 4	3.6.0+	3.6.0+	3.6.0+	3.6.0+
Beta 3.4	3.4.0+	3.4.0+	3.4.0+	3.5.0+
Beta 3.3	-	-	-	-
Beta 3.2	3.3.0+	3.3.0+	3.3.0+	-
Beta 3.1	3.2.0+	3.2.0+	3.2.0+	-
Beta 3	3.1.0+	3.1.0+	3.1.0+	-
Beta 2	3.0.0-3.4.0	3.0.0-3.4.0	3.0.0-3.4.0	-
Beta 1	-	-	-	-

For Developers

If you want your addon to be compatible with the TS6 Addon Installer you need to create a new file called addon.json for your addon. It marks the root of your addon source and needs to be distributed inside your addon artifact. The addon.json contains the following attributes:

Attribute	Description
name	Specifies the name of the addon
id	Specifies the ID of the addon. Allowed characters: A-Z, a-z, 0-9 and _
version	Specifies the version of the addon, following semver semantics
inject	Specifies the file that contains the code that will be injected into the index.html
injection_point	Specifies the html tag the addon will be injected in. This can either be HEAD or BODY. Defaults to HEAD
inject_at	The position inside the html tag the addon will be injected in. This can eiter be HEAD or TAIL. Defaults to TAIL
sources	Specifies a folder relative to the addon.json that contains the actual source files of the addon.
installer	Optional: Specifies the required installer version for the addon, following node-semver semantics
teamspeak	Optional: Specifies the required teamspeak version for the addon, following node-semver semantics

Example:

{
	"id": "betterchat",
	"name": "BetterChat",
	"version": "1.0.0",
	"inject": "index.html",
	"injection_point": "HEAD",
	"inject_at": "TAIL",
	"sources": "src/",
	"installer": "~3.0.0",
	"teamspeak": "6.0.0-beta2"
}

A full example addon can be found here

Patches

The installer features a builtin patcher to re-enable addon support for the latest versions of TeamSpeak 6. Currently, the following patches are included with the installer:

• File validation bypass (does not include unknown file check bypass)
• Domain validation bypass

Please note that all hashes inside patches.json were computed when the app was unsigned.

Building from source

Requirements

1. Java Development Kit 17 or later

Windows exe

1. Run gradlew createExe in the root directory of this repository
2. The Windows exe can be found in ./build/launch4j/

Universal jar

1. Run gradlew build in the root directory of this repository
2. The universal jar can be found in ./build/libs/

Acknowledgements

Based on TS5AddonInstaller made by FelixVolo