torr

Search and download torrents using ArcTorrent API and WebTorrent. Use when users request to: (1) Search for torrents across multiple sources, (2) Download content via magnet links, (3) Find torrents filtered by seeder counts, or any torrent-related tasks

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill provides a streamlined interface for searching and downloading torrents by integrating the ArcTorrent API and WebTorrent. It enables users to perform multi-source searches, filter results based on seeder health, and automate the retrieval of content via magnet links, transforming complex torrenting workflows into simple, natural language commands.

Use Cases

  • Multi-Source Content Discovery: Quickly locate specific files, such as Linux distributions or public domain media, by searching across multiple torrent trackers simultaneously without manual browsing.
  • Automated High-Speed Downloads: Identify and retrieve the healthiest torrents by automatically filtering search results for high seeder counts to ensure optimal download performance.
  • Headless Torrent Management: Use natural language to trigger magnet link downloads directly to a local or remote server directory, facilitating a hands-free media or data acquisition workflow.
nametorr
descriptionSearch and download torrents using ArcTorrent API and WebTorrent. Use when users request to: (1) Search for torrents across multiple sources, (2) Download content via magnet links, (3) Find torrents filtered by seeder counts, or any torrent-related tasks

Torrent Search & Download

Prerequisites

  • ArcTorrent API at http://localhost:3000
    # Clone to /tmp and start
    cd /tmp && git clone https://github.com/theriturajps/ArcTorrent
    cd ArcTorrent && npm install && npm start &
    
  • jq for JSON parsing
scripts/search.sh <source> "<query>" [page]
scripts/search.sh piratebay "ubuntu iso" 1
scripts/search.sh yts "big buck bunny" 1

Sources

List available sources:

scripts/search.sh --list-sources
# First result
scripts/search.sh piratebay "ubuntu" 1 | head -1 | cut -f4

# Filter by seeders (>10), get first magnet
scripts/search.sh piratebay "ubuntu" 1 | awk -F'\t' '$3+0 > 10 {print $4; exit}'

Download

# Basic download
node scripts/download.js "magnet:?xt=urn:btih:..." /tmp/downloads

# With custom timeout (default: 10800s)
node scripts/download.js "magnet:?xt=urn:btih:..." /tmp/downloads --timeout 3600

# JSON output for automation
node scripts/download.js "magnet:?xt=urn:btih:..." /tmp/downloads --json

Complete Workflow

MAGNET=$(scripts/search.sh piratebay "ubuntu iso" 1 | head -1 | cut -f4)
node scripts/download.js "$MAGNET" /tmp/downloads

Troubleshooting

Issue Fix
API not responding cd /tmp/ArcTorrent && npm start &
Download slow/hangs Filter for seeders > 20; try different source