aitorrent について
AITorrent Skillは、Plex、qBittorrent、TMDBを使うメディア管理向けのコマンドラインツールを提供します。番組検索、トレント追加、Plexライブラリの確認に対応し、各ツールはuvx経由で実行します。
主な機能
- 01Plexライブラリ内容の一覧表示
- 02TMDBでの番組検索
- 03番組とシーズン情報の取得
- 04トレントの一覧表示と絞り込み
- 05トレントやRSSルールの追加
活用シーン
- 01番組とエピソード情報の検索
- 02qBittorrentへのトレント追加
- 03状態別のダウンロード確認
- 04Plexライブラリ内容の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ konsumer/ aitorrent --skill aitorrentインストール後、Claude Code で/aitorrentを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.env.exampleLICENSEDEVELOPER.mdplexinfo.py.gitignoretmdbinfo.pyrequirements.txtREADME.mdqbtinfo.pyMANIFEST.inpyproject.toml.github/workflows/publish.yml詳細
AITorrent スキル
Plex、qBittorrent、または TMDB を使用するメディア管理タスクでは、このスキルを使用してください。すべてのツールは uvx 経由で実行され、インストールは不要です。
前提条件
必要なものはありません。すべて uvx が処理します。これらの環境変数に認証情報を設定してください。
PLEX_URL=http://localhost:32400
PLEX_TOKEN=your_plex_token
TMDB_API_KEY=your_tmdb_api_key
QBT_URL=http://localhost:8080
QBT_USERNAME=admin
QBT_PASSWORD=adminadmin
利用可能なツール
Plex CLI
# List all library names
uvx --from aitorrent aitorrent-plex-cli list
# List all shows in "TV Shows" library
uvx --from aitorrent aitorrent-plex-cli list "TV Shows"
# List all movies in "Movies" library
uvx --from aitorrent aitorrent-plex-cli list "Movies"
# Show what's currently watching
uvx --from aitorrent aitorrent-plex-cli watching
TMDB CLI
# Search for a TV show
uvx --from aitorrent aitorrent-tmdb-cli search-shows "Star Trek Lower Decks"
# Get show details (use the tmdb_id from search)
uvx --from aitorrent aitorrent-tmdb-cli show-details 85948
# Get season details
uvx --from aitorrent aitorrent-tmdb-cli season-details 85948 1
# Search for a movie
uvx --from aitorrent aitorrent-tmdb-cli search-movies "The Matrix"
# Get movie details
uvx --from aitorrent aitorrent-tmdb-cli movie-details 603
qBittorrent CLI
# List all torrents
uvx --from aitorrent aitorrent-qbt-cli list
# List downloading torrents only
uvx --from aitorrent aitorrent-qbt-cli list downloading
# Add a torrent
uvx --from aitorrent aitorrent-qbt-cli add "magnet:?xt=urn:btih:..." --path "/downloads" --category "TV Shows"
# List RSS feeds
uvx --from aitorrent aitorrent-qbt-cli rss list-feeds
# Add RSS feed
uvx --from aitorrent aitorrent-qbt-cli rss add-feed "https://example.com/feed.rss" --folder "TV Shows"
# Add RSS rule for a show
uvx --from aitorrent aitorrent-qbt-cli rss add-show "Star Trek Lower Decks" --season 3 --quality "1080p" --category "TV Shows"
一般的なワークフロー
- 追加する番組を探す:TMDB CLI で番組を検索し、詳細を取得してエピソード情報を確認します
- qBittorrent に追加する:qBittorrent CLI でトレントまたは RSS ルールを追加します
- Plex を確認する:Plex CLI でライブラリを検証し、視聴中のコンテンツを確認します
環境変数
| 変数 | 説明 |
|---|---|
PLEX_URL | Plex サーバーの URL(例:http://localhost:32400) |
PLEX_TOKEN | Plex 認証トークン |
TMDB_API_KEY | The Movie Database API キー |
QBT_URL | qBittorrent Web UI の URL |
QBT_USERNAME | qBittorrent のユーザー名 |
QBT_PASSWORD | qBittorrent のパスワード |
コメント
Markdown 対応