This is the home of eMuleBB, the compact public name for eMule broadband edition.

eMuleBB is its own product: a broadband-focused Windows eMule line for people who still care about eD2K, Kad, rare files, deliberate sharing, long-running desktop sessions, and local automation that respects native eMule behavior.

The organization around it is a practical P2P workshop. We build the desktop client, the release and test machinery, the public documentation, controller workflows, Windows build tracks for adjacent tools, and exploratory eD2K/Kad projects that keep the protocol knowledge sharp. More is coming. Stay tuned.

The current public release candidate, 0.7.3-rc.2, is published on GitHub Releases with matching suite bootstrap and aMuTorrent controller packages.

eMuleBB is a complete, privacy-first peer-to-peer suite for people who take file sharing seriously — built on classic eD2K/Kad, extended to BitTorrent, and designed to run safely and automatically.

• Two networks, one stack. A broadband-tuned eD2K/Kad client plus a BitTorrent companion, managed from a single controller — discover and move files across both worlds.
• Private by default. Peer traffic is pinned to your VPN tunnel, fail-closed — your real IP never touches a swarm.
• No central servers or indexers required. Kad and the BitTorrent DHT do the discovery; you run your own search. Nothing to shut down.
• Built for automation. A native REST API plus Torznab and qBittorrent-compatible adapters drop straight into Prowlarr, Sonarr, Radarr, and the aMuTorrent controller.

Today: run the Windows client (eMuleBB 0.7.3-rc.2) with the aMuTorrent controller and the one-line suite installer. Next: a multiplatform core (emulebb-rust) with autonomous Kad/eD2K indexing and cross-network library bridging — see the eMuleBB Suite direction below.

The suite is organized as clients behind shared controller contracts, so off-the-shelf tools drive every part without flattening native protocol behavior.

• eMuleBB — the C++ MFC Windows desktop client and current flagship of the 0.7.3 line.
• emulebb-rust — the headless, multiplatform eD2K/Kad core; the forward direction of the eMule-family work, and an autonomous Kad/eD2K indexer.
• qBittorrentBB — the BitTorrent-side companion: a full BT client with a DHT harvester and a Torznab index.
• aMuTorrent — the cross-network web-UI controller that manages the eD2K and BitTorrent clients together.

Both eD2K/Kad cores implement the same /api/v1 REST contract, and every client also exposes Torznab (indexer) and qBittorrent-compatible (download-client) surfaces, so Prowlarr and the Arr stack search and grab across both networks interchangeably. Data-plane traffic egresses a fail-closed VPN tunnel.

flowchart LR
    Amu["aMuTorrent<br/>web UI · cross-network controller"]
    Prowlarr["Prowlarr<br/>indexer federation"]
    Arr["Radarr · Sonarr<br/>Lidarr · Whisparr"]

    subgraph Cores["eD2K / Kad cores — shared /api/v1"]
        direction TB
        Cpp["eMuleBB<br/>C++ MFC desktop<br/>current flagship · 0.7.3"]
        Rust["emulebb-rust<br/>headless · multiplatform<br/>forward core + Kad/eD2K indexer"]
    end

    Qbbb["qBittorrentBB<br/>BitTorrent client<br/>DHT harvester + Torznab"]

    Ed2k[("eD2K / Kad")]
    Bt[("BitTorrent<br/>DHT · swarms")]
    Vpn{{"VPN — fail-closed data plane"}}

    Amu -->|"REST /api/v1"| Cores
    Amu -->|"qBit WebUI API"| Qbbb
    Arr -->|"qBit download client"| Cores
    Arr -->|"qBit download client"| Qbbb
    Prowlarr -->|"Torznab"| Cores
    Prowlarr -->|"Torznab"| Qbbb
    Prowlarr -. indexer sync .-> Arr

    Cores --> Vpn
    Qbbb --> Vpn
    Vpn --> Ed2k
    Vpn --> Bt

    style Rust fill:#dea584,stroke:#8b4513
    style Qbbb fill:#cfe8ff,stroke:#1c6fb4

This is the target suite architecture. Today, /api/v1 is shared by the C++ desktop and emulebb-rust, and the qBit /api/v2 and Torznab adapters ship as C++ desktop surfaces; emulebb-rust indexing and the qBittorrentBB companion are the active forward tracks.

RC2 is published on GitHub Releases. Choose one install path:

Use this path when you only want the eMuleBB desktop app.

