{"id":28541964,"url":"https://github.com/agm-dev/stream-live-alerts","last_synced_at":"2026-03-06T10:31:59.941Z","repository":{"id":40741738,"uuid":"202911656","full_name":"agm-dev/stream-live-alerts","owner":"agm-dev","description":"Node script to check Twitch streams data from your favorite streamers and notify in Telegram","archived":false,"fork":false,"pushed_at":"2025-08-30T00:06:36.000Z","size":69,"stargazers_count":2,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-30T02:21:18.113Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agm-dev.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-08-17T17:22:18.000Z","updated_at":"2025-08-30T00:06:39.000Z","dependencies_parsed_at":"2025-08-05T20:25:20.462Z","dependency_job_id":"dcac240d-d570-434d-acc3-67950681c029","html_url":"https://github.com/agm-dev/stream-live-alerts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/agm-dev/stream-live-alerts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agm-dev%2Fstream-live-alerts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agm-dev%2Fstream-live-alerts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agm-dev%2Fstream-live-alerts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agm-dev%2Fstream-live-alerts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agm-dev","download_url":"https://codeload.github.com/agm-dev/stream-live-alerts/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agm-dev%2Fstream-live-alerts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30171869,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T07:56:45.623Z","status":"ssl_error","status_checked_at":"2026-03-06T07:55:55.621Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":[],"created_at":"2025-06-09T20:10:25.166Z","updated_at":"2026-03-06T10:31:59.920Z","avatar_url":"https://github.com/agm-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stream Live Alerts\n\nA NodeJS script that queries Twitch.tv API to get data of your favourite channels, then notifies you when the streaming is live and when it ends using Telegram.\n\n## What do you need?\n\n- Twitch client ID.\n- Telegram bot token.\n- The Twitch usernames of the streamers you want to track.\n\n### Twitch client ID\n\nYou need to go to [Twitch developers portal](https://dev.twitch.tv/), then login and go to your dashboard. Create a new app and get your client ID and secret.\n\n### Telegram Bot Token\n\nYou can check [Telegram Bots Documentation](https://core.telegram.org/bots) to know how to create a bot. Then create one by talking with [BotFather](https://telegram.me/botfather). This way you will get your bot's token.\n\n## Installation\n\nYou will need to install [NodeJS](https://nodejs.org/es/) and [Git](https://git-scm.com/), of course.\n\nThen exec this in the shell:\n\n```sh\ngit clone https://github.com/agm-dev/stream-live-alerts.git\ncd stream-live-alerts\nnpm install\ncp .env.exmaple .env # copy the .env.example to .env file\n```\n\nEdit the `.env` file to fill up the `TWITCH_CLIENT_ID`, `TWITCH_SECRET`, `TELEGRAM_TOKEN`, and the `TELEGRAM_USER_ID`. You can also add `SECONDARY_USERS_IDS` if you want to allow other Telegram users to use your bot. This variable is an array of other authorized users ids. They will have a limit of watched channels set by `MAX_CHANNELS_ALLOWED`.\n\nIf you don't know your Telegram user ID, you can ask to [myidbot](https://telegram.me/myidbot) on Telegram.\n\nYou also need to create the next directories and files:\n```\n/data\n/data/store.json (with content -\u003e {})\n/data/streamer-watched.csv\n```\n\nFill up `streamer-watched.csv` with some channels you want to track. You can do this from your Telegram bot, but write the csv header at least:\n\n```\nstreamer_watched,user_ids\nchannel1,123\nchannel2,123;456\n```\n\nYou can configure your Telegram's bot to add this commands. This script will listen to them:\n```\n/watch_channel [channel] -\u003e adds the channel to the csv file\n/stop_watching [channel] -\u003e removed the channel to the csv file\n/show_watched -\u003e prints the list of channels being tracked\n```\n\nAfter all this configuration just run:\n\n```\nnpm install\nnpm run build\nnpm start\n```\n\n## Telegram's Bot Commands\n\n```\nwatch_channel - Adds a channel to watched list\nstop_watching - Removes a channel from watched list\nshow_watched - Displays the list of watching channels\nenable_notifications - Enables all notifications\ndisable_notifications - Disables all notifications\nenable_notifications_on_end - Enables notifications when a streaming ends\ndisable_notifications_on_end - Disables notifications when a streaming ends\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagm-dev%2Fstream-live-alerts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagm-dev%2Fstream-live-alerts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagm-dev%2Fstream-live-alerts/lists"}