{"id":20749326,"url":"https://github.com/hexxone/ts3bot","last_synced_at":"2026-05-24T01:32:42.452Z","repository":{"id":44610932,"uuid":"184755455","full_name":"hexxone/ts3bot","owner":"hexxone","description":"Telegram to TeamSpeak3 Query Bot","archived":false,"fork":false,"pushed_at":"2024-10-28T21:31:43.000Z","size":497,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-24T02:38:16.339Z","etag":null,"topics":["bot","notifications","teamspeak-query","teamspeak3","teamspeak3-bot","telegram","telegram-bot","typescript"],"latest_commit_sha":null,"homepage":"https://t.me/TS3Bot","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hexxone.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-03T12:56:21.000Z","updated_at":"2025-12-14T14:13:02.000Z","dependencies_parsed_at":"2024-10-28T22:35:36.613Z","dependency_job_id":null,"html_url":"https://github.com/hexxone/ts3bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hexxone/ts3bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hexxone%2Fts3bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hexxone%2Fts3bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hexxone%2Fts3bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hexxone%2Fts3bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hexxone","download_url":"https://codeload.github.com/hexxone/ts3bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hexxone%2Fts3bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33418547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"ssl_error","status_checked_at":"2026-05-23T22:14:43.778Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","notifications","teamspeak-query","teamspeak3","teamspeak3-bot","telegram","telegram-bot","typescript"],"created_at":"2024-11-17T08:22:18.063Z","updated_at":"2026-05-24T01:32:42.427Z","avatar_url":"https://github.com/hexxone.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [@TS3Bot](https://t.me/TS3Bot)\n\n[![Total alerts](https://img.shields.io/lgtm/alerts/g/hexxone/ts3bot.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/hexxone/ts3bot/alerts/)\n\n## This bot may link your TeamSpeak3-server to Telegram-groups for customizable cross-chat \u0026 notifications\n\n### Author: [hexx.one](https://hexx.one)\n\nCode is written in TypeScript and deployed using docker-compose.\n\nNOTE: at this point I won't help with any issues regarding setup or usage.\n\n## Requirements\n\n- docker \u0026\u0026 docker-compose\n\n## Setup\n\n.env:\n\n```bash\nBOT_TOKEN=123456:ABCDEFGHIJKKL\nWEBHOOK=false\nWEBHOOK_ADDR=bot.example.com\nWEBHOOK_PORT=80\nCUSTOM_CERT=false\nFILE_PROXY=false\nFILE_PROXY_PORT=8080\nFILE_PROXY_ADDR=files.example.com\nDEVELOPER_ID=12345678\nDEBUG=false\nLANGUAGE=Eng\nMOTD_ID=1\nMOTD_TXT=Hi, thanks for still using the bot!\n```\n\ndocker-compose.yml:\n\n```yaml\nversion: '2'\nservices:\n    node_ts3bot:\n        image: hexxone/telegram-ts3bot\n        container_name: node_ts3bot\n        hostname: node_ts3bot\n        restart: unless-stopped\n        ports:\n            - 8443:80 # can be removed if not using webhook\n            - 8080:8080 # can be removed if not using fileProxy\n        volumes:\n            - ./data:/app/data # bot settings storage directory\n            - ./.env:/app/.env # all possible environment variables (change BOT_TOKEN !)\n```\n\nthen\n\n`docker-compose up -d`\n\n## i18n\n\nIf you wish, You can create your own language file.\n\nJust copy: `src/msg/msg_en.ts` to e.g.: `src/msg/msg_it.ts` (for italian)\nand translate all the strings (using deepl.com or google?).\n\nFeel free to open PR with new and/or fixed translations :)\n\n## Customization\n\nIf you want to understand and improve or extend the bot I recommend first reading the \"config\" comments and further digging your way through it.\nThe code is mostly commented =\u003e Hence no documentation :)\n\nHere is the general structure:\n\n- ACTION\n\n    are usually text-inputs, needed for account setup etc., which can't be done inline.\n    You find them in `src/action/`\n\n- CLASS\n\n    if you think you need an additional static classes or functions,\n    feel free to add them here: `src/class/`\n\n- COMMAND\n\n    create your own commands functions by placing a new \\*.ts\n    file into the `/command/` folder.\n    Take a look at: `src/command/aaa_sample.ts`\n\n- HANDLER\n\n    are the functions which are called when a Telegram message is received.\n    You find them in `src/handler/`\n\n- MSG\n\n    are the translations / languages which are used in the bot.\n    You find them in `src/msg/`\n\n- OBJECT\n\n    are the objects which are used in the bot.\n    You find them in `src/object/`\n\n## Features\n\n(not in particular order):\n\n- Multilanguage Support `(Eng, Ger)`\n- Easy to use Inline-button  Menu navigation\n- Every user can `/add` up to 5 TS3 Servers being watched\n- Customize the Bot `Display name` and `channel to join`\n- `/Link` a server to multiple Telegram groups!\n- Each group will have its own notification and language settings (e.g. have a \"User\" and \"Admin\" Group)\n- Get customizable Join, Leave, \u0026 Channel Switch notifications\n- Bots can be ignored when listing users or showing Notifications\n- `/LiveTree` will show the channels \u0026 clients like the ts3 client as live updated message\n- List all online `/users` per channel\n- Cross Chat in both directions can be enabled\n- Media files from Telegram can be shared \u0026 proxied to TS3 in form of a link to download\n- Group / Server / Channel / Client names will be displayed in front of messages\n- Telegram User Names in TS3 will be clickable with a link to their Profile\n- TS3 User DB id will be included `₍₁₂₎` in messages sent to Telegram\n- `/Silent` mode wont send a notification when sending a message to a group\n- `/Autoconnect` will try to stay connected at all times \u0026 reconnect after errors\n- Spam checker can avoid sending too much messages to TS3 (even bots can get banned for spam)\n- `Admin 4 All` will allow all users in a group to change the settings (Admin Group?)\n- `/commands` will show a list of all _actually available_ commands for the context\n- Easy to add _languages_, _commands_ and response _actions_.\n- `/FAQ`, `/Help`, `/Stats`\n\n### LiveTree example\n\n```text\nServer Name (5 / 32)\n==============================\n         Entry Hall [1]\n    🤖 otherbot\n==============================\n💬 Business\n💬 Retirement home [2]\n    🤐 Sattalit ₍₇₎\n    🔇 SaaS ₍₃₎\n💬 Movie\n💬 Jobcenter\n🔒 TopSecret\n📍 Bottom Secret [1]\n    🤖 TS3Bot\n==============================\n              AFK\n💬 Eat\n💬 Sleep [1]\n    🔇 hexx.one ₍₁₁₎\n==============================\nChanged: 2077-12-24 13:37:42\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhexxone%2Fts3bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhexxone%2Fts3bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhexxone%2Fts3bot/lists"}