⚡ JackTorr

An TorrServer streaming addon for Kodi.

---

Features • Installation • Server Setup • API Guide • Donations

🌟 Overview

JackTorr is a high-performance torrent streaming addon for Kodi. It leverages the power of TorrServer to provide a seamless streaming experience, featuring on-the-fly metadata retrieval, intelligent buffering, and comprehensive playback controls.

---

✨ Features

• 🚀 High-Speed Streaming: Optimized for TorrServer's HTTP API for efficient torrent streaming.
• 📦 Versatile Input: Support for Magnet links, local .torrent files, and direct torrent URLs.
• 📊 Real-time Status: Optional status overlay showing download speed, active peers, and buffering progress.
• ⚙️ Advanced Buffering: Configurable pre-load cache and buffering timeouts.
• 📂 Smart File Selection: Automatically identifies video candidates or lets you choose from multiple files.
• 🔌 API for Addons: Simple plugin API allows other Kodi addons to trigger JackTorr playback.

---

📥 Installation

1. Direct Download: Get the latest release.
2. Kodi Install:
   • Go to Settings > Add-ons.
   • Select Install from zip file. (Ensure "Unknown Sources" is enabled).
   • Locate and select the downloaded file.

NOTE: JackTorr requires an external TorrServer instance. It does not include the TorrServer daemon itself. You must configure the server address in the addon settings.

---

🚀 Server Setup

JackTorr requires an external TorrServer instance to function. You can set this up in several ways:

📱 Android (Recommended for Mobile/TV)

For Android-based devices (including Android TV/Nvidia Shield), the simplest method is to install the official TorrServer APK:

1. Download & Install: TorrServer on F-Droid
2. Launch the App: Open TorrServer and ensure the service is running.
3. Config: In JackTorr settings, use 127.0.0.1 as the host if running on the same device.

🐳 Docker (Cross-Platform)

The easiest way to run TorrServer on servers or PCs is via Docker. Use the following docker-compose.yml fragment:

version: '3.3'
services:
    torrserver:
        image: ghcr.io/yourok/torrserver
        container_name: torrserver
        environment:
            - TS_PORT=5665
            - TS_DONTKILL=1
            - TS_HTTPAUTH=0
            - TS_CONF_PATH=/opt/ts/config
            - TS_TORR_DIR=/opt/ts/torrents
        volumes:
            - './CACHE:/opt/ts/torrents'
            - './CONFIG:/opt/ts/config'
        ports:
            - '5665:5665'
        restart: unless-stopped

---

🛠️ API Guide

Developers can integrate JackTorr into their own addons using the following protocol:

Action	URL Pattern	Description
Play Magnet	plugin://plugin.video.jacktorr/play_magnet?magnet=<magnet>	Plays the provided Magnet link
Play URL	plugin://plugin.video.jacktorr/play_url?url=<url>	Plays torrent from a web URL
Play Path	plugin://plugin.video.jacktorr/play_path?path=<path>	Plays torrent from a local file path

---

📸 Screenshots

Player Interface

---

☕ Support

If you enjoy using JackTorr and want to support its development, you can buy me a coffee!

---

⚖️ License

Distributed under the MIT License. See LICENSE for more information.

---

Made with ❤️ for the Kodi Community