Convertium

Convertium is a simple python script which recursively looks for video files in configured directories, then automatically reformats them in a style to minimize Plex transcoding by maximizing compatibility with as many devices as possible. By default files will be automatically reformatted to the following file format:

fps = 30
container = .mp4
video codec = h264
audio codec = mp3
resolution = 1920x1080

Note that these options can be changed in your docker-compose.yml if you desire different conversion characteristics.

Usage

All environmental variables are configurable, but below is an example docker-compose.yml file.

version: "3.9"
services:
  convertium:
    restart: unless-stopped
    image: ghcr.io/josiahbull/convertium:main
    volumes:
      - '/media/movies:/movies'
      - '/media/tv:/tv'
    environment:
      # number of minutes between scans
      - SCAN_INTERVAL=20
      # comma separated list of paths to scan
      - BASE_PATHS=/movies,/tv
      # comma separated list of extensions to attempt conversions on
      - VALID_EXTENSIONS=.mp4,.mkv,.avi,.mov,.wmv,.mpg,.mpeg
      # comma seperated list of ffmpeg arguments to pass when converting
      - FFMPEG_ARGUMENTS=-c:v,libx264,-crf,20,-preset,slow,-c:a,mp3,-b:a,192k,-vf,scale=1920:1080,-movflags,+faststart,-loglevel,error,-y
      - PYTHON_ENV=production
      # The times of day between which conversions should occur, strictly in 24-hour format, strictly with only a single pair of timestamps.
      # Optionally, thread limits may be added to the timestamps - this can be used to create a "high performance" time of day,
      # where other tasks may be impacted. Note that 01:00T#7-07:00t#2 would use 7 threads between 1am->7am, and then 2 threads from 7am->1am.
      # setting threads to 0 will disable ANY conversions in that time of day. Omitting a thread requirement will allow unlimited threads.
      - CONVERSION_TIMES=00:00-07:00T#0
    depends_on:
      - postgres

  postgres:
    restart: unless-stopped
    image: postgres
    volumes:
      - './data:/var/lib/postgresql/data'
    environment:
      - POSTGRES_USER=convertium
      - POSTGRES_PASSWORD=convertium
      - POSTGRES_DB=convertium

  autoheal:
    restart: unless-stopped
    image: willfarrell/autoheal
    environment:
      - AUTOHEAL_CONTAINER_LABEL=all
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    depends_on:
      - convertium
      - postgres

Then simply run docker-compose up -d to begin scanning and converting files. Note that this process can be very cpu intensive, as this crate makes no attempt to utilise any hardware support.

Sister Projects

• Renameium - Rename files according to easily customizable and configurable standards.
• Removeium - Remove excess files provided in torrents, to clean up the database.
• Subteium - Automatically strip advertisements and insert subtitle files into videos.
• Convertium - Automatically convert files into a widely supported standard to reduce transcoding.

Licensing and Contribution

Unless otherwise specified, all contributions will be licensed under MIT