Doorgaan naar hoofdinhoud
Onofficiële Beta-vertaling

Deze pagina is vertaald door PageTurner AI (beta). Niet officieel goedgekeurd door het project. Een fout gevonden? Probleem melden →

Jellyfin Vue

Jellyfin Vue is een experimentele, alternatieve webbased client voor Jellyfin geschreven in Vue.js.

opmerking

Jellyfin Vue is niet bedoeld om de standaard Jellyfin-webclient te vervangen en is niet compleet qua functionaliteit.

Hieronder vind je beknopte instructies om je eigen Jellyfin Vue-instance op te zetten. Als je je in minstens één van de volgende situaties herkent:

  • Je wilt het snel uitproberen voor de eerste keer

  • Je weet nog niet zeker of je je eigen instance wilt draaien

  • Je hoeft geen app-brede aanpassingen te doen voor gebruikersspecifieke aanpassingen

  • Je hebt een werkende HTTPS-configuratie

Dan kun je waarschijnlijk beter onze gehoste instance gebruiken. Meer informatie vind je in Jellyfin Vue's repository.

Implementatie​

let op

Omdat Jellyfin Vue slechts een interface is voor een Jellyfin-server, gaan al deze instructies ervan uit dat je al een werkende server hebt. Stel deze nu in als je dat nog niet gedaan hebt.

AANBEVOLEN: Docker gebruiken​

  • Als je Docker nog niet hebt, volg dan eerst de officiële installatiehandleiding. Het is ook aanbevolen om je te verdiepen in Compose.

  • Docker Compose wordt nu meegeleverd met Docker, dus je hoeft het niet apart te installeren. Het wordt aangeraden om de oude docker-compose te verwijderen.

  • De version-sleutel is verouderd in Docker Compose en is daaronder niet meer opgenomen.

We gebruiken het volgende docker-compose.yml als uitgangspunt:

services:
  jellyfin_vue:
    container_name: jellyfin_vue
    image: ghcr.io/jellyfin/jellyfin-vue:unstable
    restart: always
    ports:
      - 8080:80
    labels:
      - 'com.centurylinklabs.watchtower.enable=true'

  watchtower:
    container_name: watchtower
    image: ghcr.io/nicholas-fedor/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      TZ: Europe/Madrid
      WATCHTOWER_CLEANUP: 1
      WATCHTOWER_INCLUDE_RESTARTING: 1
      WATCHTOWER_POLL_INTERVAL: 60
      WATCHTOWER_LABEL_ENABLE: 1
    # Needed so watchtower doesn't restart-loop when updating itself
    restart: on-failure
success

Je kunt alles draaiend krijgen door simpelweg docker compose up -d uit te voeren in je terminal in de map waar het docker-compose.yml-bestand staat.

Met dit compose-bestand:

  • Jellyfin Vue is toegankelijk op poort 8080 van de machine waarop de containers draaien

  • Watchtower (fork, de originele versie wordt niet meer onderhouden) zorgt voor het bijwerken van de container naar de laatste commit in de repository. Dit is een goed idee omdat:

    • Momenteel bestaan er geen stabiele releases, alleen prereleases die niet per se aan kwaliteitscriteria voldoen, maar wel belangrijke ontwikkelmijlpalen vertegenwoordigen.
    • Alleen de nieuwste unstable image wordt ondersteund.

Na toegang tot de instance in je browser, word je gevraagd een server toe te voegen. Je kunt je eigen server gebruiken of onze demo- instance op https://demo.jellyfin.org/stable

opmerking

Het serveradres dat je moet invoeren is relatief aan het apparaat waarop je Jellyfin Vue benadert. Bijvoorbeeld, als je Jellyfin-server op 192.168.0.10 staat en je hebt Jellyfin Vue op diezelfde server geïmplementeerd, en je client staat op 192.168.0.20, dan moet je http://192.168.0.10 invoeren, niet http://127.0.0.1 of http://localhost.

Meer informatie over de verbinding met je server vind je in Jellyfin's Vue repository privacy disclaimer

Omgevingsvariabelen gebruiken​

Dit is een voorbeeld van hoe je omgevingsvariabelen instelt in de container door de volgende sleutels toe te voegen aan de jellyfin_vue-definitie in het bovenstaande docker-compose.yml:

environment:
  HISTORY_ROUTER_MODE: 1

Bekijk de volledige referentie van beschikbare omgevingsvariabelen om Jellyfin Vue verder aan te passen naar jouw voorkeur in de wiki van Jellyfin Vue.

Je eigen webserver gebruiken​

Omdat Jellyfin Vue een SPA-webapplicatie is, kun je elke webserver gebruiken om deze te hosten: Apache, nginx (de versie in Jellyfin's Vue Docker-image), Traefik, enz...

Als je al een reverse proxy hebt ingesteld en je wilt complexere dingen doen die buiten het bestek van deze documentatie vallen, zoals hosten op een subpad, in een ander subdomein, enz., dan wil je misschien Jellyfin Vue hosten via je eigen webserver in plaats van de nginx-instance die bij de Docker-image wordt geleverd.

Om dat te bereiken, pas je in de jellyfin_vue servicedefinitie van de hierboven getoonde docker-compose.yml het volgende aan:

  • Verwijder de ports key.

  • Voeg de volgende keys toe, vervang _path_ met de map waar jouw webserver de assets van Jellyfin Vue verwacht:

network_mode: none
volumes:
  - _𝘱𝘢𝘵𝘩_:/dest
# This makes the container do nothing and sleep forever,
# frontend will be copied to _𝘱𝘢𝘵𝘩_ and will be served by your web server
command: /bin/sh -c 'rm -rf /dest/* && cp -r . /dest && sleep infinity'

Deze aanpak:

Handmatig​

let op

Zorg dat je de implicaties begrijpt voordat je deze methoden gebruikt. Geen van deze methoden worden ondersteund door Jellyfin Vue.

docker run​

Als je Docker Compose of geautomatiseerde updates niet wilt gebruiken, maar wel Docker, dan volstaat dit commando:

docker run -d -p 8080:80 ghcr.io/jellyfin/jellyfin-vue:unstable

Van broncode / build-output​

info

Dit is mogelijk niet nodig als je alleen een Pull Request wilt testen. Volg in dat geval deze instructies

gevaar

Vertrouw standaard nooit assets van derden buiten officiële kanalen als je de broncode niet kunt inspecteren. Ze kunnen je systeem compromitteren of je activiteiten volgen!

Omdat Jellyfin Vue een webapplicatie is, komt het gebruik neer op het opzetten van je eigen webserver en deze te laten wijzen naar de assets van Jellyfin Vue. Je kunt deze verkrijgen via:

  • Het zelf bouwen vanuit onze broncode. De wiki van de repository bevat instructies voor het opzetten van de ontwikkelomgeving.

  • Via GitHub's Actions-artefacten.

    • Hoewel deze artefacten zijn gebouwd in onze CI/CD, komen sommige runs van Pull Requests van externe bijdragers die mogelijk kwaadwillend zijn!
    • Alle artefacten gegenereerd door GitHub Actions zijn gebouwd met provenances.
    • Ons officiële Docker-image is gebouwd vanuit GitHub Actions en het hele proces is transparant en controleerbaar.

Andere documentatie​