Mularr

Mularr is a powerful integration for aMule that provides a functional web interface with a nostalgia-infused retro touch. It bridges the gap between classic P2P and modern automation tools by offering qBittorrent-compatible APIs and Torznab indexers, making it seamless to use aMule with apps like Sonarr and Radarr.

It also includes an extension to use the Telegram Network as a download provider. This requires a real account (not a bot) to access groups/channels with media files.

Key Features

• *Arr Integration: Native support for Sonarr/Radarr via qBittorrent & Torznab API compatibility.
• Docker Ready: Easy deployment using Docker and Docker Compose.
• Telegram Integration:
  • Notifications: Get notified of your downloads via a Telegram bot.
  • Provider: Use the Telegram network for searching and downloading files.
• 🛡️ VPN Ready: Built-in support for Gluetun health checks and automatic port updates.
• Retro-Style Web Interface: A fully responsive UI with a nostalgic Windows XP feel. Includes multiple themes like Classic and Windows 11 (Experimental). Built with Chispa.

Quick Start with Docker 🐳

The easiest way to get Mularr running is using Docker Compose:

services:
    mularr:
        image: ghcr.io/joecarl/mularr
        container_name: mularr
        restart: unless-stopped
        ports:
            - '8940:8940'
        volumes:
            - ./data:/app/data

    # Check docker-compose.example.yml for a full configuration guide

Run it with:

docker-compose up -d

Access the web UI at http://localhost:8940.

Screenshots

Integrate with Sonarr / Radarr

You can configure Mularr as both an indexer and a download client.

[!TIP] In Sonarr/Radarr's configuration forms, click Show Advanced to reveal all required fields.

To configure as indexer use the following settings:

• Type: Torznab
• API Path: /api/as-torznab-indexer

To configure as download client use the following settings:

• Type: qBittorrent
• URL Base: /api/as-qbittorrent

Tech Stack

Mularr is built primarily with TypeScript.

💻 Development Setup

If you want to contribute or run Mularr you need docker & VS Code devcontainers. Open the project in the devcontainer and it automatically installs the needed dependencies.

Then you can start the application in dev mode:

1. Backend Setup

cd backend
npm run dev

2. Frontend Setup

cd frontend
npm run dev

[!WARNING] Do not run npm install in the root folder. Install dependencies separately in backend/ and frontend/.

Production Build

The included Dockerfile handles everything for you. It builds the frontend and bundles it with the backend for a single-image deployment.

docker build -t mularr .

Contributing

To contribute, follow the standard process:

1. Fork the Project
2. Create your feature branch & Commit your changes
3. Open a Pull Request

Any contributions you make are greatly appreciated.

License

MIT

Made with ❤️ for the P2P Community