pwr-bot

Discord bot that sends feed update notifications to your DM or server.

---

● Installation  ● Preview  ● Usage  ● Features
● Docs  ● License

Installation

Create the Discord application and invite the bot first — see Discord Setup.

Docker Compose (Recommended)

1. Clone the repository:

   git clone https://github.com/FAZuH/pwr-bot
   cd pwr-bot

2. Copy the example environment file and set your values (see Configuration):

   cp .env-example .env

3. Start the bot. See Usage.

Docker Run

Prepare a .env file (see Configuration), then run the container:

mkdir -p pwr-bot/data pwr-bot/logs && cd pwr-bot
docker run -d \
  --name pwr-bot \
  --restart unless-stopped \
  --env-file .env \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/logs:/app/logs \
  ghcr.io/fazuh/pwr-bot:latest

To pass single variables instead of --env-file, use -e DISCORD_TOKEN="..." and -e ADMIN_ID="...".

Manual (Binary)

1. Download the binary for your platform from GitHub Releases.
2. Put a copy of .env-example next to the binary. Rename it to .env and set your values (see Configuration).
3. On Linux or macOS, make the binary executable:

   chmod +x pwr-bot

Preview

Feed updates in DMs Each new episode or chapter arrives as a rich embed: cover image, title, what changed, and a link to open it.
Bulk subscribe Subscribe to many titles at once. The bot confirms each one it added.
Subscription overview List every feed you follow with its source, last entry, and last update.
Server feed settings Per-guild panel: toggle feeds, pick the notification channel, and set who may subscribe.

Usage

Start the bot:

docker compose up -d    # Docker Compose install

./pwr-bot               # binary install

Check the log output (Docker Compose):

docker compose logs -f

Then try these commands in Discord:

• /feed subscribe <links> — subscribe to anime and manga feeds
• /feed list — show your subscriptions
• /vc stats — show your voice channel activity
• /about — show bot information

Command Registration

After the bot runs and joins your server, type !register_owner in a channel it can see. The bot responds with buttons — click Register in guild (immediate) or Register globally (can take up to one hour).

Note

!register_owner needs your Discord user ID to match ADMIN_ID. Users in other servers with the "Administrator" or "Manage Server" permission can run !register or !unregister.

Configuration

The bot reads a .env file next to the binary or mounted into the container. The values you must set are DISCORD_TOKEN and ADMIN_ID; DB_URL points at PostgreSQL. Every variable and its default is in Configuration reference.

Features

• Feed Subscriptions: Subscribe to updates from AniList, MangaDex, and Comick. The bot sends the updates to your DMs or to a server channel.
• Voice Activity Tracking: The bot measures the time members spend in voice channels. View server leaderboards with user rankings.
• External Plugins: Add features with plugins pinned in a catalog file. See Plugin catalog.

Docs

• Discord Setup — Developer Portal, intents, and invite URL
• Configuration reference — every environment variable
• Plugin catalog — plugins.toml format and startup behavior
• Deployment — database migrations, logs, and Docker volumes
• Architecture — system layers and module boundaries
• Changelog — release history
• Issues — bug reports and feature requests

License

pwr-bot is distributed under the terms of the MIT license.