Skip to content

SimoneFelici/bt1337xearch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bt1337xearch

1337x search TUI with Cloudflare bypass and basic filtering

What it does

bt1337xearch is a command-line tool that searches 1337x torrents with:

  • Category filtering (Movies, TV, Games, etc.)
  • Sorting options (by time, size, seeders, leechers)
  • Keyword filtering (include/exclude keywords)

Prerequisites

bt1337xearch uses scrapling StealthyFetcher for bypassing the Cloudflare Captcha.
The StealthyFetcher uses a custom playwrigth build to made that happen.
You can install this playwright version using Scrapling:

uvx scrapling[shell] install

Warning

If the "Installing Playwright dependencies..." step fails, bt1337xearch should still work (e.g., Arch-based distros).

Installation

uv tool install bt1337xearch

or

git clone https://github.com/SimoneFelici/bt1337xearch.git
cd bt1337xearch
uv tool install .

Usage

Tip

Use "ctrl + p" to display the TUI keybindings!

Basic search

bt1337xearch -n "Dexter"

Search with category (Recommended)

bt1337xearch -n "Lupin" -c ANIME

Search with sorting

bt1337xearch -n "Alien" -c MOVIE -s TIME -o DESC

Advanced filtering

Use + to include words and ~ to exclude words:

# Include only results with "1080p" or "BluRay"
bt1337xearch -n "Dexter" -f +1080p +BluRay

# Exclude results with "CAM" or "TS"
bt1337xearch -n "Movie" -f ~CAM ~TS

# Combine include and exclude
bt1337xearch -n "Dexter" -c TV -f +1080p "~x265 HEVC" ~CAM

Options

Option Description Choices
-n, --name Name of the media (required) -
-c, --category Filter by category MOVIE, TV, GAME, MUSIC, APP, DOCU, ANIME, OTHER, XXX
-s, --sort Sort results by TIME, SIZE, SEED, LEECH
-o, --order Sort order (default: DESC) ASC, DESC
-f, --filter Filter by keywords Use +word to include, ~word to exclude

Examples

# Search for Dexter TV series, sorted by seeders
bt1337xearch -n Dexter -c TV -s SEED

# Search for movies with "1080p", exclude "CAM" releases
bt1337xearch -n "Angel's Egg" -c MOVIE -s TIME -o DESC -f +1080p '~CAM'

# Search for games, sorted by upload time
bt1337xearch -n "Peak" -c GAME -s TIME -o ASC

Output

For each result, the tool displays:

  • Name
  • Link
  • Seeders
  • Leechers
  • Upload date
  • File size
  • Uploader
image

About

1337x search TUI with Cloudflare bypass and basic filtering

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages