TS3Soundboard Plugin

Features

• integrated minimal web-interface
• ingame buttons via Overwolf
• Listen to music with your friends, make funny noises & such
• Plays mp3, wave, ogg, aiff files; also play aac/m4a and flac files via plugins.
• Plays shoutcast/icecast streams or files directly via http
• Sync to Winamp (using playlists) - Windows only
• Remote-Control via passworded commands
• Remote-Control via UDP messages
• Adjust the pitch of your voice (e.g. sound like a chipmunk or ogre)
• doesn't require additional 3rd-party tools
• doesn't require a dedicated TeamSpeak instance
• works on Windows, Linux & Mac
• new: brings a dummy device for machines without soundcards
• new: build a bot on your linux server and control it via a simple web-frontend (follow the guide below)
• it's free, however: donations are always appreciated (see the button on the upper right)

Installation

1. Download the appropriate version for your system and double-click it. The TeamSpeak Plugin Installer will jump in and guide you through initial installation. (if it does not, please see the FAQ)
2. Start TeamSpeak.
3. Follow the instructions in the video below (make sure to completely get the hotkey-part right; I apologize for the inconvenience, but currently there is no other way than setting it up this way).
4. Alternatively (to the video) follow these steps (corresponding to your TS setup (Push-To-Talk/Voice Activation Detection)):
   
   Push-to-talk
   • make sure the plugin is enabled in TeamSpeak (Settings > Plugins)
   • open TeamSpeaks Options (Settings -> Options)
   • click Capture on the left, then select Push-To-Talk on the right
   • assign a new hotkey to Push-To-Talk that you will never need to use (this is really important - and yes, your normal key will work again when you complete this setup!).
   • after you've assigned a new key to the Push-To-Talk function, click Hotkeys on the left
   • click "Add" to add a new hotkey
   • in the "Hotkey Setup Dialog", choose On key down
   • assign your real Push-To-Talk key by clicking on No Hotkey Assigned
   • click Show advanced Actions at the bottom of the dialog
   • in the Search...-field enter Push and select Plugins > Plugin Hotkey > soundboard > Push (you have to expand the entries step by step by clicking the little triangle next to "Plugins" and so on)
   • click OK to save the new hotkey
   • now click "Add" again to add another hotkey (actually, we'll be adding the same one, but this time we'll make it react to the On key release action)
   • in the "Hotkey Setup Dialog", choose On key release (THIS IS VERY IMPORTANT)
   • assign your real Push-To-Talk key again
   • click Show advanced Actions again
   • this time search for Release and select Plugins > Plugin Hotkey > soundboard > Release
   • click OK to save the new hotkey
   • click Apply, then OK to save your new settings
   VAD (Voice Activation Detection)
   • make sure the plugin is enabled in TeamSpeak (Settings > Plugins)
   • open TeamSpeaks Options (Settings -> Options)
   • click Capture on the left, then select Push-To-Talk on the right
   • assign a new hotkey to Push-To-Talk that you will never need to use (this is really important - and yes, I know you wanted VAD - that's what you will get).
   • save your changes by clicking Apply and OK
   • open the plugins' options dialog by clicking Plugins > Soundboard > Configure...
   • in the "Audio"-tab, check Enable Voice Activity Detection (VAD)
5. Continue reading at Setup.

Setup

After your're done with the installation steps, let's setup the actual Soundboard. To make it show up, go to Plugins > Soundboard > Configure... to adjust the plugins' settings to your needs. However, the default configuration should already serve most of what you need.

On to the button board!

Right-click any of the buttons to assign files, change the type of the button or configure the whole frame. If you want to keep it simple, just drag&drop a file onto each button (this will only work on windows if you installed TeamSpeak via the "only for me"-option).

When you now click the button, it plays the assigned file back to you and the channel you're in. You might want to adjust the volume for local or send (that's what everyone besides you hears) playback so that everyone is comfortable with it.

FAQ - Frequently Asked Questions

I've downloaded the plugin, but when I open the file either nothing happens or I get an error.

The plugin is usually installed via the TeamSpeak official plugin installation tool - if you get an error, it probably means that that tool doesn't work. Please try to reinstall TeamSpeak and if that doesn't help, rename the downloaded file so that it ends with .zip and extract its contents to TeamSpeaks plugin path. On Windows, this is usually C:\Program Files\TeamSpeak 3 Client\Plugins, on Mac it's /Applications/TeamSpeak 3 Client.app/Content/SharedSupport/plugins.

I've downloaded the plugin, but when I open the file, it gets opened with WinRAR, Winzip or such...

Some browsers rename the extensions of the files you download if they can determine, what filetype the file is; if the filename ends with .zip, rename it, so that it ends with .ts3_plugin and double-click it manually. If that doesn't help, follow the steps above.

I'm using Voice Activity Detection and others can hear the sound only when I speak.

You probably still have TeamSpeak itself configured to use VAD - given the way the plugin works, this will not work. Instead activate VAD inside Soundboards' plugin settings and set your TS to use Push-to-talk (yes, really).

After I used the soundboard, noone can here me or just some random/static noise. Why?

You're probably using Push-To-Talk and havent's setup everything like explained. Please follow the setup guide more carefully and everything should work just fine.

How can I bind my buttons to hotkeys so I can use my keyboard to control them?

