Tether

A Discord bot that links ("tethers") voice channels to automatically managed text channels. When users join a tethered voice channel, a temporary text channel is created with synced permissions—bringing back that classic TeamSpeak feel where every voice channel has its own dedicated space.

• /tether <voice_channel> - Link a voice channel to auto-create text channels
• /untether <voice_channel_id> - Remove a voice-text channel link
• Automatic text channel creation when first user joins voice
• Permission sync: only voice channel members can see the text channel
• Auto-cleanup: text channel is deleted when voice channel empties

Self-hosting

Using pre-built image (recommended)

# compose.yml
services:
  tether:
    image: ghcr.io/teyd/tether:latest
    container_name: tether
    environment:
      DISCORD_TOKEN: ${DISCORD_TOKEN}
      DISCORD_APPLICATION_ID: ${DISCORD_APPLICATION_ID}
      LOG_LEVEL: ${LOG_LEVEL:-info}
    volumes:
      - ./data:/data
    restart: unless-stopped

docker compose up -d

Building from source

git clone https://github.com/teyd/tether.git
cd tether
docker compose up -d

Environment Variables

Variable	Required	Default	Description
DISCORD_TOKEN	✅	-	Discord bot token
DISCORD_APPLICATION_ID	✅	-	Discord application ID
LOG_LEVEL	❌	info	Log level: trace, debug, info, warn, error, fatal