1. Open emulebb-v0.7.3-rc.2.
2. Download emulebb-0.7.3-rc.2-x64.zip.
3. Extract the ZIP into a new version-specific folder, for example C:\Apps\eMuleBB\0.7.3-rc.2.
4. Run emulebb.exe.

Keep each version in its own application folder. Use a backed-up or disposable profile for RC testing and support testing.

Use this path when you want eMuleBB plus aMuTorrent, Prowlarr, Radarr, and Sonarr integration out of the box.

irm https://github.com/emulebb/emulebb/releases/download/emulebb-v0.7.3-rc.2/Bootstrap-eMuleBBSuite.ps1 | iex

The bootstrapper downloads and verifies the matching release package, extracts the suite installer, resolves the matching aMuTorrent RC2 package, and starts the install flow. Advanced options and verification details are in the Setup guide.

All RC2 builds and packaging happen in GitHub Actions and are published through GitHub Releases. The release includes ZIPs, manifests, SHA-256 evidence, SPDX SBOMs, diagnostics packages, the suite bootstrapper, and the bootstrapper SHA-256 asset. The bootstrapper verifies package hashes from the release manifests before installing.

We are open for testers now. Use the published RC2 packages if you want to help shake out real Windows profiles, large libraries, controller/API workflows, package contents, startup/shutdown behavior, and public-network regressions.

Use a disposable or backed-up profile when testing RC builds. Report crashes, freezes, broken packages, UI regressions, REST/controller problems, and repeatable live-network issues in emulebb/issues.

Useful reports include the package name, architecture, Windows version, profile type, exact launch command, repro steps, logs, diagnostic snapshots, and dumps for crashes, hangs, or memory-growth cases.

eMuleBB keeps the familiar desktop workflow at the center: servers, Kad search, shared files, upload queues, categories, known clients, and long-running control. Around that foundation it adds broadband-aware upload policy, safer large-library operation, authenticated REST automation, performance-minded defaults, and release evidence without creating an incompatible network fork.

The eMuleBB ecosystem includes an aMuTorrent fork focused on managing eMuleBB and validating controller-style workflows. It sits beside the desktop app instead of replacing it, and it keeps the native /api/v1 contract as the source of truth.

We also provide Windows build and validation work for aMule and MiniUPnP/miniupnpc. Those are ecosystem builds and distribution artifacts for users who want these tools in the same Windows P2P workflow.

The exploratory side includes the goed2k fork/server work, the emulebb-rust headless eMuleBB-family eD2K/Kad core that implements the common /api/v1 controller contract, and the broader p2p-overlord server-oriented direction. This is where deeper protocol, automation, and server-oriented P2P ideas can mature without pretending every experiment is already a stable end-user product.

eMuleBB is being built as a tested desktop product, not a patched source tree. Public claims stay tied to evidence: hosted fast CI, native tests, REST contracts, UI and resource checks, live eD2K/Kad scenarios, controller lanes, package provenance, GitHub Actions release packaging, GitHub Releases assets, SBOMs, SHA-256 hashes, manifests, diagnostics packages, and explicit operator gates.

Performance work is treated the same way. Claims are tied to concrete operating surfaces: upload-slot policy, queue/source limits, socket and file buffers, startup behavior, large shared libraries, long paths, controller responsiveness, and long-running Windows sessions.

The result is a focused P2P organization: conservative where compatibility matters, aggressive about validation, and serious about making classic eMule usable on modern broadband systems.

• emulebb - flagship desktop app and product source
• emulebb-setup - reproducible workspace setup
• emulebb-build - build, validation, and release orchestration
• emulebb-build-tests - native, Python, UI, REST, and live E2E tests
• emulebb-tooling - roadmap, backlog, policy, audits, and reference docs
• amutorrent - fork used for eMuleBB management and controller workflows
• goed2k-server - eD2K server work for deterministic tests and ecosystem services
• emulebb-rust - headless eMuleBB-family eD2K/Kad core implementing the common /api/v1 controller contract
• p2p-overlord-agents and p2p-overlord-be - exploratory headless/server-oriented P2P work

• aMule - Windows build and validation track for aMule users
• emulebb-miniupnp - Windows build and validation track for MiniUPnP/miniupnpc

• eMuleBB is the product identity; eMule broadband edition is the full product name.
• Keep stock eD2K/Kad protocol compatibility as the default.
• Improve the classic desktop app instead of replacing it with a rewrite.
• Treat REST and controller support as product features.
• Make Windows packages, build evidence, and release gates inspectable.
• Keep exploratory P2P work visible, useful, and clearly labeled.
• Sell the expertise by proving the work.