search

detarkende / stremio-ncore-addon

A self-hostable Stremio addon that lets you stream content straight from nCore.
MIT License
38 stars 7 forks source link

Installation guide for beginners #19

Open telattila opened 5 days ago

telattila commented 5 days ago

The target audience of the addon is the segment of the public who don't want to or can't search for torrents, download them and then download them on TV. This layer is unlikely to consist of programmers. However, it requires a thorough knowledge of the installation process. I was given the task, I am a programmer (in a different field) and so I got stuck.

If someone could help me set it up, in return I will undertake to do a beginner's guide to installation.

The setup: windows based machine, always on, accessible on local network, client on android TV.

I put a ubuntu linux on a virtualbox, installed the docker, started the addon. The url http://192.168.0.195:3000/manifest.json is available on the client. The stremio://192.168.0.195:3000/manifest.json url throws ERR_OPENING_MEDIA error in the stremio client.

Where I am unsure:

detarkende commented 5 days ago

Thanks for the feedback, I think it is valid, and I should provide better tutorials for setting up the addon.

However, I'd like to point out a couple of things:

  1. This project is very much in its early days. The v0.1 and v0.2 releases were still a proof of concept. I'm currently working on a big update that should address code quality and include some admin ui updates.
  2. The target audience is not the end users here. The target audience here is tech-savvy people, who will set it up on their own computers and then share it with their friends and family. (Although, as you said, even as a programmer, you got stuck, so the guide is not easy enough for tech savvy people either. I should work on that.)

To answer your actual question:

  1. ADDON_URL should be set to wherever the client can reach the server. If it's a local IP, then you should set it to that. HOWEVER, using the addon without https (for which, you will need a domain) is not recommended and it might not work well. Some clients can connect to addons through http (android tv is one of them as far as I know), but other clients (like the web, LG tv, Samsung tv, etc.) can not connect to http urls. This is out of my control.
  2. Configuring https is really different for each person. It could depend on your domain registrar, whether your server is reachable through port-forwarding or something like Cloudflare tunnels, whether you already have something set up for your domain...

To address these difficulties, I'm considering making a video tutorial and a short "Beginner's guide". This would include instructions for people who are absolute beginners to self-hosting. What do you think about such a guide?

detarkende commented 5 days ago

Also, I think you can fix your issue, by going to http://192.168.0.195:3000/configure, signing in. Once you sign in, you should see a "Configure" button and a "Configure on the web" button. Below them is a box with an url in it. Copy that url and paste it into the pop-up on android tv, when adding the addon. ergo something like: http://192.168.0.195:3000/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIn0.Gfx6VO9tcxwk6xqx9yYzSfebfeakZp5JYIgP_edcw_A/manifest.json.

Hope this helps.

telattila commented 5 days ago

Thanks your help, @detarkende I have now added the plugin to the client. One more little thing is missing, because no ncore source appeared anywhere. I'll reconfigure the server, if it doesn't help I'll work out the https. This will take a few days. If I can get it together, I'll summarize the steps to have a complete issue. Thanks again.