Skip to content

Commit

Permalink
feat: add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
kevincali committed Mar 31, 2024
1 parent 23ae3b3 commit b648afa
Showing 1 changed file with 33 additions and 0 deletions.
33 changes: 33 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# TeamSpeak to Telegram
`teamspeak-to-telegram` updates a pinned Telegram message with online TeamSpeak users.

## Configure
- copy `config.example.yaml` to `config.yaml`
- open `config.yaml` in your favorite editor

### TeamSpeak
- connect to your TeamSpeak server with Server Admin permissions
- click on `Tools` and then on `ServerQuery Login`
- enter a username
- copy the generated password to the config
- add your virtual server id (usually `1`) to the config

### Telegram
- create a Telegram bot by contacting [@BotFather](https://t.me/BotFather)
- copy the bot token to the config
- contact the bot in a DM or add it to a group
- get the chat ID
- you could use [@username_to_id_bot](https://t.me/username_to_id_bot) (not an official Telegram bot, use with caution!)
- copy the chat ID to the config

## Usage
### Run the container
Images are available on [Docker Hub](https://hub.docker.com/r/kevincali/teamspeak-to-telegram).
- `docker pull kevincali/teamspeak-to-telegram:latest`
- `docker run --env CONFIG_PATH=config.yaml kevincali/teamspeak-to-telegram:latest`

### Build and run the binary
- clone the repository
- `make build`
- `make run`

0 comments on commit b648afa

Please sign in to comment.