Início rápido

Arquivos-fonte

Esta página foi gerada com base nos seguintes arquivos-fonte:

• README.md
• docs/installation.md
• docs/getting-started.md
• core/config.go
• core/bind.go
• core/system_linux.go
• core/system_darwin.go
• core/system_windows.go
• core/app.go
• core/http.go

O res-downloader é uma ferramenta de download de recursos multiplataforma desenvolvida em Go com o framework Wails, projetada para capturar e baixar diversos tipos de mídia através de interceptação de tráfego de rede. A aplicação funciona como um proxy local que monitora, filtra e disponibiliza recursos de vídeo, áudio, imagem e streams de diversas plataformas (README.md:17-28).

A ferramenta destaca-se pela interface gráfica intuitiva e pela capacidade de suportar múltiplas plataformas de conteúdo, incluindo WeChat Video, mini-programas, Douyin, Kuaishou, Xiaohongshu, Kugou Music e QQ Music, entre outros. O mecanismo de proxy permite capturar recursos mesmo em redes restritas (README.md:29-41).

Visão geral do projeto

O res-downloader opera através de um servidor proxy HTTP local que intercepta requisições de rede e filtra recursos baseando-se em tipos MIME e padrões de URL. A arquitetura utiliza o framework Wails para fornecer uma interface gráfica nativa em Windows, macOS e Linux.

Funcionalidades principais

• Captura via proxy: Interceptação automática de tráfego HTTP/HTTPS através de proxy local configurado no sistema
• Suporte multi-formato: Vídeo (MP4, WebM, AVI, MPEG), áudio (MP3, WAV, FLAC, AAC), imagem (PNG, JPEG, WebP, AVIF), streams M3U8/MPD e documentos
• Compatibilidade estendida: Integração com plataformas populares asiáticas como WeChat Video, Douyin, Kuaishou e serviços de música
• Interface gráfica nativa: Aplicação desktop construída com Wails para melhor performance e integração com o sistema operacional

Compatibilidade de plataformas

O projeto oferece documentação online e versões alternativas, incluindo uma versão Mini que utiliza o navegador padrão para exibir a interface e uma versão Electron legada para compatibilidade com Windows 7 (README.md:29-41).

Download e instalação

Links de download

Os arquivos de instalação estão disponíveis através de múltiplas fontes:

• GitHub Releases: https://github.com/putyy/res-downloader/releases
• Lanzou Cloud: https://wwjv.lanzoum.com/b04wgtfyb (senha: 9vs5)

Importante: Usuários de Windows 7 devem utilizar a versão 2.3.0 (versão Electron legada), disponível na branch old do repositório (docs/getting-started.md:1-5).

Seleção de arquivos por sistema operacional

Instalação no Windows

1. Baixe o arquivo .exe apropriado para sua arquitetura (geralmente win_amd64.exe ou x64-installer.exe)
2. Execute o instalador com duplo-clique
3. Crítico: Na primeira execução, clique com o botão direito e selecione "Executar como administrador"
4. Permita a instalação do certificado SSL quando solicitado
5. Autorize o acesso à rede nas configurações de firewall

O Windows pode exibir alertas de segurança durante a instalação. Feche programas de antivírus ou firewall de terceiros antes da instalação para evitar conflitos (docs/installation.md:1-11).

Instalação no macOS

1. Baixe o arquivo .dmg do GitHub Releases ou Lanzou Cloud
2. Abra o arquivo DMG com duplo-clique
3. Arraste o ícone res-downloader para a pasta Applications
4. Na primeira execução, autorize a instalação do certificado e permita acesso à rede

Se a captura de recursos não funcionar corretamente, desative o firewall do macOS temporariamente em Preferências do Sistema > Segurança e Privacidade > Firewall (docs/installation.md:1-11).

Instalação no Linux

Ubuntu/Debian (pacote DEB):

bash
1# Baixe o arquivo .deb correspondente
2# Instale com apt (substitua a versão conforme necessário)
3sudo apt install ./res-downloader_3.0.2_linux_x64.deb

Executável portátil:

bash
1# Dê permissão de execução ao arquivo
2chmod +x ./res-downloader_3.0.2_linux_x64
3
4# Execute com privilégios de root para configuração inicial
5sudo ./res-downloader_3.0.2_linux_x64

