TSpider - Torrent Spider CLI

A fast, concurrent torrent search aggregator written in Go.

Features

• Search multiple torrent sites concurrently
• Doctor command to check site availability
• Configurable site URLs (useful when sites change domains)
• Animated progress spinner with ETA
• Support for Korean (17 sites) and Japanese (2 sites) torrent sites

Installation

go install github.com/daite/tspider/cmd/tspider@latest

Or build from source:

git clone https://github.com/daite/tspider.git
cd tspider
make build

Usage

Search for torrents

# Search Japanese sites (default)
tspider "keyword"
tspider search "keyword"

# Search Korean sites
tspider -l kr "keyword"
tspider search -l kr "keyword"

Check site availability (Doctor)

# Check all sites
tspider doctor

# Check only Korean sites
tspider doctor -l kr

# Check only Japanese sites
tspider doctor -l jp

Manage configuration

# List all configured sites
tspider config list

# Update a site's URL (when site changes domain)
tspider config set-url torrenttop https://torrenttop999.com

# Add a new site
tspider config add mysite https://mysite.com kr

# Remove a site
tspider config remove mysite

# Enable/disable a site
tspider config enable torrentqq
tspider config disable sukebe

Configuration

Configuration is stored in ~/.tspider.json:

{
  "sites": {
    "torrenttop": {
      "url": "https://torrenttop152.com",
      "enabled": true,
      "language": "kr"
    },
    "nyaa": {
      "url": "https://nyaa.si",
      "enabled": true,
      "language": "jp"
    }
  },
  "user_agent": "Mozilla/5.0 ...",
  "timeout_seconds": 10
}

Supported Sites

Korean (kr):

• torrenttop, torrentqq, tshare, torrentmobile, ktxtorrent
• jujutorrent, torrentgram, torrentmax, torrentrj, torrentsee
• torrentsir, torrentsome, torrenttoast, torrentwiz, torrentj
• torrentview, ttobogo

Japanese (jp):

• nyaa, sukebe (sukebei)

Architecture

tspider/
├── cmd/tspider/     # CLI entry point
├── common/          # Config, Doctor, Spinner, utilities
├── ktorrent/        # Korean torrent site scrapers
├── jtorrent/        # Japanese torrent site scrapers
└── tests/           # Unit tests

Authors

• daite - Original author & maintainer - GitHub
• Claude (Anthropic) - Refactoring & new features - Doctor command, config management, spinner animation, project restructuring

Changelog

v1.0.0

• Added doctor command to check torrent site availability
• Added config command to manage site URLs dynamically
• Added animated progress spinner with ETA
• Added JSON configuration file (~/.tspider.json)
• Refactored for better Go concurrency patterns
• Renamed project from angel to tspider

References

• Korean Torrent Sites List

License

MIT