go-tsviewer/README.md

1.9 KiB

tsviewer [WIP]

A TS3 Viewer with REST API.

DOCKER-Config

docker build -t name/cont:ver .

docker run -e ts3_ip="ts_ip", ts3_pw="quarry_pw", web_port="port" -d -p 8080:8080 name/cont:ver

ENV:


ENV TS3_IP=0.0.0.0
ENV TS3_NICKNAME=serveradmin
ENV TS3_NAME=serveradmin
ENV TS3_PW=f3gWdOU3
ENV TS3_PORT=9987
ENV TS3_QUERY=10011
ENV WEB_PORT=8080

Features

Config

The config file is generated automatically on first startup.

{
    "user": {
        "nickname": "serveradmin",
        "name": "serveradmin",
        "password": ""
    },
    "serverTS": {
        "ip": "127.0.0.1",
        "portServer": 9987,
        "portQuery": 10011
    },
    "serverWeb": {
        "port": 80
    }
}

URL-Parameter

Name Type Description
pretty bool pretty-prints JSON
envelope bool wraps JSON in data array

Channels

  • GET /v1/channels/:id
  • GET /v1/channels
{
    "databaseId": 1,
    "channelId": 1,
    "nickname": "serveradmin from 127.0.0.1:58359",
    "type": 1,
    "away": false,
    "awayMessage": ""
}

Clients

  • GET /v1/clients/:id
  • GET /v1/clients/
{
    "id": 1,
    "subchannels": [
        ... (contains all subchannel)
    ],
    "name": "main1",
    "totalClients": 0,
    "neededSubscribePower": 0
}

Server

  • GET /v1/server/info
{
    "name": "TeamSpeak ]I[ Server",
    "status": "online",
    "version": "3.5.1 [Build: 1545076855]",
    "welcomeMessage": "Welcome to TeamSpeak, check [URL]www.teamspeak.com[/URL] for latest information",
    "maxClients": 32,
    "clientsOnline": 2,
    "reservedSlots": 0,
    "uptime": 5976,
    "totalPing": 0,
    "minAndroidVersion": 1502275280,
    "minClientVersion": 1513163251,
    "miniOSVersion": 1502275280
}