{"id":16019653,"url":"https://github.com/tofran/ts3-log-analyzer","last_synced_at":"2025-12-14T00:02:39.552Z","repository":{"id":30849433,"uuid":"34406935","full_name":"tofran/ts3-log-analyzer","owner":"tofran","description":":calendar: ts3LogAnalyzer: Analyze TeamSpeak 3 logs","archived":false,"fork":false,"pushed_at":"2020-09-11T00:18:08.000Z","size":129,"stargazers_count":12,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-11T13:13:51.891Z","etag":null,"topics":["log-analyzer","logs","pypi","python","statistics","teamspeak","ts3","ts3admin","ts3server"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"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/tofran.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}},"created_at":"2015-04-22T18:04:19.000Z","updated_at":"2023-11-27T08:34:22.000Z","dependencies_parsed_at":"2022-09-03T09:01:39.348Z","dependency_job_id":null,"html_url":"https://github.com/tofran/ts3-log-analyzer","commit_stats":null,"previous_names":["tofran/ts3loganalyzer"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tofran%2Fts3-log-analyzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tofran%2Fts3-log-analyzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tofran%2Fts3-log-analyzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tofran%2Fts3-log-analyzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tofran","download_url":"https://codeload.github.com/tofran/ts3-log-analyzer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243896717,"owners_count":20365423,"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":["log-analyzer","logs","pypi","python","statistics","teamspeak","ts3","ts3admin","ts3server"],"created_at":"2024-10-08T17:05:02.374Z","updated_at":"2025-12-14T00:02:34.295Z","avatar_url":"https://github.com/tofran.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TS3 Log Analyser\n\n[![pypi link](https://img.shields.io/pypi/v/ts3LogAnalyzer.svg)][pypi]\n![Python version 3](https://img.shields.io/badge/Python-3-blue.svg)\n\n**A Python utility for analyzing TeamSpeak 3 server logs.**\n\nAnalyze multiple log files or an entire log folder.\nStores info about all clients and respective connections and nicknames in a SQLite database for ease of use by other applications.\n\nCan be used for extracting information like:\n - Who has the most cumulative connection time on the server / Time spent by each user on server\n - Longest connection time for each user\n - First and last seen\n - Most used nicknames\n - Total number of connections\n - Merge users with different identities\n - and much more...\n\nGenerate useful/fun statistics like the ones you can [find here][ToFran's server statistics] for my server:\n\n[![preview](https://i.gyazo.com/c6c4689ed2f69cf98cf295619b0235f2.png)][ToFran's server statistics]\n\n\nIt can also 'merge' identities out of the box, this way you can combine stats for users that have multiple identities - as seen in the [example][ToFran's server statistics] (If you belive that everyone should backup their identities, and if they don't do it, it's their fault - you can ignore this feature :D )\n\n**Disclaimer:** The aim of this project/repo is the log analyzer This repo does not include the web viewer. I'm still developing it, and currently it is not published. This means that you can only generate the DB, and build your own web application. Hopefully I will release [mine](https://github.com/tofran/ts3LogAnalyzer-viwer).\n\nAnaly**s**e VS Analy**z**e: Look, English is not my main language, therefore I only found out that anali*s*e could be spelled with an `s` or `z` much after creating and publishing this project. I do not believe that one is better over another. If you cannot live with ts3LogAnaly**z**er with `z` you can always alias it :P.\n\n## Usage\n\n### Installation\n\nPython 3 only.\n\n`pip install ts3LogAnalyzer`\n\nAlternatively you can clone and setup using setuptools or simply call the file directly.\n\n### Examples\n\n  * Analyze a file:\n\n  `$ ts3LogAnalyzer databse.db -a ts3server_2017-02-12__11_46_44.016222_1.log`\n\n  * Analyze a folder:\n\n  `$ ts3LogAnalyzer databse.db -a ts3server/logs`\n\n  * Analyze a folder, make it mergeable and generate statistics and hide IP's:\n\n  `$ ts3LogAnalyzer databse.db -a . -msi`\n\n  * Be nice to the system when running:\n\n  `$ nice -n 19 ts3LogAnalyzer db.db -a /path/ -msi`\n\n  * Merge two clients:\n\n  `$ ts3LogAnalyzer databse.db --merge 13 37`\n\n\n### Options\n```\nts3LogAnalyzer.py\nUsage:\n    ts3LogAnalyzer.py \u003cdatabase\u003e -a \u003cpath\u003e [--stats] [--no-ips] [--mergeable] [--debug] [--output-logging]\n    ts3LogAnalyzer.py \u003cdatabase\u003e --merge \u003cc1\u003e \u003cc2\u003e [--debug] [--output-logging]\n    ts3LogAnalyzer.py \u003cdatabase\u003e ([--stats] | [--no-ips]) [--debug] [--output-logging]\n    ts3LogAnalyzer.py -h | --help\n    ts3LogAnalyzer.py -v | --version\nOptions:\n    -a --analyze \u003cpath\u003e             Log file or folder to analyze\n    -s --stats                      Generate statistic fields for every client\n    -i --no-ips                     Remove ip's from the databse\n    -m --mergeable                  Make the clients mergeable\n    --output-logging                Output logging from THIS program to ts3LogAnalyzer.log\n    --debug                         Output debug information\n    -h --help                       Show this screen\n    -v --version                    Show version\n```\n\n## Todo\n\n - [ ] Performance improvements #3\n - [ ] Support for other DB's other than SQLite #5\n - [ ] Python 2 compatibility\n\n## Discussion\n\nFeature requests and bugs: [issues]\n\nOther discussion: TeamSpeak forum [thread]\n\n## Licence\nGNU General Public License v3.0\n\n## Contact/Donate\nContact me at [tofran.com](https://tofran.com).\n\n[ToFran's server statistics]: http://tofran.com/ts/stats/\n[thread]: http://forum.teamspeak.com/showthread.php/112796-RELEASE-TS3logAnalyser-Analyse-your-teamspeak-server-logs\n[pypi]: https://pypi.python.org/pypi/ts3LogAnalyzer\n[issues]: https://github.com/tofran/ts3LogAnalyzer/issues\n[v1_java]: (https://github.com/ToFran/TS3LogAnalyzer/tree/v1_java)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftofran%2Fts3-log-analyzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftofran%2Fts3-log-analyzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftofran%2Fts3-log-analyzer/lists"}