From 2ddd30f6215b62e33fce66fcbe7ad46915391095 Mon Sep 17 00:00:00 2001 From: purple_emily Date: Fri, 2 Feb 2024 15:04:00 +0000 Subject: [PATCH 1/3] Add an overview section to the README --- README.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 1cf2349..3faf43a 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,16 @@ -# Torrentio +# Selfhostio -- [torrentio-addon](addon) - the Stremio addon which will query scraped entries and return Stremio stream results. +A self-hosted Stremio addon for streaming torrents via a debrid service. + +## Overview + +Stremio is a media player. On it's own it will not allow you to watch anything. This addon at it's core does the following: + +1. It will search the internet and collect information about movies and tv show torrents, then store it in a database. +2. It will then allow you to click on the movie or tv show you desire in Stremio and play it with no further effort. + +## Using -## Self-hosted quickstart ``` docker-compose up -d ``` From 428bdff413504f48d23ef9fdf7ba012b901065eb Mon Sep 17 00:00:00 2001 From: purple_emily Date: Fri, 2 Feb 2024 15:37:01 +0000 Subject: [PATCH 2/3] Added a section on how to generate a GitHub PAT --- README.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 49 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 3faf43a..248a7aa 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,17 @@ A self-hosted Stremio addon for streaming torrents via a debrid service. +## Contents + +- [Selfhostio](#selfhostio) + - [Contents](#contents) + - [Overview](#overview) + - [Using](#using) + - [Initial setup (optional)](#initial-setup-optional) + - [Run the project](#run-the-project) + - [To-do](#to-do) + + ## Overview Stremio is a media player. On it's own it will not allow you to watch anything. This addon at it's core does the following: @@ -11,13 +22,43 @@ Stremio is a media player. On it's own it will not allow you to watch anything. ## Using -``` -docker-compose up -d -``` -Then open your browser to `127.0.0.1:7000` +The project is shipped as an all-in-one solution. The initial configuration is designed for hosting only on your local network. If you want it to be accessible from outside of your local network, please see [not yet available]() + +### Initial setup (optional) + +After cloning the repository there are some steps you should take to maximise the number of movies/tv shows we can find. + +We can search DebridMediaManager hash lists which are hosted on GitHub. This allows us to add hundreds of thousands of movies and tv shows, but it requires a Personal Access Token to be generated. The software only needs read access and only for public respositories. To generate one, please follow these steps: + +1. Navigate to GitHub settings -> Developer Settings -> Personal access tokens -> Fine-grained tokens (click [here](https://github.com/settings/tokens?type=beta) for a direct link) +2. Press `Generate new token` +3. Fill out the form (example data below): + ``` + Token name: + Selfhostio + Expiration: + 90 days + Description: + + Respository access + (checked) Public Repositories (read-only) + ``` +4. Click `Generate token` +5. Take the new token and add it to the bottom of the [env/producer.env](env/producer.env) file + ``` + GithubSettings__PAT= + ``` + +### Run the project + +Open a terminal in the directory and run the command: + +``` sh +docker compose up -d +``` + +It will take a while to find and add the torrents to the database. During initial testing, in one hour it's estimated that around 200,000 torrents were located and added to the queue to be processed. For best results, you should leave everything running for a few hours. + +To add the addon to Stremio, open a web browser and navigate to: [http://127.0.0.1:7000](http://127.0.0.1:7000) -If you'd like to enable crawling of RealDebridManager's shared hashlists which will massively boost your database cached entries, -enter a readonly github personal access token in 'env/producer.env' as the 'GithubSettings__PAT=' value. -You can scale the number of consumers, by changing the consumer deploy replica count in the compose file on line 87. This is currently set to 3. -If you'd like to adjust the number of concurrent processed ingestions per consumer, thats the job concurrency setting within 'env/consumer.env'. \ No newline at end of file From 1a71d618bd797642780ea3a9b168d578d6aa1e38 Mon Sep 17 00:00:00 2001 From: purple_emily Date: Fri, 2 Feb 2024 15:40:12 +0000 Subject: [PATCH 3/3] Add a simple to do list --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 248a7aa..63de1e5 100644 --- a/README.md +++ b/README.md @@ -62,3 +62,7 @@ It will take a while to find and add the torrents to the database. During initia To add the addon to Stremio, open a web browser and navigate to: [http://127.0.0.1:7000](http://127.0.0.1:7000) +## To-do + +- [ ] Add a section on external access +- [ ] Add a troubleshooting section \ No newline at end of file