tsviewer/README.md
2019-02-07 14:58:44 +01:00

106 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# tsviewer **[WIP]**
A TS3 Viewer with REST API.
I´m a sick Fuck i like the sick F09ck
## DOCKER-Config
```bash
docker build -t name/cont:ver .
docker run -e TS3_IP="<SERVER-IP>" -e TS3_PW="<SERVER-ADMIN_PW>" -e WEB_PORT="8080" -d -p 8080:8080 name/cont:ver
```
ENV:
```Docker
ENV TS3_IP=127.0.0.1
ENV TS3_NAME=serveradmin
ENV TS3_PW=<changeMe>
ENV TS3_PORT=9987
ENV TS3_QUERY=10011
ENV WEB_PORT=8080
ENV BLACKLIST_USER=USER
```
# Features
## Config
The config file is generated automatically on first startup.
```json
{
"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`
```json
{
"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/`
```json
{
"id": 1,
"subchannels": [
... (contains all subchannel)
],
"name": "main1",
"totalClients": 0,
"neededSubscribePower": 0
}
```
## Server
- **`GET`** `/v1/server/info`
```json
{
"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
}
```