A streamyfin companion server for better downloads
Optimized versions is a transcoding server (henceforth refered to as the server). It acts as a middleman between the Jellyfin server and the client (Streamyfin app) when downloading content. The job of the server is to combine an HLS stream into a single video file which in turn enables better and more stable downloads in the app. Streamyfin can then also utilize background downloads, which means that the app does not need to be open for the content to download.
The download in the app becomed a 2 step process.
- Optimize
- Download
Note: The server works best if it's on the same server as the Jellyfin server.
services:
app:
image: fredrikburmester/streamyfin-optimized-versions-server:master
ports:
- '3000:3000'
env_file:
- .env
environment:
- NODE_ENV=development
restart: unless-stopped
# If you want to use a local volume for the cache, uncomment the following lines:
# volumes:
# - ./cache:/usr/src/app/cacheCreate a .env file following the example below or by copying the .env.example file from this repository.
JELLYFIN_URL=http://your-jellyfin-url
# MAX_CONCURRENT_JOBS=1 # OPTIONAL default is 1A POST request is made to the server with the HLS stream URL. The server will then start a job, downloading the HLS stream to the server, and convert it to a single file.
In the meantime, the app will poll the server for the progress of the optimize.
As soon as the server is finished with the conversion the app (if open) will start downloading the video file. If the app is not open the download will start as soon as the app is opened. After the download has started the app can be minimized.
This means that the user needs to 1. initiate the download, and 2. open the app once before download.
This server can work with other clients and is not limited to only using the Streamyfin client. Though support needs to be added to the clients by the maintainer.