Replex

Remix your plex hubs

Features

• Merge hubs (recommended rows) from different libraries into a single hub (interleave). Aka have movies and shows in a single row.
• Choose between styles, shelf (default) or hero.
• Remove watched items from hubs.
• Auto load artwork for hero styles.
• Filter hubs by its restrictions (per user hub)
• Disable user state: remove watched badges from hub items.
• Disable leaf count: remove episode count from artwork.
• Force maximum quality.
• Auto select version based on resolution of the client.
• Fallback to different version if selected version is video transcoding.
• Works on every client not only plex web!
• Plays nice with PMM (and without).

How does it work

Replex is an proxy that transforms the communication between the plex media server and plex clients. This allows replex to change some dials that otherwise wouldnt be possible.

Installation

Docker compose example including plex:

version: "3"
services:
  plex:
    image: lscr.io/linuxserver/plex:latest
    container_name: plex
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - VERSION=docker
      # claim from https://plex.tv/claim 
      - PLEX_CLAIM=
    ports:
      - 32400:32400
     volumes:
       - /path/to/library:/config
       - /path/to/tvseries:/tv
       - /path/to/movies:/movies
    restart: unless-stopped
  replex:
    image: ghcr.io/lostb1t/replex:latest
    container_name: replex
    environment:
      REPLEX_HOST: http://plex:32400
      REPLEX_TOKEN: ***** # server admin plex token: https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/
    ports:
      - 3001:80
    restart: unless-stopped
    depends_on:
      - plex

Add your proxy url to plex "Custom server access URLs" (ex http://0.0.0.0:3001) Then access your proxy url http://0.0.0.0:3001

Note: DO NOT run the plex container in host mode. It will cause plex to connect to the local ip instead of the custom url for local clients and bypass replex.

Note: Plex clients are a bit broken with custom urls and unsecured connections. Most wont work if the custom server url is not secure. So for testing the direct web client is fine but after that you want to setup SSL. See the "Remote access" section for more info.

Settings

Settings are set via environment variables

Interleaved rows

Collections hubs with the same name from different libraries will be merged into one on the home screen. So an collection hub named "Trending" in the Movie library will be merged with an collection named "Trending" from a shows library on home.

Note, this does not work on builtin hubs. As i personally dont see then need of mixing those. You can recreate the builtin rows with smart collections if you wish to have that functionality, or with PMM ofcourse.

Hub style

For custom collections you can change the hub style to hero by setting the label "REPLEXHERO" on an collection.

For built in rows you can use the hubidentifier in the REPLEX_HERO_ROWS. See the setting for available know options.

Note: hero style elements uses coverart from plex. Banner or background is not used. Note: Hero elements are not supported for continue watching by plex. You can replicate this functionality by creating a smart collection which filters on in progress and settinf REPLEX_DISABLE_CONTINUE_WATCHING

Exclude watched items

If you want to hide watched items from your hubs, you can set REPLEX_EXCLUDE_WATCHED to true. Alternatively, you can add the label "REPLEX_EXCLUDE_WATCHED" to a collection to exclude watched items from that collection only.

Remote access (force clients to use the proxy)

Because this app sits before Plex the builtin remote access (and auto SSL) will not work and needs to be disabled.

For testing purposes you can access through the browser at http://[replexip]:[replexport] (ex: http://localhost:3001) But if you want other clients to connect to replex you need to setup a reverse proxy with a domain and preferable ssl.

A few easy to setup reverse proxys are: https://caddyserver.com or https://nginxproxymanager.com

Once you have your domain hooked up to replex add your replex url to 'Custom server access URLs' field under network. and lastly disable remote access under remote access.

Clear you clients caches to force plex reloading the custom server url

Note: SSL is highly suggested, some clients default to not allowing insecure connections. And some clients dont even support insecure connections (app.plex.tv)

Reverse proxy

There should be no need for this but if you have a reverse proxy running and dont want to proxy streaming through plex then you can route the following paths and it subpaths directly to plex.

• /video/:/transcode/universal/session
• /library/parts

Redirect streams

If you have for example an appbox it might not be ideal to stream media through replex. As that will take a lot of network resources. You can redirect streams by enabling REPLEX_REDIRECT_STREAMS and optionally set REPLEX_REDIRECT_STREAMS_HOST if it needs to be different from REPLEX_HOST

Note: Plex doesnt handle redirects wel, and will not remeber it. So every chuck of a stream will first hit replex and then gets redirected to actuall download that chuck from the redirect url. So a bit wastefull

Known limitations

• hero hubs on Android devices dont load more content. so hero hubs have a maximum of 100 items on Android.
• On android mobile hero elements in libraries are slightly cutoff. This is plex limitation.
• when exclude_watched is true a maximum item limit per library is opposed of 250 items. So if you have a mixed row of 2 libraries the max results of that row will be 500 items.
• disable_user_state: For movies this works in the webapp. Shows work accross clients

Help it doesnt work!

Replex works on on app.plex.tv but not on my clients

• disable GDM in plex and make sure plex is not directly acccesible. you can use this url to check what servers plex communicates to your clients: https://clients.plex.tv/api/v2/resources?includeIPv6=1&includeRelay=1&X-Plex-Language=en-NL&X-Plex-Token=YOURTOKEN&X-Plex-Client-Identifier=1234
• Try to clear the cache on the client. Old plex domains might linger.