This repository contains a unified, standalone cog for Red-DiscordBot designed for private server administration. The cog integrates multiple automation hubs into a single control center managed through persistent interactive control panels.
The cog follows a consistent design pattern:
- Owner-Only: All configuration commands, panels, and interactions are restricted to the bot owner for maximum security.
- Interactive Hubs: Each module is managed via a single, persistent, pinned message (a "hub") deployed via a simple command.
- Modern UI: Configuration and actions are handled through Discord Components like Select Menus, Buttons, and Modals (pop-up forms), not complex text commands.
- Clean UX: The system uses a "Public Error, Ephemeral Success" policy. Error notifications are posted publicly for immediate visibility, while successful actions are acknowledged privately and temporarily to keep channels clean.
The unified Afterwork cog combines the following features into one command group:
- Audio: A persistent player control panel for Red's official Audio cog, allowing users to request songs/playlists, pause, skip, and stop via buttons.
- Embed: A secure utility to send custom, complex embed messages from JSON payloads to configured channels.
- RSS: A background reader that polls RSS/Atom feeds, validates updates, filters content, and posts summaries with extracted images.
- TV: Intercepts webhook embeds from Sonarr and Radarr, reformats them cleanly, and reposts them to a news feed.
- Voice: Manages control panels for temporary voice channels created by an external AutoRoom cog, granting room owners control over lock/unlock, privacy, kick, and ownership transfer.
- Hide: Standardized category visibility management, hiding/showing Category channels from roles with Administrator or Manage Channels permissions.
Deploy the hubs in a channel using the following command structure:
| Command | Action |
|---|---|
[p]afterwork |
Displays the system status dashboard embed for all modules. |
[p]afterwork help |
Lists all available subcommands. |
[p]afterwork deploy |
Deploys/redeploys all 6 configuration hubs sequentially. |
[p]afterwork deploy audio |
Deploys the Audio player control settings hub. |
[p]afterwork deploy embed |
Deploys the custom JSON embed sender hub. |
[p]afterwork deploy rss |
Deploys the RSS feed configuration hub. |
[p]afterwork deploy tv |
Deploys the Sonarr and Radarr webhook reformatter hub. |
[p]afterwork deploy voice |
Deploys the temporary voice room management hub. |
[p]afterwork deploy hide |
Deploys the category visibility hide/show hub. |
[p]afterwork rss remove <name> |
Removes an RSS feed configuration by its unique name. |
- Placement: Place the
afterworkfolder into a valid cog path for your Red-DiscordBot instance (check paths with[p]paths). - Loading: Load the unified cog using:
[p]load afterwork - Setup: Run
[p]afterwork deployin your designated admin channel to deploy all persistent control hubs at once, or use the subcommands to deploy specific ones.