qb-ptmap 1.0.1

Automatic port mapper for qBittorrent with ProtonVPN

qb-ptmap

Automatic port mapper for qBittorrent with ProtonVPN

Documentation work in progress

Prerequisites

• qBittorrent/qBittorrent-nox;
• Enabled qBittorrent webui;
• natpmpc (debian, arch);
• Wireguard or protonvpn installed.

Wireguard configuration

If you are using the proton vpn GUI you can skip this step.

Generate a Wireguard configuration for Linux and be sure to enable "NAT-PMP (Port Forwarding)".

Not mandatory but recommended

Install uv from the official source.

Installation

Install tool (recommended)

uv tool install  qb-ptmap

From source

Clone the repository:

git clone https://github.com/SimoneFelici/qb-ptmap.git

Generate the environment:

cd qb-ptmap && uv sync

source .venv/bin/activate

Usage

Wireguard

Move your wireguard configuration in /etc/wireguard/
Start wireguard with your proton config:

sudo wg-quick up proton

If you installed the recommended way:

qb-ptmap

Else:
Enter the environment and run the script:

source .venv/bin/activate

uv run src/qb_ptmap/qb_ptmap.py

ProtonVPN GUI

Connect to a server with port forwarding.
If you installed the recommended way:

qb-ptmap

Else:
Enter the environment and run the script:

source .venv/bin/activate

Configuration

At the first run the tool will generate the configuration file at ~/.local/share/qb-ptmap/config.toml You can then edit:

• Webui url;
• User;
• Password.