A execução com sudo é necessária para instalar o certificado CA no repositório do sistema e configurar o proxy de rede via gsettings (docs/installation.md:13-20).

O código detecta automaticamente a distribuição Linux (Deepin, Arch, ou padrão Debian/Ubuntu) e ajusta os caminhos de instalação de certificado e comandos de atualização conforme necessário (core/system_linux.go:85-104).

Primeiros passos

Fluxo de inicialização rápida

正在加载图表渲染器...

Passos iniciais de uso

1. Primeira execução: Execute a aplicação com privilégios elevados (Windows: botão direito > Executar como administrador; Linux/macOS: use sudo)
2. Permissões: Aceite a instalação do certificado SSL e permita o acesso à rede quando solicitado
3. Ativar proxy: Na interface principal, clique no botão "Iniciar Proxy" localizado no canto superior esquerdo
4. Selecionar tipos de recurso: Escolha os tipos de mídia a capturar (padrão: todos)
5. Capturar recursos: Abra o navegador ou aplicação de destino (WeChat Video, páginas web, mini-programas)
6. Visualizar resultados: Retorne à interface do res-downloader para ver a lista de recursos capturados

A configuração padrão do proxy utiliza o endereço 127.0.0.1 na porta 8899, definidos em core/config.go:55-57 (docs/getting-started.md:7-18).

Configuração de proxy

O proxy HTTP é configurado automaticamente pelo aplicativo através de comandos do sistema operacional. A configuração padrão utiliza:

• Host: 127.0.0.1
• Porta: 8899

No Linux (GNOME/Unity), o proxy é configurado via gsettings:

bash
1# Comandos executados automaticamente pelo aplicativo
2gsettings set org.gnome.system.proxy mode manual
3gsettings set org.gnome.system.proxy.http host 127.0.0.1
4gsettings set org.gnome.system.proxy.http port 8899
5gsettings set org.gnome.system.proxy.https host 127.0.0.1
6gsettings set org.gnome.system.proxy.https port 8899

No macOS, o proxy é configurado através do comando networksetup para cada serviço de rede ativo (core/system_linux.go:44-50).

Permissões necessárias

Windows: Feche todos os softwares de segurança de terceiros (antivírus, firewall) antes da instalação. A primeira execução deve ser como administrador para configurar o certificado raiz e as regras de firewall (docs/getting-started.md:7-18).

macOS: Se a captura não funcionar, desative o firewall em Preferências do Sistema > Segurança e Privacidade > Firewall (docs/getting-started.md:7-18).

Execução e verificação

Iniciando a aplicação

Windows:

bash
1# Navegue até a pasta de instalação
2cd "%LOCALAPPDATA%\Programs\res-downloader"
3
4# Execute (primeira vez como admin)
5res-downloader.exe

macOS:

bash
1# Abra via Launchpad ou terminal
2open -a res-downloader

Linux (executável portátil):

bash
1# Execute o binário
2./res-downloader_3.0.2_linux_x64

Verificação de funcionamento

Para confirmar que o proxy está funcionando corretamente:

1. Abra a aplicação e clique em "Iniciar Proxy"
2. Verifique se o ícone de status muda para "ativo" (geralmente indicador verde)
3. Abra um navegador web e acesse qualquer página com mídia (ex: YouTube, Vimeo)
4. Retorne ao res-downloader e verifique se recursos aparecem na lista
5. O endereço de proxy 127.0.0.1:8899 deve estar ativo nas configurações de rede do sistema

Saída esperada: A lista de recursos deve exibir URL, tipo de mídia, tamanho e status de captura para cada recurso detectado (README.md:48-57).

Configuração manual de proxy (fallback)

Se a configuração automática falhar, configure manualmente:

Windows:

1. Configurações > Rede e Internet > Proxy
2. Ativar "Usar um servidor proxy"
3. Endereço: 127.0.0.1, Porta: 8899
4. Salvar

macOS:

1. Preferências do Sistema > Rede > Avançado > Proxies
2. Ativar "Web Proxy (HTTP)" e "Secure Web Proxy (HTTPS)"
3. Servidor: 127.0.0.1, Porta: 8899

Linux (GNOME):

1. Configurações > Rede > Proxy de rede
2. Selecionar "Manual"
3. HTTP Proxy: 127.0.0.1:8899
4. HTTPS Proxy: 127.0.0.1:8899

