Skip to content

devjohnatas/ReadStitch

Repository files navigation

ReadStitch Logo

ReadStitch

A fusão entre SmartStitch e Waifu2x para Webtoons, Manhwas e Manhuas
Baixe raws, una imagens, corte capítulos e melhore a qualidade com upscaling — tudo em um só lugar.

Latest Release CI Release Workflow Downloads License


O que é o ReadStitch?

O ReadStitch é um projeto que nasceu da fusão de dois poderosos projetos open-source:

  • 🧵 SmartStitch — ferramenta inteligente para unir e cortar imagens de webtoons e manhwas com detecção avançada de pixels.
  • 🖼️ Waifu2x-Extension-GUI — software de upscaling de imagens com remoção de artefatos visuais e aumento de resolução via IA.

Combinando o melhor dos dois mundos, o ReadStitch entrega uma pipeline completa para quem consome ou trabalha com webtoons, manhwas e manhuas: desde o download das raws até o processamento e corte das imagens para leitura.


✨ Funcionalidades

📥 Download de Raws

Baixe capítulos diretamente dos principais sites de leitura:

🌐 Sites em Inglês (EN)

Site Suporte
Asura Scans
Kakao Webtoon
Naver Webtoon
Webtoon (LINE)
QisManga
Comix
Vortex Scans
HiveToons
Piccoma (login)
Kagane
Utoon
GenzToons
Tapas
RoliaScan
FlameComics
ResetScans
MangaDex
Elftoon

🇧🇷 Sites em Português (BR)

Site Suporte
Verdinha (login)
Mediocretoons (login)
Capitoons
Pluma Comics
Geass Comics
Lycan Toons
Inkapk
Nexus
Hipercool
Vegitoons
Astratoons

💡 Sites com login exigem que você informe suas credenciais na aba Baixador → Credenciais de Acesso. O site é detectado automaticamente pela URL colada — não é necessário selecionar manualmente!

💡 Quer pedir suporte para um novo site? Abra uma Issue descrevendo o site e ela será avaliada!

🧵 Unir e Cortar (Stitch + Slice)

Baseado no SmartStitch, o ReadStitch une imagens menores em uma tira longa e depois as fatia em dimensões ideais para leitura — evitando cortes no meio de painéis ou caixas de texto.

  • Detecção Avançada: Algoritmos de comparação de pixels para cortes inteligentes.
  • Processamento em Lote: Múltiplas pastas processadas simultaneamente.
  • Múltiplos Formatos: .png, .jpg, .webp, .bmp, .psd, .tiff e .tga.

🖼️ Upscaling com Waifu2x

Baseado no Waifu2x-Extension-GUI, o ReadStitch aplica upscaling de imagens com inteligência artificial:

  • Remoção de artefatos de compressão.
  • Aumento de resolução sem perda de nitidez.
  • Suporte a múltiplos modelos de IA.

⚙️ Outras Funcionalidades

  • Marcas d'água: Inserção de overlay, cabeçalhos e rodapés automáticos.
  • Integração com o Windows: Adicione o ReadStitch ao menu de contexto do Explorer.
  • Atualização Automática: Sincronização com o repositório Git ou via releases.

Como Utilizar

Interface Gráfica (Releases)

  1. Acesse a seção de Releases e faça o download da versão mais recente.
  2. Descompacte o arquivo e inicie o executável ReadStitch.exe.
  3. Use a aba de Download para baixar raws de um site suportado.
  4. Use a aba de Processamento para unir, cortar e aplicar upscaling nos capítulos.

Rodando via Código-fonte

  1. Instale o Python 3.11 ou superior.
  2. Clone o repositório, crie um ambiente virtual e instale as dependências:
    git clone https://github.com/devjohnatas/ReadStitch.git
    cd ReadStitch
    
    # Crie o ambiente virtual
    python -m venv venv
    
    # Ative o ambiente virtual (Windows PowerShell)
    .\venv\Scripts\activate
    # Ou ative o ambiente virtual (Linux/Mac)
    # source venv/bin/activate
    
    # Instale as dependências
    pip install -r requirements.txt
  3. Execute o programa (com o ambiente virtual ativo):
    # Interface gráfica
    python ReadStitchGUI.py
    
    # Modo console
    python ReadStitchConsole.py -i "./chapter" -sh 7500 -t .png

Gerando o Executável (.exe)

Caso queira compilar o aplicativo após realizar modificações no código:

# Com o ambiente virtual ativado, rode o PyInstaller usando o arquivo .spec
pyinstaller ReadStitch.spec

O executável final e os arquivos necessários estarão disponíveis na pasta dist/ReadStitch/.


Comandos do Console (CLI)

O modo console é recomendado para integrações e rotinas de automação:

python ReadStitchConsole.py [-h] -i INPUT_FOLDER -sh SPLIT_HEIGHT
                             [-t {.png,.jpg,.webp,.bmp,.psd,.tiff,.tga}]
                             [-cw CUSTOM_WIDTH]
                             [-dt {none,pixel}]
                             [-s [0-100]]
                             [-lq [1-100]]
                             [-ip IGNORABLE_PIXELS]
                             [-sl [1-100]]

Como Contribuir

O ReadStitch é um projeto de código aberto. Toda contribuição é bem-vinda!

  • 🐛 Relatar Problemas: Crie uma Issue descrevendo o problema, incluindo os passos de reprodução e os logs da pasta __logs__.
  • 🌐 Pedir Novo Site: Quer que um site específico seja suportado no downloader? Abra uma Issue com o nome e URL do site.
  • 💡 Sugestões: Novas funcionalidades e melhorias são sempre bem-vindas no painel de Issues.
  • 🔧 Pull Requests: Contribuições diretas no código podem ser feitas via Pull Request na branch principal.

Créditos

Este projeto é construído sobre o trabalho incrível de:


Licença

Este software é distribuído sob a licença MIT. Para mais informações, consulte o arquivo LICENSE.

About

ReadStitch: SmartStitch + Waifu2x com download de raws EN, KR e PT.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages