A comprehensive BitTorrent GDExtension for Godot 4, providing full protocol functionality with native C++ performance.

• Overview
• Features
• Quick Start
• Installation
  • Prerequisites
  • Build from Source
• Documentation
• Core Classes
• Use Cases
• Performance
• Testing
• Contributing
• Support Me
• License
• Acknowledgments

Godot-Torrent wraps the powerful libtorrent library to bring full-featured BitTorrent capabilities to Godot 4. Download, upload, and manage torrents directly from your Godot projects with native performance.

• Complete BitTorrent Protocol - Full support for downloading and seeding
• Session Management - Fine-grained control over torrent sessions
• Real-time Monitoring - Track progress, peers, and statistics
• Priority Management - Control file and piece download priorities
• DHT Support - Distributed Hash Table for trackerless torrents
• Cross-Platform - Native builds for Linux, Windows, and macOS
• Production Ready - Comprehensive error handling and logging

# Create a session
var session = TorrentSession.new()
session.start_session()
# Enable DHT for magnet link support
session.start_dht()
# Add a torrent
var handle = session.add_magnet_uri(
    "magnet:?xt=urn:btih:...",
    "/path/to/downloads"
)
# Monitor progress (call this periodically, e.g., in a timer)
func update_progress():
    session.post_torrent_updates()
    var alerts = session.get_alerts()
    
    for alert in alerts:
        if alert.has("torrent_status"):
            for status_dict in alert["torrent_status"]:
                var progress = status_dict.get("progress", 0.0) * 100.0
                var download_rate = status_dict.get("download_rate", 0) / 1024.0 / 1024.0
                print("Progress: %.1f%% | Download: %.2f MB/s" % [progress, download_rate])

• Godot 4.5+
• Git (for submodules)
• Build tools: GCC/Clang, SCons, CMake

# Clone with submodules
git clone --recursive https://github.com/NodotProject/godot-torrent.git
cd godot-torrent
# Build for your platform
./build_local.sh linux    # Linux
./build_local.sh windows  # Windows cross-compile
./build_local.sh macos    # macOS
# Run tests
./run_tests.sh

• TorrentSession - Session management and configuration (30+ methods)
• TorrentHandle - Individual torrent control (30+ methods)
• TorrentInfo - Torrent metadata and file information (15+ methods)
• TorrentStatus - Real-time status tracking (25+ properties)
• PeerInfo - Peer connection details (20+ methods)
• AlertManager - Event system management
• TorrentError - Complete error handling system
• TorrentLogger - Comprehensive logging (5 levels, 10 categories)

• Game Development - P2P content distribution, updates, mod sharing
• Application Development - File sharing, content delivery, backups
• Media Applications - Large file transfers, streaming content

The project includes comprehensive testing using GUT:

# Run all tests
./run_tests.sh
# Run specific test categories
godot --headless -s addons/gut/gut_cmdln.gd -gdir=test/unit -gexit
godot --headless -s addons/gut/gut_cmdln.gd -gdir=test/integration -gexit

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Submit a pull request

This project is licensed under the MIT License - see LICENSE for details.

• libtorrent - Powerful C++ BitTorrent library
• Godot Engine - Amazing open-source game engine
• GUT - Godot Unit Testing framework
• The Godot Community - Continuous support and examples

Hi! I’m krazyjakee 🎮, creator and maintain­er of the NodotProject - a suite of open‑source Godot tools (e.g. Nodot, Gedis, GedisQueue etc) that empower game developers to build faster and maintain cleaner code.

I’m looking for sponsors to help sustain and grow the project: more dev time, better docs, more features, and deeper community support. Your support means more stable, polished tools used by indie makers and studios alike.

Every contribution helps maintain and improve this project. And encourage me to make more projects like this!

This is optional support. The tool remains free and open-source regardless.

Created with ❤️ for Godot Developers
For contributions, please open issues on GitHub