{"id":16686947,"url":"https://github.com/paralin/ts3-go","last_synced_at":"2026-04-13T07:07:05.727Z","repository":{"id":152080634,"uuid":"102399364","full_name":"paralin/ts3-go","owner":"paralin","description":"TeamSpeak 3 ServerQuery client for Go","archived":false,"fork":false,"pushed_at":"2017-09-09T22:04:27.000Z","size":33,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-10T22:48:39.921Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paralin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2017-09-04T20:22:40.000Z","updated_at":"2024-02-05T20:20:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"3c7220e0-0aaa-4b8f-927a-f420a319bc59","html_url":"https://github.com/paralin/ts3-go","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paralin%2Fts3-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paralin%2Fts3-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paralin%2Fts3-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paralin%2Fts3-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paralin","download_url":"https://codeload.github.com/paralin/ts3-go/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243438979,"owners_count":20291057,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-10-12T15:07:19.675Z","updated_at":"2025-12-30T10:28:37.149Z","avatar_url":"https://github.com/paralin.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Teamspeak 3 ServerQuery\n\n[![GoDoc Widget]][GoDoc] [![Go Report Card Widget]][Go Report Card]\n\n[GoDoc]: https://godoc.org/github.com/paralin/ts3-go\n[GoDoc Widget]: https://godoc.org/github.com/paralin/ts3-go?status.svg\n[Go Report Card Widget]: https://goreportcard.com/badge/github.com/paralin/ts3-go\n[Go Report Card]: https://goreportcard.com/report/github.com/paralin/ts3-go\n\n## Introduction\n\n**go-ts3** is a Go client for the **ServerQuery** API in TeamSpeak 3.\n\nThe [ServerQuery API Specification](http://media.teamspeak.com/ts3_literature/TeamSpeak%203%20Server%20Query%20Manual.pdf) has the relevant information about the supported APIs.\n\n## API Structures\n\nAPI structures can be encoded into \"ServerQuery\" syntax, which looks like:\n\n```\nserverlist\nclientlist –uid –away –groups\nclientdbfind pattern=FPMPSC6MXqXq751dX7BKV0JniSo= –uid\nclientkick reasonid=5 reasonmsg=Go\\saway! clid=1|clid=2|clid=3\nchannelmove cid=16 cpid=1 order=0\nsendtextmessage targetmode=2 target=12 msg=Hello\\sWorld!endtextmessage \n```\n\nThis package can marshal (encode) and unmarshal (decode) the ServerQuery protocol intelligently, supporting anonymous types and nested / ignored fields.\n\n```golang\n// TargetMode specifies which kind of target to use.\ntype TargetMode int\n\n// SendTextMessage sends text messages to channels or users.\ntype SendTextMessage struct {\n\t// TargetMode is the target mode of the command.\n\tTargetMode TargetMode `serverquery:\"targetmode\"`\n}\n```\n\n## Getting Started\n\nThe following code snippit is approximately how one uses this library. A full example can be seen under the example directory.\n\n```golang\nimport \"github.com/paralin/ts3-go/serverquery\"\n\nclient, err := serverquery.Dial(\"localhost:10011\")\nif err != nil { panic(err) }\nclient.Use(9877)\nclient.Login(\"username\", \"password\")\nclientList, err := client.GetClientList()\n```\n\nAll calls are thread-safe.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparalin%2Fts3-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparalin%2Fts3-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparalin%2Fts3-go/lists"}