Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/doingodswork/deflix-stremio
Deflix addon for Stremio
https://github.com/doingodswork/deflix-stremio
addon cache debrid go golang streaming streaming-video stremio stremio-addon stremio-competition torrent torrents
Last synced: 15 days ago
JSON representation
Deflix addon for Stremio
- Host: GitHub
- URL: https://github.com/doingodswork/deflix-stremio
- Owner: doingodswork
- License: agpl-3.0
- Created: 2020-01-19T18:01:31.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-11-19T14:40:03.000Z (12 months ago)
- Last Synced: 2024-08-01T15:04:39.034Z (3 months ago)
- Topics: addon, cache, debrid, go, golang, streaming, streaming-video, stremio, stremio-addon, stremio-competition, torrent, torrents
- Language: Go
- Homepage: https://www.deflix.tv
- Size: 583 KB
- Stars: 130
- Watchers: 11
- Forks: 23
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-stremio - Deflix
README
Deflix Stremio addon
====================
[Deflix](https://www.deflix.tv) addon for [Stremio](https://stremio.com)
Finds movies and TV shows from many different sources and automatically turns them into cached HTTP streams with a debrid service like [RealDebrid](https://real-debrid.com), [AllDebrid](https://alldebrid.com) or [Premiumize](https://www.premiumize.me), for high speed 4k streaming and **no P2P uploading**.
Contents
--------
1. [Features](#features)
2. [Install](#install)
3. [Run locally](#run-locally)
1. [Configuration](#configuration)
2. [Warning](#warning)
4. [Disclaimer](#disclaimer)
Features
--------
- Supports several debrid services
- [x] [RealDebrid](https://real-debrid.com)
- [x] [AllDebrid](https://alldebrid.com)
- [x] [Premiumize](https://www.premiumize.me)
- [ ] Others can be added, please let me know which one you want to see next
- Finds movies and TV shows from many different sources
- [x] YTS
- [x] The Pirate Bay
- [x] 1337x
- [x] RARBG
- [x] ibit
- [ ] Others like RapidMoviez and Scene-RLS are planned
- Groups streams by quality so you don't have to choose between dozens of results
- 720p
- 1080p
- 1080p 10bit
- 2160p
- 2160p 10bit
- Configurable via the ⚙ button in Stremio
Other *upcoming* features: Support for more sources, grouping by bitrate, more custom options (language filter, show *all single torrents* instead of grouped by quality) and more
Install
-------
This addon is a remote addon, so it's an HTTP web service and Stremio just sends HTTP requests to it. You dont't need to run any untrusted code on your machine.
Here's the official Deflix website, that guides you through the installation:
> Note: This repository contains all the latest features and fixes. Some of them might not be publicly deployed yet. If you want to use the version of this repository, run the addon locally.
Run locally
-----------
Alternatively to using the publicly deployed version you can also run the addon locally and use that in Stremio. The addon is written in Go and compiles to a single executable file without dependencies, so it's really easy to run on your machine.
You can use one of the precompiled binaries from GitHub:
1. Download the binary for your OS from
2. Simply run the executable binary (`deflix-stremio.exe` for Windows, `deflix-stremio` for macOS and Linux)
3. Visit in the browser to configure and install the addon in Stremio
4. To stop the program press `Ctrl-C` (or `⌃-C` on macOS) in the terminal windows where `deflix-stremio` is running
Or use Docker:
1. Update the image: `docker pull doingodswork/deflix-stremio`
2. Start the container: `docker run --name deflix-stremio -p 8080:8080 doingodswork/deflix-stremio`
- > Note: `Ctrl-C` only detaches from the container. It doesn't stop it.
- When detached, you can attach again with `docker attach deflix-stremio`
3. Visit in the browser to configure and install the addon in Stremio
4. To stop the container: `docker stop deflix-stremio`
5. To start the (still existing) container again: `docker start deflix-stremio`
### Configuration
The following options can be configured via either command line argument or environment variable:
```text
Usage of deflix-stremio:
-baseURL string
Base URL of this service. It's used in a stream URL that's delivered to Stremio and later used to redirect to RealDebrid, AllDebrid and Premiumize. If you enable OAuth2 handling this will also be used for the redirects and to determine whether the state cookie is a secure one or not. (default "http://localhost:8080")
-baseURL1337x string
Base URL for 1337x (default "https://1337x.to")
-baseURLad string
Base URL for AllDebrid (default "https://api.alldebrid.com")
-baseURLibit string
Base URL for ibit (default "https://ibit.am")
-baseURLpm string
Base URL for Premiumize (default "https://www.premiumize.me/api")
-baseURLrarbg string
Base URL for RARBG (default "https://torrentapi.org")
-baseURLrd string
Base URL for RealDebrid (default "https://api.real-debrid.com")
-baseURLtpb string
Base URL for the TPB API (default "https://apibay.org")
-baseURLyts string
Base URL for YTS (default "https://yts.mx")
-bindAddr string
Local interface address to bind to. "localhost" only allows access from the local host. "0.0.0.0" binds to all network interfaces. (default "localhost")
-cacheAgeXD duration
Max age of cache entries for instant availability responses from RealDebrid, AllDebrid and Premiumize. The format must be acceptable by Go's 'time.ParseDuration()', for example "24h". (default 24h0m0s)
-cachePath string
Path for loading persisted caches on startup and persisting the current cache in regular intervals. An empty value will lead to 'os.UserCacheDir()+"/deflix-stremio/cache"'.
-envPrefix string
Prefix for environment variables
-extraHeadersXD string
Additional HTTP request headers to set for requests to RealDebrid, AllDebrid and Premiumize, in a format like "X-Foo: bar", separated by newline characters ("\n")
-forwardOriginIP
Forward the user's original IP address to RealDebrid and Premiumize. The first "X-Forwarded-For" entry will be used.
-imdb2metaAddr string
Address of the imdb2meta gRPC server. Won't be used if empty.
-logEncoding string
Log encoding. Can be "console" or "json", where "json" makes more sense when using centralized logging solutions like ELK, Graylog or Loki. (default "console")
-logFoundTorrents
Set to true to log each single torrent that was found by one of the torrent site clients (with DEBUG level)
-logLevel string
Log level to show only logs with the given and more severe levels. Can be "debug", "info", "warn", "error". (default "debug")
-maxAgeTorrents duration
Max age of cache entries for torrents found per IMDb ID. The format must be acceptable by Go's 'time.ParseDuration()', for example "24h". Default is 7 days. (default 168h0m0s)
-oauth2authURLpm string
URL of the OAuth2 authorization endpoint of Premiumize (default "https://www.premiumize.me/authorize")
-oauth2authURLrd string
URL of the OAuth2 authorization endpoint of RealDebrid (default "https://api.real-debrid.com/oauth/v2/auth")
-oauth2clientIDpm string
Client ID for deflix-stremio on Premiumize
-oauth2clientIDrd string
Client ID for deflix-stremio on RealDebrid
-oauth2clientSecretPM string
Client secret for deflix-stremio on Premiumize
-oauth2clientSecretRD string
Client secret for deflix-stremio on RealDebrid
-oauth2encryptionKey string
OAuth2 data encryption key
-oauth2tokenURLpm string
URL of the OAuth2 token endpoint of Premiumize (default "https://www.premiumize.me/token")
-oauth2tokenURLrd string
URL of the OAuth2 token endpoint of RealDebrid (default "https://api.real-debrid.com/oauth/v2/token")
-port int
Port to listen on (default 8080)
-redisAddr string
Redis host and port, for example "localhost:6379". It's used for the redirect and stream cache. Keep empty to use in-memory go-cache.
-redisCreds string
Credentials for Redis. Password for Redis version 5 and older, username and password for Redis version 6 and newer. Use the colon character (":") for separating username and password. This implies you can't use a colon in the password when using Redis version 5 or older.
-rootURL string
Redirect target for the root (default "https://www.deflix.tv")
-socksProxyAddrTPB string
SOCKS5 proxy address for accessing TPB, required for accessing TPB via the TOR network (where "127.0.0.1:9050" would be typical value)
-storagePath string
Path for storing the data of the persistent DB which stores torrent results. An empty value will lead to 'os.UserCacheDir()+"/deflix-stremio/badger"'.
-useOAUTH2
Flag for indicating whether to use OAuth2 for Premiumize authorization. This leads to a different configuration webpage that doesn't require API keys. It requires a client ID to be configured.
-webConfigurePath string
Path to the directory with web files for the '/configure' endpoint. If empty, files compiled into the binary will be used
```
If you want to configure deflix-stremio via environment variables, you can use the according environment variable keys, like this: `baseURL1337x` -> `BASE_URL_1337X`. If you want to use an environment variable prefix you have to set it with the command line argument (for example `-envPrefix DEFLIX` and then the environment variable for the previous example would be `DEFLIX_BASE_URL_1337X`.
### Warning
If you *run* this web service on your local laptop or server, i.e. if you *self-host* this, you should know the following:
Deflix doesn't download or upload any torrents, but it *does* send HTTP requests to YTS, The Pirate Bay, 1337x, RARBG and ibit, which *might* be illegal in some countries. Streaming movies and TV shows from RealDebrid, AllDebrid or Premiumize *might* also be illegal in some countries.
> To encrypt your traffic so that your ISP can't see where those HTTP requests are sent and to not expose your real IP address to RealDebrid, AllDebrid or Premiumize you can use a VPN.
Disclaimer
----------
Deflix
- doesn't *host* any media files or torrents
- doesn't *provide link lists* to media files or torrents
- isn't a *torrent indexer*
- doesn't *facilitate the sharing* of any media files or torrents