YARR!

Yet Another Rapid Retriever - A free, open-source Stremio addon with 60+ torrent sources, smart ranking, and instant debrid streaming. Quick 5-step setup.

---

What is it?

YARR! is a Stremio addon that acts as your personal pirate crew, fetching torrents from all corners of the internet. It integrates with debrid services to give you instant, high-speed streaming, and it's smart enough to find the best quality links for whatever you're watching. It's built to be simple, fast, and completely customizable.

Features

• Tons of Sources: We're talking 60+ public trackers, anime sites, and international indexers.
• Zilean Integration: Get instant results from a massive, free torrent database.
• Indexer Support: Plug in Prowlarr or Jackett to access over 1000 more trackers.
• Debrid Power: Works with RealDebrid, Premiumize, AllDebrid, DebridLink, TorBox, and PikPak. If a torrent is cached, you stream it instantly.
• Plays Well with Others: Combine results from other Stremio addons like Torrentio or MediaFusion.
• Smart Filtering: Prioritize languages, and block qualities you don't want (like CAM, HDR, HEVC, etc.).
• Stremio Sync: Configure on the web and sync it straight to your Stremio account.
• Clean & Easy Setup: A simple 5-step wizard to get you going in minutes.

---

Setup Walkthrough

Getting started is super easy. Here's a quick look at the setup process.

Want to see everything at once? Check out the full setup flow:

• Light Mode Full Setup
• Dark Mode Full Setup

Step 1: Welcome Aboard, Matey!

This is the first thing you'll see. Just hit "Begin Setup" to get started.

Step 2: Choose Your Speed

Decide how fast you want your results. "Balanced" is a good mix of speed and coverage, but if you're feeling impatient, "Fast" is your friend. If you want to search everything, go "Comprehensive".

Step 3: Pick Your Content & Sources

This is where you tell YARR! what to look for. You can use the recommended "Fast Indexers" like Zilean for instant results.

Normal Mode: Just pick your content type, select your languages, and you're good to go. The recommended sources are already enabled.

Manual Mode: Want more control? Flick the "Manually Select Sources" switch to pick and choose from all the available trackers.

Step 4: Quality & Debrid

Here you can link your debrid services. Just paste in your API key and test it. YARR! will check all the services you enable. You can also set your preferred quality levels and choose a display style.

Step 5: Advanced Options

Fine-tune your experience. Block certain video qualities, remove adult content, or even aggregate results from other addons. We recommend trying out ElfHosted's addon collection if you're into that.

Step 6: You're All Set!

That's it! You can now install the addon to Stremio. You've got two options here:

Option 1: Auto-Sync (Easiest) If you're signed into Stremio on the web, you can connect your account and the addon will automatically sync to all your devices. No manual installation needed.

Option 2: Manual Install Click "Install to Stremio" and it'll open the Stremio app. Just confirm the installation and you're good to go.

Once you're set up: You'll see a confirmation. You can also manage your addons' priority directly from here.

Manage Your Addons: Easily re-order your addons to make sure YARR! is at the top for the best results.

Managing Your Addon

Once YARR! is configured and installed, you can easily manage it anytime. Just head back to the configuration page and you'll be able to:

• Reorder your addons: Drag and drop to change priority. Put YARR! at the top to make sure it's checked first.
• Update your settings: Change debrid services, adjust quality filters, or enable new sources.
• Sync across devices: If you're signed into Stremio, your addon configuration syncs automatically to all your devices.
• Test your setup: Use the "Test Configuration" button to make sure everything's working before you start streaming.

It's all designed to be dead simple. No config files, no command line nonsense. Just click, adjust, and you're done.

---

The Result

After setting everything up, you'll get beautifully formatted results in Stremio, packed with all the info you need.

---

FAQ

Do I need a debrid service? Nope. It works perfectly fine with regular magnet links for P2P streaming. Debrid just makes it faster by streaming from their servers if the file is cached.

Can I use more than one debrid service? Yep! Add as many as you have. YARR! will check all of them.

What's Zilean? A free, public torrent database that gives you instant search results. It's awesome, you should definitely use it.

Does this thing track me? No way. Zero tracking, zero analytics. It's your server, your business.

Installation fails with native module errors?

# Use the clean install method
pnpm install --ignore-scripts
pnpm rebuild
pnpm build

Proxy not working? Make sure your .env file has the correct proxy URL format:

PROXY_URL=http://username:password@proxy-host:port

Live TV not showing?

1. Enable "Live TV" in the configuration page
2. Save settings
3. Refresh Stremio

---

🐳 Docker Install

Option 1: One-Click Install

# Using Docker Compose
curl -sSL https://raw.githubusercontent.com/spookyhost1/yarr-stremio/main/install.sh | bash -s -- docker

Option 2: Docker Hub (Latest)

# Pull and run the latest image
docker run -d \
  --name yarr \
  -p 58827:58827 \
  yarrhoster/yarr-stremio:latest

Option 3: Docker Compose

version: '3.8'
services:
  yarr:
    image: yarrhoster/yarr-stremio:latest
    container_name: yarr
    ports:
      - "58827:58827"
    restart: unless-stopped

Deployment

Check out DEPLOYMENT.md for all the different ways you can get YARR! running.

License

It's open-source, under the MIT License. See the LICENSE file for the boring legal stuff.

Made with 🏴‍☠️