{"id":13758524,"url":"https://github.com/parklez/twitch-bot","last_synced_at":"2025-05-10T08:30:29.686Z","repository":{"id":158968638,"uuid":"140614475","full_name":"parklez/twitch-bot","owner":"parklez","description":"A free, minimal, lightweight, cross-platform, easily expandable  Twitch IRC/API bot.","archived":false,"fork":false,"pushed_at":"2023-02-18T22:04:14.000Z","size":3515,"stargazers_count":14,"open_issues_count":3,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-11-16T15:37:41.082Z","etag":null,"topics":["bot","cross-platform","irc","lightweight","linux","plugins","plugins-twitch-irc","pyinstaller","python","tcl","tk","tkinter","twitch","twitch-api","twitch-bot","windows"],"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/parklez.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}},"created_at":"2018-07-11T18:31:35.000Z","updated_at":"2024-03-22T01:32:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"f1931ba8-2b4a-4879-b8a7-6e57a339dd79","html_url":"https://github.com/parklez/twitch-bot","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parklez%2Ftwitch-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parklez%2Ftwitch-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parklez%2Ftwitch-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parklez%2Ftwitch-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/parklez","download_url":"https://codeload.github.com/parklez/twitch-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253389416,"owners_count":21900757,"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":["bot","cross-platform","irc","lightweight","linux","plugins","plugins-twitch-irc","pyinstaller","python","tcl","tk","tkinter","twitch","twitch-api","twitch-bot","windows"],"created_at":"2024-08-03T13:00:31.746Z","updated_at":"2025-05-10T08:30:29.113Z","avatar_url":"https://github.com/parklez.png","language":"Python","funding_links":[],"categories":["Libraries"],"sub_categories":["Python"],"readme":"# parky's twitch bot\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/parklez/twitch-bot/master/img/win10.png\"\u003e\n\u003c/p\u003e\nA free, minimal, lightweight, cross-platform, easily expandable Twitch IRC/API bot.\n\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n![Made with love](https://img.shields.io/badge/made%20with-love-ff69b4)\n![Downloads](https://img.shields.io/github/downloads/parklez/twitch-bot/total)\n\n## Features\n- 🔌 Connect to Twitch IRC chat!\n- 🔌 Connect to Twitch API! (change game, title)\n- 🔊 Play custom sounds!\n- ⚡ Make your own plugins with 5 lines of Python code! 🐍\n\n## Windows (8, 8.1, 10) 💾\nGet @ [Releases page](https://github.com/parklez/twitch-bot/releases)\n\n## Linux 🐧\nYou may use the following live script to install this app on your machine.\\\nOpen a terminal and choose your favourite method below to install:\n#### Using \"wget\"\n```sh\nsh -c \"$(wget https://raw.githubusercontent.com/parklez/twitch-bot/master/scripts/install.sh -O -)\"\n```\n#### Using \"curl\"\n```sh\nsh -c \"$(curl -fsSL https://raw.githubusercontent.com/parklez/twitch-bot/master/scripts/install.sh)\"\n```\n## MacOS 🍎\nSee [running locally](#running-locally) below.\n\n## ⚡ Included plugins\n|Plugin           |Commands            |\n|-----------------|--------------------|\n|Custom commands  | !add \u003c!command\u003e \u003c response \u003e|\n|Google's TTS     | !tts, !\u003c language \u003e|\n|Misc             | !commands, !remind \u003c something \u003e|\n|Pat \u0026 Love       | !pat, !love \u003c someone \u003e|\n|Plugin toggle    | !plugin \u003c disable/enable \u003e \u003c!command\u003e|\n|Sounds¹          | !\u003c file_name \u003e|\n|Twitch API²      | !uptime, !game \u003c optional \u003e, !title/!status \u003c optional \u003e|\n\n[1]: Custom sounds go inside `/sounds` in mp3/wav formats.\\\n[2]: One must fulfill API credentials inside the application settings. \n\n## 💡 Simple plugin example\nCopy the template below:\n```python\nfrom parky_bot.settings import BOT\nfrom parky_bot.models.message import Message\n\n@BOT.decorator(commands=['!hello', '!hi']):\ndef my_custom_command(message): \n    BOT.send_message(f'Howdy {message.sender}!')\n ```\nSave your `my_custom_plugin.py` under `/plugins` folder and you're ready to go!\n\n## Running locally\n- Install Python 3.7 or newer\n- Set up a virtual env (optional):\n```sh\npython -m venv .venv\n# Unix\nsource .venv/bin/activate\n\n# Windows\n.venv/Scripts/Activate.ps1\n```\n- Install dependencies:\n```sh\npip install -r requirements.txt\n\n# MacOS Only:\npip install pyobjc tkmacosx\n```\n- Start the application:\n```sh\npython -m parky_bot.app\n# Console only/No tkinter:\npython -m parky_bot.app --console\n```\n\n# Linting\nThis project uses `autopep8` for linting. Subject to change.\n\n## Disclaimer\nThis project is under heavy development and subject to refactoring and code smells.\n\n## Contributors\n- xKittieKat (Artist) [deviantart.com](https://www.deviantart.com/xkittiekat/art/barky-chan-v-1-856512308)\n\n## 3rd party resources\n- Volume icon [icon-icons.com](https://icon-icons.com/icon/volume-up-interface-symbol/73337)\n- Shiba icon [icon-icons.com](https://icon-icons.com/icon/dog-pet-animal-japanese-shiba-inu-japan/127300)\n- Menu icon [icons-icons.com](https://icon-icons.com/icon/menu/71858)\n- Banner [github.com/liyasthomas](https://github.com/liyasthomas/banner)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparklez%2Ftwitch-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparklez%2Ftwitch-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparklez%2Ftwitch-bot/lists"}