A collection of custom cogs for Red-DiscordBot V3, featuring AI-powered content summarization, media link conversion, and utility tools.
| Cog | Description | Dependencies |
|---|---|---|
| ispyfj | Converts FunnyJunk video links to direct, embeddable links for Discord | None |
| mcinfo | Fetches and displays Minecraft server status and information | mcstatus |
| redvids | Embeds Reddit videos directly into Discord from links | ffmpeg, redvid |
| spottube | Automatically converts Spotify links to YouTube links when posted in chat | Spotify & YouTube APIs |
| tldscience | Summarizes scientific articles using Claude AI (Anthropic) | Anthropic API |
| tldw | "Too Long, Didn't Watch" - Summarizes YouTube videos using OpenRouter LLM | OpenRouter API, yt-transcript-fetcher |
| Cog | Description | Status |
|---|---|---|
| gpt3chatbot | GPT-3 powered chatbot with customizable personas | Currently disabled |
| x2image | Converts X.com (Twitter) links to image screenshots | Disabled due to Chrome headless mode changes |
- Red-DiscordBot V3 installed and configured
- Python 3.10 or 3.11
- ffmpeg (required for
redvidscog)
- Add this repository to your Red instance:
[p]repo add TytoCogsV3 https://github.com/SootyOwl/TytoCogsV3
- Install the cog(s) you want:
[p]cog install TytoCogsV3 <cog_name>
- Load the cog:
[p]load <cog_name>
Replace [p] with your bot's prefix and <cog_name> with the name of the cog you want to install (e.g., tldw, mcinfo, spottube).
Some cogs require API keys to function:
Requires an Anthropic (Claude) API key:
[p]set api anthropic api_key <your_api_key>
Requires an OpenRouter API key:
[p]set api openrouter api_key <your_api_key>
Requires Spotify and YouTube API credentials. Configuration details are available in the cog's documentation.
Each cog may have additional configuration options. Use [p]help <cog_name> to see available commands and settings for each cog.
[p]tldw https://www.youtube.com/watch?v=example
Generates a summary of the YouTube video's content.
[p]tldscience https://example.com/scientific-article
Provides a TLDR summary of scientific articles and research papers.
[p]mcinfo play.example.com
Displays the status and information for a Minecraft server.
Simply post a Spotify link in chat, and the bot will automatically reply with the corresponding YouTube link.
Post a Reddit link containing a video, and the bot will embed it directly in Discord.
Post a FunnyJunk video link, and the bot will convert it to an embeddable format.
- Clone the repository:
git clone https://github.com/SootyOwl/TytoCogsV3.git
cd TytoCogsV3- Install dependencies using uv:
uv sync --dev- Install pre-commit hooks:
pre-commit installpytestThis project uses:
- Black for code formatting (line length: 120)
- Flake8 for linting
- pre-commit hooks to ensure code quality
Format your code before committing:
black .Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to:
- Follow the existing code style
- Update tests as appropriate
- Update documentation as needed
- Follow the Code of Conduct
See CHANGELOG.md for a detailed history of changes.
This project is licensed under the MIT License - see the LICENSE.md file for details.
Tyto (SootyOwl)
- GitHub: @SootyOwl
- Email: tyto@tyto.cc
None of this code is guaranteed to work. Use at your own risk.
- Built for Red-DiscordBot V3
- Thanks to all contributors and users of these cogs
- Special thanks to Nyko for co-authoring the gpt3chatbot cog