Discord Message Forwarder

Lightweight bot that forwards messages from source Discord channels to your own server in real time. No data storage — pure relay.

How It Works

Source Server #channel  ──→  Bot (on_message)  ──→  Your Server #channel
                              │
                              ├── Uses webhook: shows original author name + avatar
                              ├── Forwards: text, embeds, attachments, replies
                              └── Zero storage: nothing saved, just relayed

Features

• Real-time forwarding — Messages appear in your channel instantly
• Webhook relay — Shows original author's name and avatar (not bot name)
• Configurable rules — Pick source and destination per channel
• Attachment support — Images, files, and embeds forwarded
• Reply context — Quoted replies preserved
• Dashboard UI — Web interface to manage forwarding rules
• Lightweight — SQLite for config only, no PostgreSQL/Redis needed
• ToS compliant — Uses official Bot Token, not user token

Quick Start

Prerequisites

• Docker and Docker Compose
• Discord Bot Token (Developer Portal)

Setup

1. Clone and configure:

git clone https://github.com/subkhanibnuaji/discord-bot.git
cd discord-bot
cp .env.example .env

2. Set your bot token in .env:

DISCORD_BOT_TOKEN=your_bot_token_here
SECRET_KEY=your_random_secret_key

3. Start:

make build && make up

4. Open http://localhost:3000, register an account, and create forwarding rules.

Without Docker

# Backend
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload

# Frontend (separate terminal)
cd frontend
npm install
npm run dev

Discord Bot Setup

1. Go to Discord Developer Portal
2. Create application → Bot → Add Bot
3. Enable: SERVER MEMBERS INTENT + MESSAGE CONTENT INTENT
4. Copy token to .env
5. OAuth2 → URL Generator:
   • Scopes: bot
   • Permissions: Read Messages/View Channels, Read Message History, Manage Webhooks, Send Messages
6. Invite bot to both source and destination servers

API Endpoints

Method	Endpoint	Description
POST	/api/v1/auth/register	Register admin
POST	/api/v1/auth/login	Login
GET	/api/v1/bot/status	Bot status
GET	/api/v1/bot/guilds	List servers
GET	/api/v1/bot/guilds/:id/channels	List channels
GET	/api/v1/forwarding	List rules
POST	/api/v1/forwarding	Create rule
PATCH	/api/v1/forwarding/:id	Update rule
DELETE	/api/v1/forwarding/:id	Delete rule
GET	/api/v1/forwarding/stats	Stats

API docs at /docs when running.

Tech Stack

Component	Technology
Backend	Python 3.11, FastAPI, discord.py 2.x, SQLAlchemy (SQLite)
Frontend	React 18, TypeScript, Vite, TailwindCSS
Auth	JWT + bcrypt
Deploy	Docker Compose, Nginx, Vercel (frontend)

Project Structure

discord-bot/
├── backend/
│   └── app/
│       ├── main.py                 # FastAPI + bot lifecycle
│       ├── config.py               # Settings
│       ├── api/v1/
│       │   ├── auth.py             # Login/register
│       │   ├── bot.py              # Bot status, guilds, channels
│       │   └── forwarding.py       # CRUD forwarding rules
│       ├── core/                   # Database (SQLite), security, exceptions
│       ├── models/                 # User + ForwardingRule
│       ├── schemas/                # Pydantic schemas
│       └── services/
│           └── discord_bot.py      # Bot + forwarding engine
├── frontend/
│   └── src/
│       ├── pages/                  # Dashboard, Rules, Servers, Settings
│       ├── components/forwarding/  # RuleList, CreateRuleForm
│       ├── hooks/useForwarding.ts  # React Query hooks
│       └── services/forwarding.ts  # API client
├── docker-compose.yml              # 3 services: backend, frontend, nginx
└── vercel.json                     # Frontend deploy config

Security

• Bot Token only (never user token)
• Token in .env only, never committed
• JWT auth for dashboard access
• No message data stored anywhere
• Webhook mentions disabled (AllowedMentions.none())

License

MIT