tsbot 0.16.0

Asynchronous framework to build TeamSpeak 3 Server Query bots

TSBot

Asynchronous framework to build TeamSpeak 3 Server Query bots

✅ Features

• Uses modern Python async and await syntax
• Secure connection through SSH
• Ease of use query building
• Built-in and configurable ratelimiter if no access to whitelist.txt
• Query caching

✏️ Examples

from __future__ import annotations

import asyncio

from tsbot import TSBot, events, query


bot = TSBot(
    username="USERNAME",
    password="PASSWORD",
    address="ADDRESS",
)


@bot.command("hello")
async def hello_world(bot: TSBot, ctx: dict[str, str]):
    await bot.respond(ctx, f"Hello {ctx['invokername']}!")


@bot.on("cliententerview")
async def poke_on_enter(bot: TSBot, event: events.TSEvent):
    poke_query = query("clientpoke").params(clid=event.ctx["clid"], msg="Welcome to the server!")
    await bot.send(poke_query)


asyncio.run(bot.run())

Check out 📁examples for more

📦 Installation

Python 3.10 or higher is required

Installing with pip:

# Linux/macOS
python3 -m pip install tsbot

# Windows
py -3 -m pip install tsbot