Skip to content
 
 

Latest commit

 

History

1,263 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hydra Logo

Hydra

The next-generation HTTP stream aggregator for Stremio. Rebuilt from the ground up to never fail.

Tests GitHub release Website


Hydra is a highly concurrent Stremio add-on which aggregates HTTP streaming URLs natively. This is a significantly enhanced, high-performance, and rebranded evolution of the original webstreamer project.

Hydra introduces next-generation features including Automated Extractor Verification, Intelligent Distributed Caching via Redis, High-Concurrency Fetching (Proxies & Retries), and revolutionary AI Capabilities (Gemini & OpenAI integration) for resilient DOM extraction and stream prioritization!

🌐 Visit the Official Hydra Website

🐉 Key Features

  • 🤖 AI-Powered Fallback: Enter your own Gemini or OpenAI API keys on the configuration page. If our native extractors fail to parse the streaming sources due to structural DOM changes, the AI agent dynamically steps in to analyze the payload and recover the stream links. It heals itself.
  • Intelligent Distributed Caching: Backed by Redis to drastically improve response times globally and reduce load on streaming providers.
  • 🚀 Concurrent & Resilient Architecture: Uses smart proxying, retries, and high-concurrency requests to pull in links faster than ever.
  • 🖥️ Modern Configuration UI: A sleek, dark-mode, glassmorphism setup page to cleanly configure your Stremio Add-On experience and visually test your API keys.
  • Automated Extractor Verification: Constant background verification to ensure our supported streaming hosters remain operational.

Known issues / limitations

  • PixelServer / pixeldrain has a daily limit of 6 GB per IP.
  • Dropload and SuperVideo on Android do not work because Stremio does not use the Referer header properly via HLS playlists.
  • MediaFlow proxy has to be used in an inefficient way because Stremio on Android or its players cannot deal with HLS playlist with redirects.
  • FlareSolverr cookies cannot be used due to TLS fingerprinting, but FlareSolverr uses a session per host to speed things up.
  • VidSrc works but rate limits heavily and is therefore only queried as fallback.
  • RgShows detects shared usage and blocks IPs. It therefore mainly works on private instances.

MediaFlow Proxy

MediaFlow Proxy can be added when configuring the add-on to gain access to more file hosters. It is needed because some hosters ip-lock streams, and the add-on does not run on the same device streaming the video.

The following hosters can be used only with MediaFlow Proxy:

  • Fastream
  • FileLions
  • FileMoon
  • LuluStream
  • Mixdrop
  • Streamtape
  • VOE

Hosting

Don't want to use the public instance? It's open-source, you can host it yourself!

Self-Hosting (Docker)

You can run the latest Hydra via Docker:

```shell docker run
--detach=true
--name hydra
--rm
--pull always
--publish 51546:51546
--env REDIS_URL="redis://your-redis-host:6379"
--volume /tmp:/tmp
zainulnazir/hydra ```

Environment Configuration

REDIS_URL

Optional (but recommended). The connection string to your Redis cache server.

GEMINI_API_KEY / OPENAI_API_KEY

Optional. Global system AI keys for the native fallback extraction framework. Note: Users can also provide their personal API keys directly on the /configure setup page!

GEMINI_MODEL

Optional. Overrides the Gemini model used for AI extraction and Gemini API key testing. Default: gemini-2.5-flash.

CACHE_DIR

Optional. Directory for persistent caches using SQLite files (if not using Redis). Default: OS tmp dir.

FLARESOLVERR_ENDPOINT

Optional. If domains show Cloudflare challenges, FlareSolverr can be used to work around them. E.g. http://flaresolverr:8191.

DISABLED_EXTRACTORS / DISABLED_SOURCES

Optional. Comma separated list of extractors or sources which should be disabled.


🤝 Contributing

We welcome out-of-the-box thinkers, developers, and Stremio enthusiasts to help Hydra grow!

Whether you're fixing bugs, adding new hoster templates to the src/extractor library, or suggesting entirely new features, your contribution matters.

  1. Check out our Contributing Guide for branching, testing, and pull-request standards.
  2. If you find a bug, open an Issue using our Issue Templates.

⚖️ License

This project is licensed under the AGPL-3.0 License. See the LICENSE.txt file for details.

About

Self-hosted Stremio HTTP streaming add-on with AI self-healing extraction, MediaFlow proxy support, and 24 extractors across 21 sources.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages