Skip to content
View webstreamr's full-sized avatar

Block or report webstreamr

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
webstreamr/README.md

WebStreamr

Tests GitHub release GitHub License

Stremio add-on which provides HTTP URLs from streaming websites.

HTTP streams have limitations. For a better experience, I'd advise using a Debrid service and WebStreamr as fallback. TorBox is working very well.

Public instance

A public instance is available at https://webstreamr.hayd.uk. Hosting infrastructure for this instance is donated by ElfHosted, and independently maintained by Hayduk.

Known issues / limitations

  • Dropload on Android does not work because Stremio does not use the Referer header properly via HLS playlists: Stremio/stremio-bugs#2389, maybe Stremio/stremio-bugs#1579
  • MediaFlow proxy has to be used in an inefficient way because Stremio on Android or its players cannot deal with HLS playlist with redirects: Stremio/stremio-bugs#1574
  • FlareSolverr cookies cannot be used because Cloudflare does techniques like TLS fingerprinting most likely. But FlareSolverr uses a session per host and should be quick.
  • VidSrc works but rate limits heavily and is therefore only queried as fallback if nothing else is found.
  • RgShows detects shared usage and blocks IPs. It therefore only works on private instances.
  • XDMovies is used as fallback if not more than one other result is found.

MediaFlow Proxy

MediaFlow Proxy can be added when configuration the add-on to gain access to a couple of more file hosters. It depends highly on the language / source used if that unlocks more streams or not.

MediaFlow proxy is needed because some hosters ip-lock streams and the add-on does not run on the same device that will stream the video.

The following hosters can be used only with MediaFlow Proxy:

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

MediaFlow proxy can either be self-hosted or acquired via bundle from ElfHosted.

Hosting

Don't want to use the public instance, or concerned about reliability during periods of high use? It's open-source, you can host it yourself!

ElfHosted (easy mode)

Self-hosting to stressful? ElfHosted offer ready-to-go, turn-key WebStreamr instances with $1, 7-day trials. Additionally, 33% of your subscription directly supports your developer! ❤️

(ElfHosted also offer advanced private hosting of the top Stremio Addons, as well as turn-key bundles providing streaming from RealDebrid with Plex, Emby, or Jellyfin)

Self-Hosting

You can run the latest WebStreamr via Docker. E.g.

 docker run \
    --detach=true \
    --name webstreamr \
    --rm \
    --pull always \
    --publish 51546:51546 \
    --env TMDB_ACCESS_TOKEN="YOUR_TOKEN" \
    --volume /tmp:/tmp \
    webstreamr/webstreamr

Environment variables

CACHE_DIR

Optional. Directory for persistent caches using SQLite files. Default: OS tmp dir.

CONFIGURATION_DESCRIPTION

Optional. To customize the description shown on the configuration page.

DISABLED_EXTRACTORS

Optional. Comma separated list of extractors which should be disabled. E.g. doodstream,vidsrc

DISABLED_SOURCES

Optional. Comma separated list of sources which should be disabled. E.g. frembed,vidsrc

FLARESOLVERR_ENDPOINT

Optional. If domains show Cloudflare challenges, FlareSolverr can be used to work around them. E.g. http://flaresolverr:8191 Proxy configuration is passed-through and only a single session is used to save resources. Byparr is not supported.

MANIFEST_ID

Optional. Add-on manifest ID. Default: webstreamr

MANIFEST_NAME

Optional. Add-on manifest name. Default: WebStreamr

PORT

Optional. Port of the node web server. Default: 51546

PROXY_CONFIG

Optional. Proxies which should be used based on domain. Supports minimatch. E.g. dood.to:http://USERNAME:PASSWORD@IP:PORT,*:socks5://172.17.0.1:1080 would use an http proxy for dood.to and a socks5 proxy for all other domains.

Some hosters are a bit picky when it comes to IPs. Best case is if you use a residential IP. If you can't do that, then I suggest to use a VPN / proxy like Cloudflare WARP. DoodStream is not working with WARP. Free Webshare proxies seem to work with it.

TMDB_ACCESS_TOKEN

Required. TMDB access token to get information like title and year for content. Use the API Read Access Token.

@webstreamr's activity is private