GhostBox

Based on GhostYgg

This application will automatically download any torrent files placed in a designated watched directory, which can be specified via a command-line option or a Docker volume.

The torrent client is configured to avoid sending any information to the torrent tracker, ensuring that the download ratio remains unaffected.

Installation

Using Docker (recommended)

Simply pull the image from Docker Hub using docker pull xnonames/ghostbox:latest or go directly to Docker CLI or Docker Compose sections.

From Binary

You can download the pre-built binaries for your platform from the releases page.

Using Go

If you are using Go v1.20 or higher, you can install GhostBox using the following command:

go install -v github.com/0xNoNames/GhostBox@latest

From Source

To get started with GhostBox, follow these steps:

git clone https://github.com/0xNoNames/GhostBox.git
cd GhostBox
go build GhostBox.go
./GhostBox

Usage

Caution

You are responsible for the torrents you download with GhostBox.

Docker CLI

docker run --rm \
           --name ghostbox \
           -e PUID=501 \
           -e PGID=501 \
           -v ./downloads:/app/downloads \
           -v ./torrents:/app/torrents \
          xnonames/ghostbox:latest

Docker Compose

---
services:
  ghostbox:
    image: xnonames/ghostbox:latest
    container_name: ghostbox
    environment:
      - PUID=501
      - PGID=501
    volumes:
      - ./downloads:/app/downloads
      - ./torrents:/app/torrents
    restart: unless-stopped

Using the binary

./GhostBox -i ./torrents -o ./downloads

With the following options:

• -i: Specifies the watched directory, where the ".torrent" files will be added.
• -o: Specifies the output directory, where the downloaded files will be stored.
• -help: Displays the help message.