{"id":22310303,"url":"https://github.com/VoidDevsorg/social-alert","last_synced_at":"2025-07-29T07:32:53.917Z","repository":{"id":172322288,"uuid":"649144242","full_name":"VoidDevsorg/social-alert","owner":"VoidDevsorg","description":"A simple package to get the latest video from a YouTube channel or the latest stream from a Twitch channel","archived":false,"fork":false,"pushed_at":"2023-10-18T23:38:30.000Z","size":19,"stargazers_count":10,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-09T04:06:03.161Z","etag":null,"topics":["epic-games","instagram","reddit","steam","twitch","twitter","youtube"],"latest_commit_sha":null,"homepage":"https://npmjs.com/package/@voidpkg/social-alert","language":"TypeScript","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/VoidDevsorg.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":"2023-06-03T23:25:11.000Z","updated_at":"2024-04-19T16:08:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"080406bf-8783-4942-b3ca-e68967297b53","html_url":"https://github.com/VoidDevsorg/social-alert","commit_stats":{"total_commits":4,"total_committers":1,"mean_commits":4.0,"dds":0.0,"last_synced_commit":"40b1e301c937afa255b404d874f8e276c05a8124"},"previous_names":["voiddevsorg/social-alert"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/VoidDevsorg/social-alert","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoidDevsorg%2Fsocial-alert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoidDevsorg%2Fsocial-alert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoidDevsorg%2Fsocial-alert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoidDevsorg%2Fsocial-alert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VoidDevsorg","download_url":"https://codeload.github.com/VoidDevsorg/social-alert/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoidDevsorg%2Fsocial-alert/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267646054,"owners_count":24120931,"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","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["epic-games","instagram","reddit","steam","twitch","twitter","youtube"],"created_at":"2024-12-03T21:01:14.986Z","updated_at":"2025-07-29T07:32:53.909Z","avatar_url":"https://github.com/VoidDevsorg.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"![icon](https://voidapi.rest/images/bFQmP1j/social-alert.png)\r\n\r\n# \r\n\r\n## Introduction\r\n\r\n**Social Alert** package is a social media alert package that provides instant broadcast notification in applications such as Instagram and twitch.\r\n\r\nWith low latency, you can get information quickly when the broadcasts of the broadcasters start to broadcast, below is the user guide.\r\n\r\n## Installation\r\n```bash\r\nnpm i @voidpkg/social-alert --save \r\n# or\r\nyarn add @voidpkg/social-alert \r\n```\r\n\r\n\u003cbr\u003e\u003cbr\u003e\r\n\r\n# Usage\r\n\r\n### **YouTube**\r\n```ts\r\nimport { YouTube } from \"@voidpkg/social-alert\";\r\n\r\nconst youtube = new YouTube({\r\n    channels: [ \"CHANNEL_ID\" ],\r\n    postedVideos: [],\r\n    interval: 10000\r\n});\r\n\r\nyoutube.addChannel('CHANNEL_ID');\r\n\r\nyoutube.on('upload', (video: Video) =\u003e {\r\n    console.log(video);\r\n});\r\n```\r\n\r\n### **Twitch**\r\n```ts\r\nimport { Twitch } from \"@voidpkg/social-alert\";\r\n\r\nconst twitch = new Twitch({\r\n    channels: ['elraenn'],\r\n    liveChannels: [],\r\n    interval: 10000,\r\n    client: {\r\n        id: '', // Get from: https://dev.twitch.tv\r\n        secret: '', // Get from: https://dev.twitch.tv\r\n        token: '' // After entering the ID and SECRET, run it and check your console, a token will be automatically generated for you. So you can leave this blank.\r\n    }\r\n});\r\n\r\ntwitch.addChannel('wtcn');\r\n\r\ntwitch.on('live', (stream: Stream) =\u003e {\r\n    console.log(channel);\r\n});\r\n\r\ntwitch.on('offline', (stream: Stream)  =\u003e {\r\n    console.log(channel);\r\n});\r\n```\r\n\r\n\u003cbr\u003e\u003cbr\u003e\r\n\r\n# API\r\n\r\n## Providers\r\n|Name|Events|Implemented|Return Interface|Import Name|\r\n|---|---|---|---|---|\r\n|Twitch|`live`, `offline`|✅|`Stream`|`Twitch`|\r\n|YouTube|`upload`|✅|`Video`|`YouTube`|\r\n|Instagram|`-`|❌|`-`|`Instagram`|\r\n|Reddit|`-`|❌|`-`|`Reddit`|\r\n|Twitter|`-`|❌|`-`|`Twitter`|\r\n|Game Discounts|`-`|❌|`-`|`GameDiscounts`|\r\n\r\n\u003cbr\u003e\r\n\r\n## Interfaces\r\n\r\n```ts\r\nStream {\r\n    id: string;\r\n    user_id: string;\r\n    user_login: string;\r\n    user_name: string;\r\n    game_id: string;\r\n    game_name: string;\r\n    type: string;\r\n    title: string;\r\n    viewer_count: number;\r\n    started_at: string;\r\n    language: string;\r\n    thumbnail_url: string;\r\n    tag_ids: string[];\r\n    tags: string[];\r\n    is_mature: boolean;\r\n}\r\n\r\nVideo {\r\n    title: string;\r\n    link: string;\r\n    pubDate: string;\r\n    author: string;\r\n    id: string;\r\n    isoDate: string;\r\n    thumbnail: string;\r\n    description: string;\r\n}\r\n```\r\n\r\n\u003cbr\u003e\u003cbr\u003e\r\n\r\n---\r\n\u003cbr\u003e\r\n\u003cdiv align=\"center\"\u003e\r\n    \u003cp\u003e© 2019 — 2023 \u003ca href=\"https://voiddevs.org\"\u003eVoid Development, Ltd.\u003c/a\u003e All rights reserved.\u003c/p\u003e\r\n\u003c/div\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVoidDevsorg%2Fsocial-alert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FVoidDevsorg%2Fsocial-alert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVoidDevsorg%2Fsocial-alert/lists"}