A porta padrão 8899 é definida em core/config.go:56 e pode ser modificada nas configurações da aplicação (core/config.go:55-57).

Solução de problemas

A aplicação não consegue interceptar recursos

Sintomas: A lista de recursos permanece vazia mesmo após navegar em páginas com mídia.

Causas prováveis:

1. Proxy não está ativo na aplicação
2. Proxy do sistema configurado incorretamente
3. Firewall bloqueando conexões locais
4. Certificado SSL não instalado corretamente

Soluções:

• Verifique se o botão "Iniciar Proxy" foi clicado e o status indica "ativo"
• Confirme manualmente as configurações de proxy do sistema: endereço 127.0.0.1, porta 8899 (README.md:76-80)
• No Windows, execute como administrador e permita acesso no firewall
• No macOS, desative o firewall temporariamente
• Reinstale a aplicação para reinstalar o certificado

Sem conexão à internet após fechar a aplicação

Sintomas: Navegador e outras aplicações não conseguem acessar a internet após fechar o res-downloader.

Causa: O proxy do sistema permanece configurado para 127.0.0.1:8899, mas o servidor não está mais em execução.

Solução: Desative manualmente o proxy nas configurações de rede do sistema operacional (README.md:82-84):

• Windows: Configurações > Rede e Internet > Proxy > Desativar "Usar um servidor proxy"
• macOS: Preferências do Sistema > Rede > Avançado > Proxies > Desmarcar todas as opções
• Linux: Configurações > Rede > Proxy de rede > Selecionar "Desativado"

Downloads lentos ou falhas em arquivos grandes

Sintomas: Download de vídeos longos ou arquivos grandes falha ou é extremamente lento.

Solução: Utilize um gerenciador de downloads dedicado para baixar a URL capturada:

1. No res-downloader, copie a URL do recurso
2. Cole em um gerenciador de downloads como:
   • Neat Download Manager
   • Motrix
3. Para recursos de WeChat Video, utilize a opção "Descriptografar vídeo" disponível na interface após o download (README.md:69-74)

Recursos M3U8 não reproduzem

Sintomas: Arquivos M3U8 capturados não podem ser reproduzidos diretamente.

Solução: Utilize ferramentas especializadas para streams HLS:

• Preview online: m3u8play.com
• Download de vídeo: m3u8-down.gowas.cn (README.md:60-63)

Streams de直播 (live) não podem ser baixados

Sintomas: Streams ao vivo aparecem na lista mas não podem ser baixados como arquivo.

Solução: Para streams de直播 (live broadcasting), utilize OBS Studio para gravação:

1. Baixe e instale OBS Studio
2. Adicione a URL do stream como fonte de mídia
3. Configure a gravação e inicie a captura (README.md:65-67)

Erro de certificado no Linux

Sintomas: Erro ao instalar certificado em distribuições Linux não listadas.

Solução manual:

bash
1# Copie o certificado para o diretório apropriado
2sudo cp /caminho/para/res-downloader/cert.crt /usr/local/share/ca-certificates/
3
4# Atualize o repositório de certificados
5sudo update-ca-certificates

Para Arch Linux, o caminho é /usr/share/ca-certificates/trust-source/ e o comando é update-ca-trust (core/system_linux.go:99-101).

Próximos passos

Após configurar e verificar o funcionamento básico do res-downloader, explore as seguintes funcionalidades avançadas:

Configurações avançadas

• Proxy upstream: Configure um proxy de cadeia para redes corporativas ou restritas
• Filtros de recurso: Ajuste os tipos MIME capturados nas configurações
• Diretório de download: Personalize o local de salvamento dos arquivos
• User Agent: Modifique o identificador do navegador para compatibilidade

Recursos adicionais

• Documentação online: https://res.putyy.com/
• Comunidade: Grupo de discussão (QR code em https://www.putyy.com/app/admin/upload/img/20250418/6801d9554dc7.webp)
• Suporte: WeChat AmorousWorld (mencionar "github")
• Issues: GitHub Issues
• Fórum: Discussão no fórum Aixiang (README.md:86-89)

Versões alternativas

• Versão Mini: Interface web que utiliza o navegador padrão (resd-mini)
• Versão Electron (legada): Compatível com Windows 7 (branch old do repositório)