Quick Start

Source Files

This page is generated from the following source files:

• README.md
• docs/getting-started.md
• docs/installation.md
• core/app.go
• core/proxy.go
• core/downloader.go
• core/aes.go
• core/rule.go
• core/bind.go
• core/http.go

res-downloader is a cross-platform resource sniffer and download tool built with Go and Wails. It captures network resources through a local proxy, supporting video, audio, images, m3u8, and live streams from platforms like WeChat Channels, Mini Programs, Douyin, Kuaishou, and Xiaohongshu (README.md:17-27).

System Requirements

The application supports Windows, macOS, and Linux platforms. Windows 7 users must use version 2.3.0 specifically, as newer versions require newer system libraries (README.md:40).

Platform-specific requirements:

The application requires network access permissions during installation and operation. Certificate installation must be allowed for HTTPS traffic interception (docs/getting-started.md:8).

Download and Installation

Download Sources

Official releases are available through multiple channels:

• GitHub Releases: Latest version (README.md:38)
• Lanzou Cloud: Mirror download with password 9vs5 (README.md:39)

Platform-Specific Installation

Windows Installation:

1. Download the .exe installer (look for win_amd64.exe or x64-installer.exe suffixes)
2. Double-click to run the installer
3. Close all security software (antivirus, system managers) before installation
4. On first launch, right-click and select "Run as Administrator" (docs/installation.md:6-8)

macOS Installation:

1. Download the .dmg file
2. Double-click to open the disk image
3. Drag res-downloader into the Applications folder (docs/installation.md:9-11)

Linux Installation:

For Debian/Ubuntu systems, install the .deb package:

bash
1sudo apt install res-downloader_3.0.2_linux_x64.deb

For portable execution:

bash
1chmod +x ./res-downloader_3.0.2_linux_x64
2sudo ./res-downloader_3.0.2_linux_x64

(docs/installation.md:13-20)

Note: Replace the version number in filenames with the actual downloaded version.

Quick Start Guide

Minimum Viable Path

The fastest way to start capturing resources:

1. Launch the application with administrator/sudo privileges
2. Click "Start Proxy" in the top-left corner of the main interface
3. Open the target resource (WeChat Channels, web pages, Mini Programs, etc.) in an external browser or application
4. Return to the application to view captured resources in the list

(docs/getting-started.md:9-12)

Complete Startup Workflow

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

Resource Type Selection

By default, all resource types are captured. The application supports:

• Video files
• Audio files
• Images
• m3u8 playlists
• Live streams

Users can filter specific resource types through the interface before starting capture (README.md:54).

Proxy and Certificate Configuration

System Proxy Settings

The application configures a local proxy for traffic interception. The default proxy settings are:

(README.md:79-80)

The proxy is managed through system-level configuration. When "Start Proxy" is clicked, the application calls OpenSystemProxy() which sets the system proxy and marks IsProxy as true (core/app.go:156-165). When the application exits or proxy is stopped, UnsetSystemProxy() removes the system proxy configuration (core/app.go:168-178).

Certificate Trust Requirements

HTTPS traffic interception requires a root certificate. The application embeds a self-signed certificate (core/app.go:58-81) that must be trusted by the system.

Certificate installation requirements:

• During installation: Allow the certificate installation prompt
• Windows: May require explicit "Yes" confirmation for certificate trust
• macOS: May require approval in Keychain Access

If certificate installation fails, the application logs the error and may not capture HTTPS traffic properly (core/app.go:143-154).

Network Access Permissions

The application requires network access for:

1. Local proxy server: Listens on port 8899 for incoming traffic
2. External requests: Forwards traffic to target servers
3. Resource downloads: Downloads captured resources to local storage

Firewall or security software must allow the application to accept incoming connections and make outgoing connections (docs/getting-started.md:8).

Verification and Testing

Confirming Proxy Operation

To verify the proxy is working correctly:

1. Check proxy status: The "Start Proxy" button should show an active state
2. Verify system proxy: Check system proxy settings show 127.0.0.1:8899
3. Test capture: Open a video or image in a browser and check if it appears in the resource list

Expected Behavior

When functioning correctly:

• Resources appear in the application list within seconds of loading in the browser
• Resource URLs, types, and sizes are displayed
• Download options are available for each captured resource

(docs/getting-started.md:12)

Log Verification

The application maintains logs in the user directory. The log location is determined by UserDir, which is set to the system's standard configuration directory (core/app.go:112). Check logs for error messages if capture fails.

Common Issues and Troubleshooting

Issue 1: Application Cannot Intercept Resources

Symptoms: No resources appear in the list despite browsing content.

Diagnostic steps:

1. Verify system proxy is set to 127.0.0.1:8899 (README.md:78-80)
2. Confirm proxy button shows "started" state
3. Check if certificate was installed successfully

Solutions:

• Restart the application with administrator privileges
• Reinstall the certificate by deleting install.lock in the user directory
• On macOS, disable the firewall if enabled (docs/getting-started.md:16)

Issue 2: No Internet After Closing Application

Symptoms: Web browsers cannot load pages after the application is closed.

Cause: System proxy settings remain configured to point to the closed proxy server.

Solution: Manually disable system proxy settings in the operating system's network configuration (README.md:84).

The application attempts to clean up proxy settings on exit via OnExit() which calls UnsetSystemProxy() (core/app.go:134-141), but abnormal termination may leave settings unchanged.

Issue 3: Slow Downloads or Large File Failures

Symptoms: Downloads are slow, pause unexpectedly, or fail for large files.

Recommended solutions:

1. Use external download managers:
   • Neat Download Manager
   • Motrix

(README.md:71-73)

2. Copy the resource URL from the application and paste it into a download manager
3. For WeChat Channels videos, use the "Video Decryption" option after download (README.md:74)

Issue 4: Windows Security Software Conflicts

Symptoms: Installation fails or application crashes on Windows.

Solution: Close all security manager software (360, Tencent PC Manager, etc.) before installation and first launch (docs/getting-started.md:14).

Issue 5: macOS Firewall Blocking

Symptoms: Proxy starts but no traffic is captured on macOS.

Solution: Disable the macOS firewall in System Preferences > Security & Privacy > Firewall (docs/getting-started.md:16).

Advanced Configuration

Upstream Proxy

The application supports chaining through an upstream proxy. If UpstreamProxy is configured in settings and OpenProxy is enabled, the application forwards traffic through the specified proxy (core/proxy.go:126-132).

m3u8 and Live Stream Resources

For m3u8 video resources:

• Preview: Use m3u8play for online playback
• Download: Use m3u8-down for specialized m3u8 downloading

(README.md:62-63)

For live stream resources, OBS Studio is recommended for recording (README.md:67).

Next Steps

After completing the quick start:

1. Explore resource filtering: Learn to filter by resource type, size, or domain
2. Configure download settings: Set download paths, concurrent connections, and retry behavior
3. Platform-specific guides: Review documentation for specific platforms (WeChat Channels, Douyin, etc.)
4. Advanced proxy settings: Configure upstream proxies for restricted network environments

For detailed usage instructions, refer to the online documentation (README.md:31) or join the community discussion group (README.md:32-34).