MEGA Monitor 🤖

A lightweight bot that monitors public MEGA.nz folders and sends updates to a Discord webhook. It tracks all updates in a Mega folder and includes a detailed report with each notification.

---

✨ Features

• Detects all changes in MEGA folders
• Sends update reports via Discord webhook
• Supports multiple MEGA links
• Easy to run via Docker or manually with Python

---

📦 Docker Deployment

1. Create a folder and inside it, add a docker-compose.yml:

services:
  mega-monitor:
    container_name: mega-monitor
    image: ghcr.io/mega-monitor/mega-monitor:latest
    environment:
      - MEGA_LINK_DEMO1=https://mega.nz/folder/albums # The link to the Mega folder
      # - MEGA_LINK_DEMO2=https://mega.nz/folder/movies # Optional additional links
      - DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/xxx/yyy # Your discord webhook url
      # - MENTION_USER_IDS=123456789012345678,987654321098765432 # Optional users to tag in the webhook message
      # - CHECK_INTERVAL_SECONDS=3600 # How often to check the Mega folders in seconds (Default: 1 hr)
      - LOG_LEVEL=INFO
      - TIMEZONE=America/New_York
    volumes:
      - ./data:/app/data # The data folder where changes are stored
    restart: unless-stopped

ℹ️ Each MEGA_LINK_<NAME> should be unique.

---

👨‍💻 Manual Python Usage

1. Clone the repo and setup dependencies:

git clone https://github.com/mega-monitor/mega-monitor.git
cd mega-monitor

2. Create a .env file in the root directory:

MEGA_LINK_DEMO1=https://mega.nz/folder/songs
# MEGA_LINK_DEMO2=https://mega.nz/folder/movies
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/xxx/yyy
# MENTION_USER_IDS=123456789012345678,987654321098765432
# CHECK_INTERVAL_SECONDS=3600
LOG_LEVEL=INFO
TIMEZONE=America/New_York

3. Install the Python dependencies:

pip install -r requirements.txt

3. Run the script:

python -m mega_monitor

👩‍💻 Contributing & Support

Feel free to open an issue if you hit any snags.

To contribute:

1. Fork the repository.
2. Create a new branch from main with a descriptive name.
3. Commit your changes and open a Pull Request, detailing your feature or fix.

Thank you for helping improve Mega monitor!