vrchat-jellyfin

a Jellyfin client designed for VRChat

Important

Incomplete Project

While this project is functional, it is not yet complete. The end goal is to have a link that can be pasted into the vrchat client, then use the jellyfin cast feature to control the player like a chromecast. This is not yet implemented, and the current implementation is a workaround.

handles requesting media from jellyfin in a format that can be played in vrchat, as well as proxying urls to bypass the risk of sharing a jellyfin api key

Tips

• If the player has a switch between Video and Stream, use Stream
• I've personally had better luck with the Unity video player over the AVPro one, but both should work
• If you change the video encoding settings, 720p (the default) works best for most devices. I wouldn't go above 1080p unless you have a smaller group or high upload bandwitdh.

Supported Platforms

• VRChat
• Chillout VR
• Resonite (crashes)

These are just platforms that have been tested, feel free to PR with other platforms if you've tested on them

Docker

A docker image is provided for easy deployment:

Running

Docker Compose (recommended):

version: '3'
services:
  vrchat-jellyfin:
    image: ghcr.io/gurrrrrrett3/vrchat-jellyfin:master
    container_name: vrchat-jellyfin
    restart: unless-stopped
    ports:
      - 4000:4000
    environment:
      JELLYFIN_HOST: <http[s]://URL>
      JELLYFIN_USERNAME: <USERNAME>
      JELLYFIN_PASSWORD: <PASSWORD>
      AUDIO_BITRATE: 128000
      VIDEO_BITRATE: 3000000
      MAX_AUDIO_CHANNELS: 2
      MAX_HEIGHT: 720
      MAX_WIDTH: 1280

Docker CLI:

docker run -d \
--name vrchat-jellyfin \
--restart unless-stopped \
-p 4000:4000 \
-e JELLYFIN_HOST=<http[s]://URL> \
-e JELLYFIN_USERNAME=<USERNAME> \
-e JELLYFIN_PASSWORD=<PASSWORD> \
-e AUDIO_BITRATE: 128000 \
-e VIDEO_BITRATE: 3000000 \
-e MAX_HEIGHT: 720 \
-e MAX_WIDTH: 1280 \
ghcr.io/gurrrrrrett3/vrchat-jellyfin:master

Installation (No Docker)

Install Node.js and npm

npm install
npm run build

Rename the .env.example file to .env and fill in the required fields.

It's reccommended to use a process manager like pm2 to keep it running:

pm2 start dist/index.js --name vrc-jellyfin
pm2 save

Make sure to do pm2 startup if you haven't already so it autostarts

Sample Caddy config

Caddy can be used to allow streaming to the web over HTTPS.

media.example.com {
        # VRChat (AVPro) doesn't like tls1.3
        tls {
                # Due to a lack of DHE support, you -must- use an ECDSA cert to support IE 11 on Windows 7
                ciphers TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
        }

        header Strict-Transport-Security "max-age=63072000"
        header X-Content-Type-Options nosniff

        header Content-Security-Policy "
        default-src 'self';
        style-src 'self';
        script-src 'self';
        font-src 'self';
        img-src data: 'self';
        form-action 'self';
        connect-src 'self';
        frame-ancestors 'none';
        "

        # Videos don't require sign-in, just the interface
        @auth {
                not path /v/*
        }

        basicauth @auth {
                vrcuser MY_PASSWORD_HASH # Password can be obtained with `caddy hash-password`
        }

        reverse_proxy 1.2.3.4:4000 {
        }
}

Usage

Go to the web interface (default port is 4000), select media, and copy the link. Paste the link into the vrchat client to play the media.

Progress

• Jellyfin proxy
• Transcoding
• Subtitle Baking
• Audio track selection
• Subtitle track selection
• Temp Web interface
• Support for the jellyfin cast api
• Video Stream generation (splash screen with instructions, etc)
• Docker
• Seeking (not sure if this is possible)