{"id":24731401,"url":"https://github.com/phun333/twitch-telegram-bot","last_synced_at":"2025-10-10T00:32:08.467Z","repository":{"id":273596758,"uuid":"909122729","full_name":"phun333/twitch-telegram-bot","owner":"phun333","description":"A Python bot that sends Telegram notifications when your favorite Twitch streamer goes live. Features instant alerts with stream title, game info, and direct link. Simple setup, no spam, and runs continuously.","archived":false,"fork":false,"pushed_at":"2025-01-21T20:17:11.000Z","size":7,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-21T21:25:32.867Z","etag":null,"topics":["bot","livestream","notification","python","stream-notifier","telegram","telegram-bot","twitch","twitch-api"],"latest_commit_sha":null,"homepage":"","language":"Python","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/phun333.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":"2024-12-27T19:39:40.000Z","updated_at":"2025-01-21T20:17:14.000Z","dependencies_parsed_at":"2025-01-21T21:25:39.352Z","dependency_job_id":null,"html_url":"https://github.com/phun333/twitch-telegram-bot","commit_stats":null,"previous_names":["phun333/twitch-telegram-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phun333%2Ftwitch-telegram-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phun333%2Ftwitch-telegram-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phun333%2Ftwitch-telegram-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phun333%2Ftwitch-telegram-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phun333","download_url":"https://codeload.github.com/phun333/twitch-telegram-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235888705,"owners_count":19061167,"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","livestream","notification","python","stream-notifier","telegram","telegram-bot","twitch","twitch-api"],"created_at":"2025-01-27T16:49:04.376Z","updated_at":"2025-10-10T00:32:03.198Z","avatar_url":"https://github.com/phun333.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Twitch Stream Notification Bot\n\nThis bot monitors your specified Twitch streamer and sends notifications to your Telegram when they go live\n\n## Features\n\n- Instant notifications when streamer goes live\n- Stream title and game information\n- Direct link to stream\n- Checks every 2 minutes\n- Spam protection (no duplicate notifications for same stream)\n- Automatic reconnection\n- Error recovery\n\n## Requirements\n\n- Python 3.x\n- pip (Python package manager)\n- Twitch Developer account\n- Telegram bot\n\n## Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone [repo-url]\n   cd twitch-telegram-bot\n   ```\n\n2. Create virtual environment:\n\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # For Linux/Mac\n   # or\n   .\\venv\\Scripts\\activate  # For Windows\n   ```\n\n3. Install requirements:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Get API credentials:\n\n   **Twitch API Credentials:**\n   - Go to [Twitch Developer Console](https://dev.twitch.tv/console)\n   - Create a new application\n   - Get your Client ID and Client Secret\n\n   **Telegram Bot:**\n   - Talk to [@BotFather](https://t.me/botfather)\n   - Create new bot using `/newbot` command\n   - Get your bot token\n   - Send a message to your bot\n   - Get your chat ID by visiting:\n     `https://api.telegram.org/bot\u003cBOT_TOKEN\u003e/getUpdates`\n\n5. Create `.env` file:\n\n   ```properties\n   TWITCH_CLIENT_ID=your_twitch_client_id\n   TWITCH_CLIENT_SECRET=your_twitch_client_secret\n   TELEGRAM_BOT_TOKEN=your_telegram_bot_token\n   TELEGRAM_CHAT_ID=your_telegram_chat_id\n   TWITCH_USERNAME=favorite_streamer_username\n   ```\n\n## Usage\n\nTo start the bot:\n\n```bash\npython main.py\n```\n\nThe bot will:\n\n- Check streamer status every 2 minutes\n- Send notification when stream starts\n- Include stream title, game, and link in notification\n- Avoid duplicate notifications for same stream\n- Send initial notification if stream is live when bot starts\n\n## Troubleshooting\n\nIf the bot encounters errors:\n\n1. Verify credentials in `.env` file\n2. Check your internet connection\n3. Verify Twitch API keys are valid\n4. Ensure your Telegram bot is active\n\n## Notes\n\n- Use tools like screen or tmux to keep the bot running in background\n- Notifications are sent only once when stream starts\n- Bot will wait 60 seconds and retry on errors\n\n## Contributing\n\nWe welcome contributions to improve this project! Feel free to:\n\n- Report bugs\n- Suggest new features\n- Submit pull requests\n- Improve documentation\n\nYour contributions will help make this bot even better. Thank you for your interest in the project!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphun333%2Ftwitch-telegram-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphun333%2Ftwitch-telegram-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphun333%2Ftwitch-telegram-bot/lists"}