discord-meme-bot

A Discord meme bot for servers that are too lazy to post memes every week. No server. No hosting. Fully automated.

---

What is this?

This project automatically sends memes to a Discord channel using a secure webhook system.

Once set up, it runs completely in the background via GitHub Actions.

---

Quick Start (3 Steps)

1. Clone the repository

git clone https://github.com/ErkanSoftwareDeveloper/discord-meme-bot.git
cd discord-meme-bot

---

2. Install dependencies

pip install -r requirements.txt

---

3. Add Discord webhook (IMPORTANT)

You will NOT put the webhook in the code.

Instead, you will add it to GitHub Secrets.

---

Create Discord Webhook

In Discord:

1. Open your server
2. Go to the channel where memes should be posted
3. Click "Edit Channel"
4. Go to "Integrations"
5. Open "Webhooks"
6. Click "New Webhook"
7. Copy the Webhook URL

Keep this URL private. Treat it like a password.

---

GitHub Secrets Setup

Go to your repository:

Settings → Secrets and variables → Actions → New repository secret

Add:

Name: DISCORD_WEBHOOK_URL

Value: Your Discord webhook URL

IMPORTANT:

• Do NOT put this in code
• Do NOT commit .env
• Only use GitHub Secrets

---

How it runs

• GitHub Actions runs the bot automatically
• Python script executes
• Meme is sent to Discord
• Process finishes

You can also run it manually from the GitHub Actions tab.

---

GitHub Actions

The bot runs on schedule using GitHub Actions.

You can:

• Run it daily or weekly
• Trigger it manually
• Let it run automatically in the cloud

No hosting required.

---

Project Structure

discord-meme-bot/ ├── main.py ├── requirements.txt ├── .github/workflows/ └── README.md

---

Security Rules (IMPORTANT)

• Webhook URL = password
• Never share it
• Never commit .env
• If leaked, delete webhook and create a new one
• Always use GitHub Secrets

---

Common mistakes

If something doesn’t work, check:

• Secret name is exactly: DISCORD_WEBHOOK_URL
• Workflow file exists in .github/workflows/
• Dependencies installed
• Webhook URL is valid
• You did NOT hardcode secrets anywhere

---

Why GitHub Actions?

• No server needed
• Free automation
• Reliable scheduling
• Works 24/7 in the cloud

---

Summary

To set up:

1. Clone repo
2. Install dependencies
3. Add webhook to GitHub Secrets
4. Run Actions

Done. It works automatically.

---

Screenshot

---

License

MIT License