Settings

Version 1.4.22 Changelog

PlexPy Configuration

Loading configuration table...

PlexPy Scheduled Tasks

Loading scheduler table...

Updates

If you have Git installed, allow periodic checks for updates.

Optional: Use your own GitHub API token when checking for updates.

Display Settings

Set your preferred date format. Click here to see the parameter list.

Set your preferred time format. Click here to see the parameter list.

Change the "Play by day of week" graph to start on Monday. Default is start on Sunday.

Group successive play history by the same user as a single entry in the tables and watch statistics.

Include current activity in the history tables. Statistics will not be counted until the stream has ended.

Set the percentage for a media item to be considered as watched. Minimum 50, Maximum 95.

Backup

The interval (in hours) PlexPy will backup the database and configuration file. Minimum 1, maximum 24, default 6.

The number of days to keep scheduled backups. Minimum 1, default 3.
Note: Manual backups are not removed automatically.

Directories

Sections

Select the sections to show on the homepage. Drag the items below to reorder your homepage content.

Watch Statistics

Select the cards to show in the watch statistics on the home page. Drag the items below to reorder your homepage content.

Specify the number of days for the watch statistics on the home page. Default is 30 days.

Specify the number of items to show in the top lists for the watch statistics on the home page. Maximum 10 items, default 5 items, 0 to disable.

Use play duration instead of play count to generate statistics.

Library Statistics

Select the cards to show in the library statistics on the home page. Drag the items below to reorder your homepage content.

    Web Interface

    Web interface changes require a restart.

    e.g. localhost or an IP, such as 0.0.0.0

    Port to bind web server to. Note that ports below 1024 may require root.

    The base URL of the web server. Used for reverse proxies.

    Respect the X-Forwarded-Proto header. Used for reverse proxies with SSL.


    Launch browser pointed to PlexPy on startup.

    Enable HTTPS for web server for encrypted communication.

    Check to have PlexPy create a self-signed SSL certificate. Uncheck if you want to use your own certificate.

    The domain names used to access PlexPy, separated by commas (,).

    The IP addresses used to access PlexPy, separated by commas (,).

    The location of the SSL certificate.

    The location of the SSL key.

    Authentication

    Authentication changes require a restart.

    Username for web server authentication. Leave empty to disable.

    Password for web server authentication. Leave empty to disable.

    Store a hashed password in the config file.
    Warning: Your password cannot be recovered if forgotten!

    Use basic HTTP authentication instead of the HTML login form.

    Guest Access

    Allow shared users to login to PlexPy using their Plex.tv account. Individual user access needs to be enabled from Users > Edit Mode.

    API

    Allow remote applications to interface with PlexPy.

    Current API key:

    Plex Media Server Version 1.9.1.4272-b207937f1

    If you're using websocket monitoring, any server changes require a restart of PlexPy.

    Enable to have PlexPy check if updates are available for the Plex Media Server.

    Enable to have PlexPy check if remote access to the Plex Media Server goes down.

    IP Address or hostname for Plex Media Server.

    Port that Plex Media Server is listening on.

    Check this if your Plex Server is not on the same local network as PlexPy.

    If you have secure connections enabled on your Plex Server, communicate with it securely.

    Plex Logs

    Set the complete folder path where your Plex Server logs are, shortcuts are not recognized.
    Click here for help. This is required if you enable IP logging (for PMS 0.9.12 and below).

    Plex.tv Authentication

    Token for Plex.tv authentication.

    Friends List

    The interval (in hours) PlexPy will request an updated friends list from Plex.tv. Minimum 1, maximum 24, default 12.

    Refresh the users list when PlexPy starts.

    Libraries List

    The interval (in hours) PlexPy will request an updated libraries list from your Plex Media Server. Minimum 1, maximum 24, default 12.

    Refresh the libraries list when PlexPy starts.

    Extra Settings

    If you have media indexing enabled on your server, use these on the activity pane.

    Enable if you want PlexPy to calculate the total file size for TV Shows/Seasons and Artists/Albums on the media info tables.

    Enable to mask passwords, access tokens, and public IP addresses with asterisks (*) in the logs.
    Note: Only logs from the time this setting is enabled will be masked. Do not post your logs publically without masking sensitive information!

    Enable to cache images from Plex to reduce API calls and improve loading times.
    Note: Video preview thumbnails (BIF) are not cached.

    Backlink protection via anonymizer service, must end in "?".

    Attempt to fix history logging by flushing out all of the temporary sessions in the database.
    Warning: This will reset all currently active sessions. For emergency use only when history logging is stuck!

    Database Import Tool

    Click a button below to import an exisiting database from another app.

    Monitoring Settings

    The interval (in seconds) PlexPy will ping your Plex Server. Minimum 30 seconds, recommended 60 seconds.

    Instead of polling the server at regular intervals let the server tell PlexPy when something happens.

    History Logging

    Keep records of all movie, TV show, or music items played from your Plex Media Server.

    The interval (in seconds) an item must be in a playing state before logging it. 0 to disable.

    Enable this to attempt to log the IP address of the user.

    Buffer Warnings

    Note: Buffer warnings only work on certain Plex clients. Android and PlexWeb do not report buffer events accurately or at all.

    How many buffer events should we wait before triggering the first warning. Buffer events increment on each monitor ping if play state is buffering. 0 to disable buffer warnings.

    The value (in seconds) PlexPy should wait before triggering the next buffer warning. 0 to always trigger.

    Global Notification Settings

    Enable to upload Plex posters to Imgur for notifications. Disable if posters are not being used to save bandwidth.

    Enter your Imgur API client ID in order to upload posters. You can register a new application here.
    Note: The shared Imgur client id will be removed in a future PlexPy update! Please enter your own client id in to continue uploading posters!

    Current Activity Notifications

    Disable to prevent consecutive notifications (i.e. both watched & stopped notifications).

    Enable to only get notified of concurrent streams by a single user from different IP addresses.

    The number of concurrent streams by a single user for PlexPy to trigger a notification. Minimum 2.

    Recently Added Notifications

    Enable to only get one TV Show or Artist notification for a batch of recently added Episodes or Tracks. Movies are unaffected.
    Note: No Season/Episode or Album/Track metadata will be available.

    Set the delay (in seconds) for recently added notifications to allow metadata to be processed. Minimum 60 seconds.

    Custom Notification Messages

    You can set custom formatted text for each type of notification. Click here for a list of available parameters which can be used.

    You can also add tags to exclude certain text depending on the media type. Click here to view usage information.


    Notification Agents

    Toggle the desired notification options by clicking the bell icon () and configure it by clicking the settings icon to the right.


    • Boxcar2
    • Browser
    • E-mail
    • Facebook
    • Growl
    • Hipchat
    • IFTTT
    • Join
    • NotifyMyAndroid
    • Plex Home Theater
    • Prowl
    • Pushalot
    • Pushbullet
    • Pushover
    • Scripts
    • Slack
    • Telegram
    • Twitter
    • XBMC