README.md

Tidbyt + Plex

Tidbyt app that shows what's currently playing on your Plex media server.

Installation

This app is not available through Tidbyt's mobile app as it uses features that (for security reasons) are not supported in community apps that run on Tidbyt's official app server.

Instead, it needs to be run using Pixbyt, a self-hosted Tidbyt app server for advanced apps.

1. Set up Pixbyt

1. Create your own Pixbyt repo
2. Configure your Tidbyt

2. Install the app

1. Add this repo as a submodule under apps:

   git submodule add https://github.com/DouweM/tidbyt-plex.git apps/plex

2. Add an update schedule to apps.yml under schedules::

   schedules:
   # ...
   - name: plex
     interval: '* * * * *' # Every minute
     job: plex

Configuration

Update .env with your configuration:

PLEX_URL="<url>" # Plex Server URL. If HTTPS, certificate must be valid. Example: 'http://my-nas:32400'
PLEX_TOKEN="<token>" # Plex API Token. See https://support.plex.tv/ articles/204059436-finding-an-authentication-token-x-plex-token/
PLEX_USER_NAME="<user name>" # Filter: User Name. Leave blank to consider  sessions from all users
PLEX_DEVICE_TYPE="<device type>" # Filter: Device Type. Leave blank to  consider sessions from all types of devices. Example: 'Apple TV'
PLEX_MODE="<mode>" # Display Mode. Choose between 'now_playing' (default) and 'recently_added'

Usage

Build and launch your Pixbyt app server:

1. Build the app server
2. Launch the app server