Advanced Configuration

Warning!: This article contains information about advanced preferences and configuration settings that should not need to be altered by most users. You need to be careful changing these settings. Check the forums for information about these settings and their usage.


The plexmediaplayer.conf file contains the main settings for the app. The file can be found here:

  • Windows: C:\Users\USERNAME\AppData\Local\PlexMediaPlayer
  • OSX: ~/Library/Application Support/Plex Media Player/
  • RPi2/OpenELEC: /storage/.local/share/plexmediaplayer/

Note: You need to edit this file when PMP is closed. To close PMP when using the OpenELEC/RPi2 you need to SSH into the machine (credentials: root/plex) and close down PMP with  systemctl stop plex. After you have altered the file you start up PMP again with systemctl start plex.

The values you set in the app can be found here plus some more advanced settings that can cause unwanted behavior if set erroneously. It can be opened and edited using Xcode (or an advanced text editor that does not autocorrect any chars like " or similar), and is divided up into six sections:


  • advanced: Toggles the visibility of the advanced audio settings in the app (it also changes behavior - if the advanced options are hidden then they are effectively disabled); default set to false.
  • channels: Should reflect your speaker layout; default set to "2.0".
  • device: Should reflect your audio output interface; default set to "auto".
  • devicetype: Should reflect how you connect from your computer to your receiver/TV; default set to "basic".
  • exclusive: Specifies whether or not you want Plex Media Player to have exclusive access to the audio interface (it's possible to get bit-perfect audio when enabling this on some systems, but also will shut out all other application's audio, and might cause weird behavior due to driver bugs); default set to false .
  • Specifies whether or not you want Plex Media Player to passthrough this specific audio codec; default all set to false.

Related Page: Audio Configuration Guide


  • enabled: Sets whether or not CEC is enabled; default set to true.
  • hdmiport: The HDMI port to which the device is connected. Only used when when the adapter doesn't support auto detection, or when another device switches port because it starts later in the startup chain; default set to 0.
  • verbose_logging: Sets whether or not verbose CEC logging is enabled; default set to false.


  • fullscreen: Sets whether or not the app is rendered in full screen (as opposed to windowed); default set to false.
  • remoteInspector: When set to true this opens up a port (9992) that enables you to debug Plex Media Player; default set to false.
  • updateChannel: Sets which update channel that Plex Media Player should check for updates in; they are as follows:
    • 0 = Stable releases (default)
    • 8 = Plex Pass releases (requires an active Plex Pass subscription)
  • webserverport: Specifies the port which the built-in webserver uses and can be freely changed if the port conflicts with another application; default set to 32433.
  • startupurl: Specifies the URL from which the user interface is fetched; default set to "/konvergo/index.html".
  • hdmi_poweron: RPI only. If set to true, let Plex Media Player switch to the display mode with the highest resolution (and some other criteria). Disabled by default, as it can cause yet unfixed crashes on startup.


  • color: Specifies the main and outline colors for subtitles expressed as hex values; default set to "#EEEEEE,#000000" (light gray and black respectively).
  • placement: Sets the placement of subtitles on the screen expressed as [horizontal],[vertical]; default set to "center,bottom", but can also be set vertically to left or right and horizontally to top or enter.
  • size: Sets the size of subtitles; default set to 32. The unit is resolution-based with 720p screen size as the starting-point. This means that if you have a resolution of 1440p the same unit size (for example 32) would be multiplied by 2. This feature is meant to keep the same proportional size to the window size.


  • audio_delay.24hz: Sets the audio delay value when refresh rate changes to 24hz, expressed in milliseconds; default set to 0.
  • audio_delay.normal: Sets the audio delay value for all videos except 23.976 FPS videos, expressed in milliseconds; default set to 0.
  • cache: Sets the video/audio stream cache size in Mb; default set to 75.
  • debug.force_vo: Useful for debugging only; default set to (blank).
  • deinterlace: Sets whether deinterlace is enabled; default set to false (will not work on OSX if hardware decoding is enabled, or on RPI).
  • directPlay: Sets whether or not video direct play is allowed; default set to true.
  • directStream: Sets whether or not direct stream is allowed; default set to true.
  • hardware_decoding: Sets whether or not hardware decoding is enabled; default set to true.
  • refreshrate.auto_switch: Sets whether or not the app should try to switch refresh rate based on the video FPS; default set to false.
  • refreshrate.delay: Sets the number of seconds to delay the start of a video when refresh rate takes place; default set to 3.
  • sync_mode: Sets which clock to use (audio or display clock) to keep audio and video in sync; default set to audio.

Note: Not all advanced settings may be shown depending on system configuration.


The mpv.conf file enables advanced control over the playback engine (MPV). This file is not generated by default. Simply create a text file in the Plex Media Player folder (for path see the top of this page) and name it mpv.conf and add the settings in which you are interested. Add one setting per line.

Example of content for the file:

video-output-levels=limited Sets color space to 16-235. "limited" and "full" is supported. Default is full.
audio-samplerate=48000 Forces a specific audio samplerate.
speed=2 Doubles the speed of the video. Values between 0.01-100 are valid.
panscan=1 Zooms in on the image. Values between 0.0-1.0 are valid.
keepaspect=no Stretches 4:3 movies to fit a 16:9 screen.
video-rotate=90 Rotates video 90 degrees. Valid values: 0, 90, 180, 270, 360.

Related Page: Complete list of options


This file stores web settings for Plex Media Player.