https://github.com/galvinpython/feedr
A Discord Bot that notifies you of YouTube Video Uploads
https://github.com/galvinpython/feedr
Last synced: 6 months ago
JSON representation
A Discord Bot that notifies you of YouTube Video Uploads
- Host: GitHub
- URL: https://github.com/galvinpython/feedr
- Owner: GalvinPython
- Created: 2024-06-21T20:45:04.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-29T20:08:46.000Z (6 months ago)
- Last Synced: 2025-06-29T21:19:00.101Z (6 months ago)
- Language: TypeScript
- Size: 1.64 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Feedr
The next best Discord Bot to notify your members about YouTube video uploads!
Feedr checks for:
- YouTube uploads every **3** seconds
- Twitch streams are live every **2** seconds
Invite the bot [here](https://discord.com/oauth2/authorize?client_id=1243939861996503171&permissions=274877959232&integration_type=0&scope=applications.commands+bot)
# User Instructions
To track a channel, use the **/track** command, which will take in the following parameters
- `youtube_channel`, which is the YouTube Channel ID. It should begin with "UC" and have 24 characters (such as this: UCGJXFC0YsDzVP3ar8RzhCmA)
- `updates_channel`, which is the Discord channel that new uploads will be posted to
- `role` (OPTIONAL), which is the role to ping when there's a new upload.
To stop tracking a channel use **/untrack**
# Roadmap
Feedr strives for constant improvement, so here's what will be implemented
- YouTube Channel selector when using **/track**
- Make it easier to stop tracking channels by showing channels already in the guild when doing **/untrack**
- Other social media platforms
- Bluesky
- Make it easier to switch discord channels for uploads so that **/untrack** then **/track** is not required
- **/tracked** command to show what channels are being tracked in the guild
# Permissions Needed
- View Channels
- Send Messages
- Send Messages in Threads
- Embed Links
- Attach Files
- Add Reactions
# Developer Instructions
Feedr requires Bun in order to work
1. To install, run `bun i`
2. Fill out all the required values in `.env.example` and rename it to `.env` once done
3. To run in developer mode, just run `bun --watch . --dev`, otherwise `bun run .`
# Changelog
## 1.4.0
- Added a new command! `/tracked` ([#50](https://github.com/GalvinPython/feedr/issues/50))
- See all the tracked channels in your server
- The channel you ran the command in will appear first as there is no option to only see the current channel for now
- Locale improvments ([#43](https://github.com/GalvinPython/feedr/issues/43))
## 1.3.0
- Moved database to SQLite
## 1.2.0
- Added Twitch feed
- `platform` added to both **/track** and **/untrack**
## 1.1.0
- Replies are no longer deferred
- Messages can now be sent in Announcement channels [1.0.3]
- Better checking for valid YouTube channel IDs
- Channels with no uploads will be tracked now
## 1.0.0
- Initial release