🚀 Rustatio

A modern, cross-platform BitTorrent ratio management tool that emulates popular torrent clients. Built with Rust for blazingly fast performance and Tauri for a native desktop/mobile experience.

Accurately simulate seeding behavior by emulating uTorrent, qBittorrent, Transmission, or Deluge with customizable upload/download rates and tracker interactions.

Important

This tool is for educational purposes only. Manipulating upload/download statistics on BitTorrent trackers may violate the terms of service of private trackers and could result in account suspension or ban. Use at your own risk.

🎥 Demo

2026-01-02.14-16-12.mp4

📸 Screenshots

Light Theme - Main Interface	Dark Theme - Main Interface
Torrent Loaded with Statistics	Active Torrent with Performance Charts

✨ Features

• Modern GUI: Beautiful, intuitive interface built with Tauri and Svelte
• Cross-platform: Works on Linux, Windows, and macOS
• Multi-Instance Support: Manage multiple torrents simultaneously with tabbed interface
• Popular Client Emulation: Spoofs uTorrent, qBittorrent, Transmission, and Deluge
• Automatic Tracker Detection: Reads tracker URL directly from torrent file
• Real-time Statistics: Live updates of upload/download stats and ratio
• Performance Analytics: Interactive charts for upload/download rates and peer distribution
• TOML Configuration: Easy-to-edit configuration file
• Console Logging: Detailed logging for debugging

🚀 Getting Started

Rustatio is available in two versions:

• 🖥️ Desktop App - Native application with full features, no CORS limitations
• 🌐 Web App - Browser-based version, works on any device, deployable to GitHub Pages

Desktop App Installation

Windows

1. Download the latest setup installer from Releases
2. Run the installer and follow the installation wizard
3. Launch Rustatio from the Start Menu

macOS

1. Download the latest Rustatio_*.dmg file from Releases
2. Open the downloaded file and drag Rustatio to your Applications folder
3. Launch Rustatio from Applications (you may need to allow it in System Preferences → Security & Privacy)

Linux

Download from Releases

Debian/Ubuntu:

sudo apt install ./Rustatio_*.deb

Fedora/RHEL/CentOS:

sudo dnf install Rustatio-*.rpm

AppImage (Universal):

chmod +x Rustatio_*.AppImage && ./Rustatio_*.AppImage

Web App Usage

Live Demo: https://takitsu21.github.io/rustatio/

The web version runs entirely in your browser using WebAssembly.

⚠️ CORS Setup Required: Most BitTorrent trackers don’t allow browser requests. You’ll need to set up a free CORS proxy (takes 5 minutes).

📖 Complete Setup Guide - Step-by-step instructions for setting up your free Cloudflare Workers CORS proxy

Features compared to Desktop:

• ✅ Same core functionality (ratio faking, client emulation)
• ✅ Works on any device with a modern browser
• ✅ No installation required
• ✅ Session persistence via localStorage
• ⚠️ Requires CORS proxy for most trackers

📖 Usage (Desktop & Web)

1. Select Torrent: Click "Select Torrent File" and choose your .torrent file
2. Configure Settings:

• Choose which client to emulate
• Set upload/download rates (KB/s)
• Set initial completion percentage
• Configure port and other options

1. Start Faking: Click "Start" to begin
2. Monitor Stats: Watch real-time statistics update every seconds
3. Stop: Click "Stop" when done

⚙️ Configuration

Configuration is automatically saved when using the UI. Settings are stored in:

• Linux/macOS: ~/.config/rustatio/config.toml
• Windows: %APPDATA%\rustatio\config.toml

You can also manually edit the configuration file. Example configuration:

[client]
default_type = "qbittorrent"
default_port = 6881
default_num_want = 50

[faker]
default_upload_rate = 50.0
default_download_rate = 100.0
default_announce_interval = 1800
update_interval = 5

[ui]
window_width = 1200
window_height = 800
dark_mode = true

🎯 Supported Clients

• uTorrent (default: 3.5.5)
• qBittorrent (default: 5.1.4)
• Transmission (default: 4.0.5)
• Deluge (default: 2.1.1)

Each client is accurately emulated with proper:

• Peer ID format
• User-Agent headers
• HTTP protocol version
• Query parameter ordering

🔧 How It Works

1. Torrent Parsing: Reads .torrent file and extracts info_hash and tracker URL
2. Client Spoofing: Generates authentic-looking peer ID and key for selected client
3. Tracker Announce: Sends periodic announces to tracker with fake stats
4. Stat Accumulation: Simulates upload/download based on configured rates
5. Real-time Updates: Updates statistics and re-announces at tracker-specified intervals

For Users:

• 📖 WEB_VERSION.md - How to use the web version and set up CORS proxy (5 minute guide)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📜 License

MIT License - see LICENSE file for details

🙏 Credits

• Inspired by RatioMaster.NET
• Built with Tauri, Svelte 5, Tailwind CSS, and shadcn-svelte

Differences from RatioMaster.NET

• Modern Stack: Rust + Tauri instead of C# + WinForms
• Cross-platform: Native support for Linux, Windows, macOS
• Simplified UI: Focus on essential features with clean design
• Better Performance: Async/await throughout, efficient resource usage
• Modern Config: TOML instead of Windows Registry