https://github.com/simonefelici/bt1337xearch
Better search for 1337x[.]to with basic filters functionalities
https://github.com/simonefelici/bt1337xearch
1337x 1337x-api 1337x-search 1337x-to cli terminal terminal-torre torrents webscraping
Last synced: 19 days ago
JSON representation
Better search for 1337x[.]to with basic filters functionalities
- Host: GitHub
- URL: https://github.com/simonefelici/bt1337xearch
- Owner: SimoneFelici
- License: mit
- Created: 2025-11-04T17:58:18.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-02-03T17:42:52.000Z (4 months ago)
- Last Synced: 2026-02-04T02:55:37.803Z (4 months ago)
- Topics: 1337x, 1337x-api, 1337x-search, 1337x-to, cli, terminal, terminal-torre, torrents, webscraping
- Language: Python
- Homepage:
- Size: 167 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# **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:
```bash
uvx scrapling[shell] install
```
> [!WARNING]
> If the "Installing Playwright dependencies..." step fails, **bt1337xearch** should still work (e.g., Arch-based distros).
## Installation
```bash
uv tool install bt1337xearch
```
or
```bash
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
```bash
bt1337xearch -n "Dexter"
```
### Search with category (Recommended)
```bash
bt1337xearch -n "Lupin" -c ANIME
```
### Search with sorting
```bash
bt1337xearch -n "Alien" -c MOVIE -s TIME -o DESC
```
### Advanced filtering
Use `+` to include words and `~` to exclude words:
```bash
# 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
```bash
# 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
