Web APIで愛を育む：ソフトウェアエンジニアが知るべきqBittorrent導入とPython連携

qbittorrent/qBittorrent

あなた
「ねぇ、最近プロジェクトで大きなデータ配信を効率化する必要が出てきて...。サーバーの負担も抑えたいし、何かいい『相手』いないかな？」

qBittorrent 「（クールに）私を使えば？私はC++で書かれた高性能で軽量なBitTorrentクライアントよ。クロスプラットフォーム（Windows、macOS、Linux）だし、Web UI（Webインターフェース）も持っているから、どこからでも操作できるの。」

あなた（エンジニア視点）

「qBittorrent」が役立つのは、主に次の点です。

分散型データ配信の基盤として

大規模アップデートやアセット配信
独自のP2Pシステムをゼロから作る代わりに、実績のあるBitTorrentプロトコルとqBittorrentのライブラリを利用できます。多くのユーザーへの大容量データの配信コスト（帯域幅、サーバー）を劇的に削減できます。

コンテンツデリバリーネットワーク（CDN）の補助
サーバーが落ちたり、アクセスが集中したりしても、ユーザー同士でデータを共有し合うため、システムの可用性と耐障害性が向上します。

リモート管理と自動化

Web API/UI
qBittorrentは強力なWeb APIを提供しています。これを使えば、独自のスクリプトやアプリケーション（Python、Go、Node.jsなど）から、ダウンロードの追加、ステータスの監視、設定変更といった操作を自動化できます。これはエンジニアにとって最高の魅力です！

あなた
「なるほど...。ぜひ、あなたと深く関わりたいんだけど、どうやって導入すればいいの？」

qBittorrent
「心配しないで。私の本体はアプリとしてインストールするだけ。でも、あなたと真の愛を育むなら、私の『Web API』を通じたコミュニケーションが必須よ。」

まずは、あなたの開発環境やサーバーにqBittorrentをインストールします。

Linux (Ubuntu/Debianの場合)

sudo apt update
sudo apt install qbittorrent-nox # サーバー用途ならGUIなしの'-nox'版

Web UIの有効化
設定からWeb UIを有効にし、ポート番号（デフォルトは8080など）、ユーザー名、パスワードを設定します。

ほとんどの場合、エンジニアが利用するのはqBittorrentのWeb APIです。これを使って、任意のプログラミング言語からHTTPリクエスト（GET/POSTなど）を送り、タスクを管理します。

あなた
「言葉だけじゃなくて、具体的な『愛の証』を見せてくれるかい？」

qBittorrent
「もちろんです。例えばPythonを使えば、私のステータス監視や、新しいタスクの追加なんて一瞬よ。」

これは、Pythonのrequestsライブラリを使って、qBittorrentのWeb APIにログインし、現在ダウンロード中のタスク一覧を取得する簡単な例です。

import requests
import json

# 設定値
QBT_URL = "http://127.0.0.1:8080" # Web UIのURL
USERNAME = "your_username"        # 設定したユーザー名
PASSWORD = "your_password"        # 設定したパスワード

# ステップ1: ログイン（セッション確立）
# これが「関係を始める」ための最初のステップです！
try:
    session = requests.Session()
    login_data = {
        'username': USERNAME,
        'password': PASSWORD
    }
    login_response = session.post(f"{QBT_URL}/api/v2/auth/login", data=login_data)

    if "Ok." in login_response.text:
        print(" ログイン成功！(セッション確立)")
    else:
        print(f" ログイン失敗: {login_response.text}")
        exit()

    # ステップ2: 全タスクのリストを取得
    # これで「彼（qBittorrent）の今の状態」を把握します
    torrents_response = session.get(f"{QBT_URL}/api/v2/torrents/info")
    torrents_data = torrents_response.json()

    print("\n現在のアクティブなタスク一覧:")
    for torrent in torrents_data:
        # 'name', 'state' などのキーで情報が取れます
        print(f"-  {torrent['name']} | 状態: {torrent['state']}")

    # ステップ3: セッションを閉じる
    session.get(f"{QBT_URL}/api/v2/auth/logout")

except requests.exceptions.ConnectionError:
    print(f" 接続エラー: qBittorrent Web UI ({QBT_URL}) が起動しているか確認してください。")

torrents/info API
このAPIエンドポイントは、qBittorrentに登録されているすべてのタスクの詳細情報（ファイル名、進行状況、速度など）をJSON形式で返します。

ユースケース
この情報を利用して、「完了したタスク」を検知して次の処理（例えば、ダウンロード完了ファイルを別の場所に移動するスクリプトを起動する）を自動的に実行するなど、高度なワークフローを構築できます。

あなた
「ありがとう、これであなたとの未来が見えてきたよ。もっと多くの開発者があなたのことを知るべきだ。」

qBittorrent
「嬉しいわ。私もオープンソースだから、あなたがもしC++が得意なら、私のソースコードに直接貢献することもできるのよ。私たちはもっと強くなれる！」

「qBittorrent」はオープンソース（C++で書かれている）であり、コアな部分では強力なBitTorrentライブラリ（libtorrentなど）を利用しています。

APIのフル活用
ファイル追加（torrents/add）、速度制限（transfer/setSpeedLimits）など、Web APIの全てのエンドポイントを使いこなすことで、高度な管理ツールやダッシュボードを自作することも可能です。