Plex-Auto-Languages

Plex Auto Languages

This application lets you have a Netflix-like experience by auto-updating the language of your Plex TV Show episodes based on the current language you are using without messing with your existing language preferences.

You want to watch Squid Game in korean with english subtitles ?
Set the language for the first episode and don't think about it for the rest of the show. :heavy_check_mark:

You want to watch The Mandalorian in english but still want to watch Game of Thrones in french ?
Don't worry, the language is set per TV Show and it won't interfere. :heavy_check_mark:

You have multiple managed and shared users with various preferences ?
The proper tracks will be selected automatically and independently for all your users. :heavy_check_mark:

Getting Started

The application requires a Plex Token, if you don't know how to find yours, please see the official guide.

The recommended way of running this application is by using Docker. A Docker image is available on Docker Hub and installation instructions are detailed below.

PlexAutoLanguages can also be run natively with Python, see the detailed instructions.

Docker installation

Docker compose minimal configuration

Here is a minimal example of a docker-compose configuration:

version: "3"
services:
  plexautolanguages:
    image: remirigal/plex-auto-languages:latest
    environment:
      - PLEX_URL=http://plex:32400
      - PLEX_TOKEN=MY_PLEX_TOKEN
      - TZ=Europe/Paris
    volumes:
      - ./config:/config

Docker compose advanced configuration

Here is an example of a docker-compose configuration that uses a YAML configuration file config.yaml inside a config directory, see Configuration for more information:

version: "3"
services:
  plexautolanguages:
    image: remirigal/plex-auto-languages:latest
    container_name: PlexAutoLanguages
    environment:
      - TZ=Europe/Paris
    volumes:
      # make sure you have a file named 'config.yaml' in the 'config' dir
      - ./config:/config
    restart: unless-stopped

Kubernetes installation

Here is an example of a Kubernetes manifest file, with inline config.yaml (config content omitted, copy paste into yaml from Configuration below):

…

Python installation

This application requires Python 3 and has only been tested with Python 3.8 and higher.

Start by cloning the repository:

git clone [email protected]:RemiRigal/Plex-Auto-Languages.git

Install the required dependencies:

cd Plex-Auto-Languages
python3 -m pip install -r requirements.txt

Create a YAML configuration file (config.yaml for example) based on the template showed in the configuration section below. Note that only the parameters plex.url and plex.token are required.

You can now start PlexAutoLanguages (don't forget to change the name of the configuration file if yours is different):

python3 main.py -c ./config.yaml

Configuration

The application can be configured either with environment variables or with a YAML file mounted at /config/config.yaml. Every parameter listed in this section can be overriden with the corresponding environment variables (eg. the environment variable PLEX_URL will override the parameter plex.url, NOTIFICATIONS_ENABLE will override the parameter notifications.enable etc...).

The Plex Token can also be provided as a Docker secret, the filepath of the secret must then be specified in the environment variable PLEX_TOKEN_FILE which defaults to /run/secrets/plex_token.

Here is an example of a complete configuration file:

…

License

This application is licensed under the MIT License.