Right click the button and choose Set hotkey... to bind a key. Alternatively open the TeamSpeak settings and add a hotkey, bind it to "plugin command" and enter /soundboard button 1 for the first button and/or exchange 1 with whatever button you want assign that key to. The hotkeys section in the options of TeamSpeak is the right place where you can delete hotkeys afterwards.

What commands are there that I can bind hotkeys to or enter in the chat?

/soundboard stop stop music directly /soundboard fadeout stop music slowly, decreasing volume /soundboard sound <file> play a sound file /soundboard music <file> play a music file /soundboard stream <url> stream an url from the internet /soundboard show display the soundboard buttons /soundboard push send voice /soundboard release stop sending voice /soundboard button <buttonNumber> play a specific button /soundboard enablevad enable voice activity detection /soundboard disablevad disable voice activity detection /soundboard volumeup increase both local and remote volume /soundboard volumeup local increase local volume /soundboard volumeup remote increase remote volume /soundboard volumedown decrease both local and remote volume /soundboard volumedown local decrease local volume /soundboard volumedown remote decrease remote volume /soundboard volume <volume> set both volumes to a value between 0 and 100 /soundboard volume <volume> local set local volume to a value between 0 and 100 /soundboard volume <volume> remote set remote volume to a value between 0 and 100

I've enabled sync and remote control, now how do I remote control the bot from another TeamSpeak client?

Please note that EVERY command except button works only when synchronizing with Winamp on Windows. The commands have to be sent as private messages to the client running the plugin (the "bot") and all commands HAVE to start with the chosen password - like

my_secret_password play

. play start playback stop stop playback pause pause / resume playback next jump to next track prev jump back to previous track shuffle toggle shuffle button <number> playback a specific button (starting with 1) track <number> select a specific track in the playlist request <number> select and play specific track in the playlist info <number> get information about a track in the playlist

How can I get the best possible quality?

Always choose the Opus codec in music mode - but also keep in mind that this will increase bandwidths for every one in the channel. (Make sure you're using at least version 0.9.9.2b)

How can i play aac/m4a and flac-Files?

Notice: Instead of using the follwing plugins, you can enable the VLC functionality which enables even more file formats (see below).
Those codecs are supported but not integrated into the plugin itself; however, you can download plugins for the system you're using and Soundboard will be able to play such files afterwards.

• Windows, 32/64 bit - flac, aac/m4a

Copy the file bassflac/bassflac.dll (*.flac) or bass_aac.dll (*.aac/*.m4a) from the downloaded archive to your <TS3Client>/plugins/bass folder and restart TeamSpeak. The archive should contain both 32 and 64 bit dlls.

You mentioned VLC and YouTube!?

If you've installed VLC in the corresponding version of your TeamSpeak (and so far only 64bit on Windows, Linux and Mac are supported), you can setup the plugin so that it uses VLC to playback even more file formats (which includes videofiles - of course you can only stream the audio from such files - and even YouTube links). The settings can be found in the advanced-tab of the plugins' configuration. This will be clarified more soon.

Can I use the plugin with Spotify, Pandora or such?

Sorry, you can not. Theres some encryption going on with such services so that direct file access is impossible. Update: actually there might be a chance that Spotify (but nothing else) is going to work.

My microphone & speakers don't work anymore - or: all my playback devices are gone and there's only a dummy device from the plugin there - help!

There seems to be a common problem when TS enables the dummy device by default. However: your devices aren't gone, they're just listed in a different category than "custom". So make sure you select the appropriate category as "Playback mode" to see all your devices again. I hope this gets fixed in the future so people don't get confused with this anymore. This problem should be fixed in the latest experimental release.

I need more buttons - how can I get them?

Right click an existing button, choose "Soundboard settings" -> "Number of buttons" / "Number of buttons per row" and set it to the number you want.

What's up with the weird "sound" and "music" distinction? or: how do I stop the music?

The plugin handles files differently via this option; while many sound-files can be played concurrently, only one music-file at a time is allowed. Also: music-files can be stopped, sound-files can't. So really use "sound" for short samples you want to playback in between music or quickly after one another and "music" when you really play back music.

Where are Soundboards config file located?

This depends on your system; on Windows you can find them usually in C:\Users\<Username>\AppData\Roaming\TeamSpeak 3 Client\, on Mac they are in ~/Library/Application Support/TeamSpeak 3/.

I've read that you can control the plugin via UDP, how do I do it?

This feature might be removed in one of the next releases in favor of a more generic http-interface.
This feature has to be activated by manually editing the plugins' config file. In Section [general] add the following options:

enableUDP=true
udpListen=19111
udpNotify=19112

Restart TeamSpeak. This makes the plugin listen for commands on port 19111 and send responses to port 19112, both localhost (as a precaution).
Commands can then be sent as /music <path_to_file> and such.
Notification for now will only be a "finished", after a music-file finished playback.

Guide: Bot on Ubuntu 12.04 LTS (64bit)

This guide will show you a quick and easy way to setup a Bot with Soundboard that plays music from a server. It requires some basic linux knowledge. This will only work with version 0.9.9.2b and above.

Roadmap

• Soundboard-Sets; make sets loadable by hotkeys

Got ideas? Let me know by submitting them at the TS3 forums or in the comments below!

Changelog

Credits

The plugin itself is © 2011-2015 Michael Friese.

It uses the great BASS 2.4 library that is © 1999-2010 Un4Seen Developments Ltd.

TeamSpeak is © 2010 TeamSpeak Systems GmbH.

The author of this plugin is not affiliated in any way with TeamSpeak Systems GmbH.