⚡ Skipr

The ultra-fast intro & outro auto-skipping addon for Stremio on TV & Desktop.

   

Live Web Configurator • Features • 24/7 Cloud Hosting • Quick Start for TV • How It Works

---

☁️ 24/7 Cloud Hosting (No PC Required)

Want Skipr running 24/7 in the cloud so you can stream on your TV without keeping your computer on? Deploy with 1 click for free:

Platform	Free Tier	Deploy Button
Render	Free 24/7 Web Service
Vercel	Free Global Serverless
Koyeb	Free Micro Container

Once deployed, copy your cloud manifest URL (e.g. https://skipr-xxxx.onrender.com/manifest.json), paste it into Stremio's search bar, and you're good to go!

---

💡 Why "Skipr"?

Typing long repository names or URLs using an on-screen TV remote is frustrating. Skipr is deliberately designed with a short, 5-letter name:

• Quick to type on TV screens: Easy to find with an on-screen keyboard remote.
• Auto-Sync friendly: Install once on your phone or PC with your Stremio account, and it syncs to your Android TV, Fire Stick, or Chromecast in seconds.
• Zero Client Hacks Required: Works on stock Stremio (Android TV, Google TV, Fire TV, Desktop, and Web) without requiring custom desktop-only mods.

---

✨ Features

• ⚡ Seamless Auto-Skipping: Dynamically bypasses TV show intros, openings, and recaps without touching the remote.
• 🎬 Automated Outro & Credits Skip: Automatically fast-forwards through end credits, cueing up the next episode seamlessly in Stremio's binge player.
• 🆓 100% Free Mode (No Keys Required): Zero API keys or Real-Debrid subscription required. Works out of the box with public P2P torrent streams routed through Stremio's local engine.
• 🎯 Multi-Tier Timestamp Engine:
  1. Ani-Skip API: Over 150,000+ anime opening (OP) and ending (ED) timestamps.
  2. TheIntroDB v3 & Offline Skips: Live intro and credits database for thousands of TV series, with hundreds of popular shows pre-cached offline.
  3. Embedded Chapter Probing: Fallback to video chapter markers (Intro, Opening, Credits) via ffprobe.
• 🔍 Built-in Web Skip Tester: Verify exact intro and credits timestamps for any IMDb episode directly in your browser before installing.
• 📺 Dual Stream Routing: Offers a dedicated ⚡ Skipr [Auto-Skip] stream plus the 📺 Direct Stream fallback so you always have a working stream.
• 🔓 Optional Debrid Integration: Works with Real-Debrid, TorBox, AllDebrid, and Premiumize for users who have them.
• 🔄 Scraper Compatibility: Sits seamlessly on top of Torrentio, Comet, MediaFusion, or AIOStreams.
• 🐳 1-Command Self-Hosting: Run with Docker Compose or lightweight Node.js (no heavy external database needed).

---

📺 Quick Start for TV

You don't need to struggle typing long links on your TV remote. Stremio syncs all addons across devices tied to your Stremio account:

flowchart LR
    A[Phone or PC Browser] -->|1. Configure & Install| B[Stremio Account Cloud]
    B -->|2. Auto-Syncs in seconds| C[Stremio on Android TV / Fire Stick]
    C -->|3. Enjoy Auto-Skip!| D[Seamless Playback]

Loading

Option A: The 10-Second Account Sync (Recommended)

1. Open the Skipr Web Configurator (http://localhost:7005 or your hosted URL) on your phone or PC.
2. Leave Debrid as None (Free / Direct Torrents) or choose your preferred provider.
3. Click ⚡ Install to Stremio.
4. Turn on your TV and open Stremio — Skipr is now installed and active across all your devices!

Option B: Direct URL on TV

1. Open Stremio on your TV $\rightarrow$ Navigate to Addons.
2. Select Add Addon or search for:

   http://<YOUR-IP>:7005/manifest.json
   

Option C: In-App Search & Community Addon Installation

1. Open the Stremio app on your TV, phone, or PC.
2. Click Addons (the puzzle icon on the left sidebar).
3. In the top search bar (Search addons...):
   • Type or paste your Skipr manifest URL (e.g. https://youth-painted-amd-drove.trycloudflare.com/manifest.json or your cloud Render URL).
   • Press Enter on your keyboard or remote.
   • Click Install!
4. Community Addons Catalog:
   • Skipr contains automated self-announcing hooks to Stremio's Central Registry (https://api.strem.io/api/addonPublish).
   • Community directory listing is also maintained at stremio-addons.net.

---

🛠️ How It Works

Standard Stremio addons only return stream links; they cannot send playback commands to the player. Skipr solves this with an intelligent HLS byte-range engine:

sequenceDiagram
    autonumber
    actor User as TV Remote / User
    participant Stremio as Stremio Player
    participant Skipr as Skipr Addon
    participant Scraper as Upstream Scraper (Torrentio)
    participant DB as Skip Timestamp DBs

    User->>Stremio: Select Episode
    Stremio->>Skipr: Request Streams (/stream/series/id.json)
    Skipr->>Scraper: Fetch video torrent/debrid links
    Skipr->>DB: Check Ani-Skip / TheIntroDB / Chapter Markers
    DB-->>Skipr: Returns Intro: [01:20 - 02:45]
    Skipr-->>Stremio: Injects ⚡ Skipr Stream with HLS Playlist
    Stremio->>Skipr: Request /hls/manifest.m3u8
    Skipr-->>Stremio: Spliced HLS manifest skipping intro byte-ranges
    Stremio->>User: Plays video seamlessly with intro skipped!

Loading

---

🚀 Self-Hosting

Method 1: Docker Compose (Quickest)

# Clone the repository
git clone https://github.com/LIN4CRE/skipr.git
cd skipr

# Start with Docker Compose
docker-compose up -d

# View logs
docker-compose logs -f

Skipr is now running at http://localhost:7005!

Method 2: Local Node.js

# Prerequisites: Node.js 18+ and ffmpeg
git clone https://github.com/LIN4CRE/skipr.git
cd skipr

# Install dependencies
npm install

# Run tests
npm test

# Start the server
npm start

---

⚙️ Environment Variables

Create a .env file to customize your setup:

Variable	Default	Description
PORT	7005	The port Skipr listens on.
PUBLIC_URL	http://127.0.0.1:7005	Publicly reachable URL (for reverse proxies / domain).
DEFAULT_SCRAPER_URL	https://torrentio.strem.fun	Default upstream scraper to pull torrents from.
DEFAULT_DEBRID_PROVIDER	realdebrid	Default debrid service (realdebrid, torbox, etc.).

---

📡 API Endpoints

• GET /manifest.json — Stremio Addon Manifest
• GET /:config/manifest.json — User-configured Addon Manifest
• GET /stream/:type/:id.json — Stream resolver with auto-skip routing
• GET /hls/manifest.m3u8 — Dynamic HLS playlist generator
• GET /configure — Interactive web configurator UI
• GET /health — Addon health status

---

☕ Support the Project

If Skipr saves you time and makes your TV streaming experience better, consider buying a coffee!

👉 Donate via PayPal: paypal.me/dlinacre16

---

📄 License

This project is licensed under the MIT License.