Manter eD2K e Kad práticos
A meta não é nostalgia nem reescrita. É manter o modelo clássico útil para sessões longas, ficheiros raros, seeding deliberado e utilizadores que ainda querem um cliente nativo.
O eMule clássico, afinado para a banda larga actual
eMuleBB mantém eD2K e Kad úteis para utilizadores exigentes.
Um eMule para utilizadores avançados, com uploads rápidos, grandes bibliotecas partilhadas, sessões Windows sempre activas e workflows locais de controlo sem abandonar a aplicação desktop conhecida.
Download releases
eMuleBB
eMuleBB nightlies
aMule
aMule nightlies
aMuTorrent release page
MiniUPnP/miniupnpc
Testing started
Nightly builds are open for testers
Public testing has started through nightly builds. Try the current packages, keep a disposable or backed-up profile, and report crashes, freezes, package issues, controller/API problems, and real-network regressions before 0.7.3-rc.1 is tagged.
eMule broadband edition, ou simplesmente eMuleBB, é uma linha de produto independente para quem ainda valoriza o modelo distribuído do eMule. Preserva os workflows clássicos de desktop e torna o cliente mais fácil de executar, observar, automatizar e validar em sistemas Windows actuais.
Porquê
Um cliente legado só é útil se ainda puder ser operado com confiança
eMuleBB é produto e também disciplina de engenharia: preservar uma aplicação nativa Windows com comportamento real de rede e rodeá-la de build, testes, documentação, automação e processo de release modernos.
Tornar explícitas as suposições antigas
Defaults de slots de upload, timeouts, buffers, bibliotecas grandes e exposição do WebServer ficam visíveis para revisão, teste e documentação.
Aplicar prova moderna a código legado
O workspace trata release como artefacto de engenharia: política de fonte, contratos OpenAPI, builds reproduzíveis, hashes, checks live e gates de operador precisam de fechar.
Funcionalidades
O que eMuleBB acrescenta ao cliente clássico
O foco está no comportamento visível para o operador: política de upload previsível, binding mais seguro, limites fixos de desempenho, bibliotecas grandes, automação local e evidência para o release planeado 0.7.3-rc.1.
Controlo de upload em banda larga
Metas limitadas de slots, reciclagem de slots fracos, leitura de ratios e controlos de seeding mantêm ligações rápidas úteis sem alterar o protocolo de upload eD2K.
Binding, NAT e política de exposição
Interface-aware binding, validação UPnP/NAT, HTTPS, regras de IP permitido e herança do WebServer mantêm superfícies remotas explícitas e testáveis.
Defaults actuais para sessões grandes
Buffers maiores, limites de queue/source, file buffering, timeouts, sync recursiva e orientação de long paths visam Windows actuais e bibliotecas grandes.
eD2K e Kad continuam em primeiro lugar
Pesquisa Server, global e Kad seguem como base nativa, com identidade Kad, tratamento de nós maus, limpeza e timing dentro de limites compatíveis.
REST e workflows de controlo
Endpoints JSON autenticados cobrem transferências, pesquisas, ficheiros partilhados, servidores, Kad, logs, categorias, uploads, estatísticas, preferências e shutdown controlado.
Evidência antes de pacotes públicos
A RC 0.7.3-rc.1 depende de testes nativos, contratos REST, lanes live de controladores, adversidade de rede, packaging e ensaios x64/ARM64.
Guia do produto
Um modelo curto de operação
Começar por bons hábitos do eMule
Usa listas fiáveis de servidores, inicializa Kad com cuidado, mantém pastas incoming e partilhadas previsíveis e preserva o workflow clássico antes da automação.
Ajustar o upload à ligação real
Define um limite finito de upload, escolhe uma meta realista de clientes e deixa a política de banda larga favorecer menos slots, mas mais fortes.
Cuidar de bibliotecas grandes
Usa Windows com long paths, mantém raízes de partilha limpas, acompanha ratios e trata ficheiros raros como decisões deliberadas de publicação.
Automatizar só em redes fiáveis
Activa WebServer/REST com API key, aplica binding e firewall com cuidado e usa controladores que respeitem a semântica nativa do eMule.
Acompanhar a prontidão do release
Trata a branch pública como pre-release activo até que os gates 0.7.3-rc.1, checks do operador e evidência live E2E indiquem o contrário.
Usar a documentação para detalhe
A página principal é compacta. Guia do produto, contrato REST, notas de banda larga e documentos de release vivem como Markdown no repositório de tooling.
Ler mais
Guias detalhados e documentos-fonte
Guia do produto eMuleBB
Visão geral para setup, afinação, automação e uso atento ao release.
Guia de setup
Modelo de instalação, perfil inicial e notas práticas de arranque.
Guia de rede
Referência de eD2K, Kad, binding, UPnP, firewall e diagnóstico de ligação.
Guia de partilha
Directórios partilhados, shares monitorizadas, bibliotecas grandes e ficheiros de política.
Guia de downloads e pesquisa
Modos de pesquisa, confiança nos resultados, categorias e workflows avançados.
Guia de controladores e REST
Uso de controladores locais fiáveis e limites da automação.
Contrato REST API
Contrato legível da superfície JSON autenticada.
Contratos de adaptadores REST
Superfície qBittorrent-compatible e Torznab para autores de controladores.
Guia de resolução de problemas
Checks por sintoma para Low ID, rede, partilha e automação.
Painel do release 0.7.3-rc.1
Gates planeados da RC, evidências e regras de prontidão.
Superfície de controlo
REST automation sem substituir a aplicação desktop
A linha de release de banda larga expõe uma JSON API /api/v1 orientada a recursos a partir do listener WebServer existente. Autentica com X-API-Key, entrega envelopes JSON e mantém alterações de estado do eMule mediadas pela aplicação.
- Transferências
- Pesquisas
- Servidores
- Kad
- Ficheiros partilhados
- Uploads
- Categorias
- Logs
- Estatísticas
- Preferências
Estado do release
A versão pública 0.7.3-rc.1 está planeada, tem gates e ainda não foi lançada
O primeiro alvo público é 0.7.3-rc.1. Ainda não foi lançado. A prova final está em curso e o estado público segue os documentos activos.
A prova cobre validação do workspace, builds Debug e Release x64, builds Release ARM64, binários de teste, geração de pacote, worktree limpa e hashes SHA-256.
Os gates cobrem suites nativas, contrato REST, drift OpenAPI, requests malformados, automação UI, E2E live de controladores, Release x64 live E2E completo e adversidade de rede.
Release packages carry package-local SBOM.spdx.json plus sidecar *.sbom.spdx.json files, with manifest hashes that tie software contents to the exact package evidence.
aMuTorrent, Prowlarr, Radarr, Sonarr e lanes compatíveis com qBittorrent provam automação sem enfraquecer o contrato nativo /api/v1.
O comportamento eD2K/Kad original permanece default. Banda larga, REST e controladores são acrescentados à volta desse objectivo de compatibilidade.
Método de implementação
Modernizar à volta do núcleo legado e depois provar o resultado
O estilo é deliberadamente conservador. eMuleBB muda política local, limites, diagnósticos, limites de API e disciplina de release mantendo compatibilidade eD2K/Kad como default.
Sem drift casual de protocolo
Mudanças Kad e eD2K ficam em rotas locais, timing, validação e controlo. Wire formats, opcodes e workflows nativos são limites de compatibilidade.
Defaults fixos e revistos
Suposições modernas de bandwidth, memória, socket, queue e timeout aparecem como defaults explícitos ou preferências avançadas.
Contratos de controlo, não screen scraping
A JSON API autenticada segue contrato OpenAPI, rejeita entradas malformadas e encaminha mutações nativas pela aplicação.
Evidência antes de etiquetas
O processo regista comandos, commits, logs, caminhos de pacote, hashes, evidência live e decisões do operador para que o tag seja um resultado verificado.
Workspace público
Repositórios principais
emulebb
aplicação desktop e fonte do produto
emulebb-setup
setup reproduzível do workspace
emulebb-build
orquestração de build, validação e release
emulebb-build-tests
testes nativos, Python, UI, REST e live E2E
emulebb-tooling
roadmap, backlog, políticas, auditorias e docs de referência
amutorrent
fork used for eMuleBB management and controller workflows
goed2k-server
eD2K server work for deterministic testing and ecosystem services
p2p-overlord-agents
exploratory agents for the p2p-overlord P2P suite
p2p-overlord-be
exploratory headless Rust eD2K/Kad client backend work
aMule Windows builds
Windows build and validation track for aMule users
emulebb-miniupnp
Windows build and validation track for MiniUPnP/miniupnpc
Cultura do projecto
A equipa que impede a queue de virar teatro de desempenho
01
Terapeuta de slots de upload
Ajuda slots fracos a processar os sentimentos pelo tempo exacto antes de os devolver à queue com prancheta e cooldown.
02
Arquivista de bootstrap Kad
Mantém a lista sagrada de nós que funcionaram uma vez em 2007 e merecem uma segunda oportunidade bem validada.
03
Porteiro dos gates de release
Só deixa builds entrar se trouxerem testes, evidência live e uma boa explicação sobre o último socket.