ts-viewer

A small web page that shows who is sitting in which channel on your TeamSpeak server. Point it at your server, open it in a browser, done.

(demo data — not a real server)

It talks to TeamSpeak over ServerQuery and renders the channel tree server-side. No database, no JavaScript, no state — it just asks the server on every request.

Setup

1. Create a ServerQuery login

In the TeamSpeak client: Tools → ServerQuery Login. You can also use the serveradmin account you got when you first started the server.

The login matters: without one, ts-viewer connects as a guest and people in channels with a raised "needed subscribe power" stay invisible (that Admin channel will look empty even when someone is in it). Any query account works as long as it has enough i_channel_subscribe_power — serveradmin always does.

2. Write a config.yaml

http_addr: ":8080"

servers:
  home:
    host: "ts.example.com"
    port: 10011          # the ServerQuery port, not the voice port (9987)
    username: "serveradmin"
    password: "your-query-password"

Every entry under servers: gets its own page. The key (home here) becomes the URL.

3. Run it

With Docker Compose:

services:
  ts-viewer:
    image: forgejo.home.jbenecke.de/jan/ts-viewer:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config.yaml:/app/config.yaml:ro
    restart: unless-stopped

Or straight from source:

go run ./cmd/server

Then open http://localhost:8080.

Pages

URL	What it shows
/	All configured servers, online or not
/ts-view/home	The channel tree for the home server
/healthz	{"status":"ok"}, for your uptime checks

All config options

http_addr: ":8080"   # listen address (default :8080)
log_level: "info"    # default info

servers:
  home:
    host: "ts.example.com"   # required
    port: 10011              # default 10011
    sid: 1                   # virtual server id, default 1
    username: "serveradmin"  # see the note above
    password: "secret"

Set TS_CONFIG_FILE to load the config from somewhere other than ./config.yaml.

Development

go build ./cmd/server   # build
go test ./...           # test
go vet ./...            # lint