torrent-indexer - GitLite

KO | EN

gitlite — search

#java #javascript #ai-agent #ai #rag #awesome #css #animation #dotnet #database

torrent-indexer

(★ 67)

Yet another node.js torrent scraper made especially for movie, series, anime and music (scrape from 1337x, eztv, limetorrents, rarbg, skytorrents, thepiratebay, torrentproject, yts and zooqle)

File Explorer

ZIP Download

- - test.yml
- - request.d.ts
  - request.js
  - torrentSource.d.ts
  - torrentSource.js
  - torrentSource.test.js
  - unhumanizeSize.d.ts
  - unhumanizeSize.js
- - 1337x.d.ts
  - 1337x.js
  - 1337x.test.js
  - eztv.d.ts
  - eztv.js
  - eztv.test.js
  - kickass.d.ts
  - kickass.js
  - kickass.test.js
  - limetorrents.d.ts
  - limetorrents.js
  - limetorrents.test.js
  - rarbg.d.ts
  - rarbg.js
  - skytorrents.d.ts
  - skytorrents.js
  - skytorrents.test.js
  - thepiratebay.d.ts
  - thepiratebay.js
  - thepiratebay.test.js
  - torrentproject.d.ts
  - torrentproject.js
  - torrentproject.test.js
  - torrentz2.d.ts
  - torrentz2.js
  - yts.d.ts
  - yts.js
  - yts.test.js
  - zooqle.d.ts
  - zooqle.js
- config.d.ts
- config.js
- torrentIndexer.d.ts
- torrentIndexer.js
- torrentIndexer.test.js
- types.d.ts
- types.js
.gitignore
bun.lock
CHANGELOG.md
eslint.config.mjs
example.js
LICENSE
package.json
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`bun add`

View Details ▼

Add and install new dependencies to the current project.

bun {{[a|add]}} {{package}}

Install a single package:

bun {{[a|add]}} {{package1 package2 ...}}

Install multiple packages:

bun {{[a|add]}} {{git_url}}

Install from a Git repository:

🔍

`link`

View Details ▼

Create a hard link to an existing file.
For more options, see the `ln` command.

link {{path/to/existing_file}} {{path/to/new_file}}

Create a hard link from a new file to an existing file:

🔍

`query`

View Details ▼

Display information about user sessions and process.

query session

Display all user sessions:

query session /server:{{hostname}}

Display the current user sessions on a remote computer:

query user

Display logged in users:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## torrent-indexer [![Test](https://github.com/sayem314/torrent-indexer/workflows/Test/badge.svg)](https://github.com/sayem314/torrent-indexer/actions) [![npm downloads per month](https://img.shields.io/npm/dm/torrent-indexer.svg)](https://www.npmjs.com/package/torrent-indexer) [![npm version](https://img.shields.io/npm/v/torrent-indexer?label=version)](https://www.npmjs.com/package/torrent-indexer)

Finds the best torrents (Movies, Series, Anime, Music and Other stuff) across multiple sources.

## Installation

```bash
$ bun add torrent-indexer
```

## Usage

Here's a simple example to search for torrents.

```js
import TorrentIndexer from "torrent-indexer";

const torrentIndexer = new TorrentIndexer();

const torrents = await torrentIndexer.search("rick and morty s04e04");

console.log(torrents);

/*
[
  {
    fileName: 'Rick.and.Morty.S04E01.1080p.WEBRip.x264-TBS[TGx]',
    seeders: 7900,
    leechers: 3198,
    uploaded: "Nov. 11th '19",
    size: '736.0 MB',
    site: 'https://...',
    resolution: '1080p',
    source: 'webrip',
    codec: 'x264',
    group: 'TBS[TGx]',
    season: 4,
    episode: 1,
    score: 24.281,
    title: 'Rick and Morty',
    sourceName: '1337x'
  },
  {
    fileName: 'Rick and Morty S04E01 720p HDTV x264-W4F [eztv]',
    seeders: 170,
    leechers: 0,
    uploaded: '4 mo',
    size: '500.68 MB',
    link: 'magnet:?xt=urn:btih:...',
    resolution: '720p',
    source: 'hdtv',
    codec: 'x264',
    season: 4,
    episode: 1,
    score: 23.357,
    title: 'Rick and Morty',
    sourceName: 'Eztv'
  },
  ...
]
*/
```

Search method returns array of objects:

| Property   |   Type   | Optional |                                                                                                                                        Description |
| ---------- | :------: | -------: | -------------------------------------------------------------------------------------------------------------------------------------------------: |
| `fileName` | `string` |       No |                                                                          torrent name found in the scraped sites, might be stripped for some sites |
| `seeders`  | `number` |       No |                                                                                                                            total amount of seeders |
| `leechers` | `number` |       No |                                                                                                                        total leechers (0 for eztv) |
| `uploaded` | `string` |       No |                                                                                                             upload dates, non standard date format |
| `link`     | `string` |   Yes/No |                                                                                         contains either downloadable torrent url or magnet address |
| `site`     | `string` |   Yes/No | if magnet or direct link of .torrent cannot be extracted this property will contain specific page address to extract using `.torrent(site)` method |

- One of `link` or `site` will be available. Site value contains webpage address to retrive torrent magnet or hash using `.torrent(.site)` method while link contains either direct downloadable torrent link or magnet.

- There are also optional additional specific property available for specially for media contents.

| Property     |   Type   |          Example |
| ------------ | :------: | ---------------: |
| `resolution` | `string` |          `1080p` |
| `source`     | `string` |         `bluray` |
| `codec`      | `string` |           `x264` |
| `group`      | `string` |          `RARBG` |
| `season`     | `number` |              `4` |
| `episode`    | `number` |              `1` |
| `title`      | `string` | `Rick and Morty` |
| `sourceName` | `string` |          `1337x` |

## Methods

### `.search(query, type, page);`

| Parameters | Required |     Type |               Accepted Values |
| ---------- | :------: | -------: | ----------------------------: |
| `query`    |   Yes    | `string` |   anything, your search query |
| `type`     |    No    | `string` | movie, series, music or anime |
| `page`     |    No    | `number` |                          >= 1 |

### `.torrent(url)`

| Parameters | Required |                                                                     Description |
| ---------- | :------: | ------------------------------------------------------------------------------: |
| `url`      |   Yes    | Using this method you can retrieve magnet or torrent hash from `.site` property |

Example:

```js
await torrentIndexer.torrent(torrents.site);
```

### Donations

If you want to show your appreciation, you can donate me on [ko-fi](https://ko-fi.com/Z8Z5KDA6) or [buy me a coffee](https://www.buymeacoffee.com/sayem). Thanks!

> Made with :heart: & :coffee: by Sayem