Ludanta

Now Playing on Plex/Jellyfin

Ludanta is a lightweight command-line tool that displays what's currently playing on your Plex and/or Jellyfin media servers. Get real-time updates about media playback across your servers directly in your terminal.

Features

• Real-time playback monitoring for both Plex and Jellyfin servers
• Support for multiple media types (movies, TV shows, music, and live TV)
• Clean, color-coded output for easy reading
• Transcoding status indicators
• Built-in version checking and update mechanism
• Automatic configuration backup during updates

Screenshots

Requirements

• curl
• xmlstarlet
• jq
• tput
• Plex and/or Jellyfin server
• Plex token (for Plex monitoring)
• Jellyfin API key (for Jellyfin monitoring)

Installation

Quick Start

mkdir Ludanta && cd Ludanta && curl -o ludanta.sh https://raw.githubusercontent.com/jeremehancock/Ludanta/main/ludanta.sh && chmod +x ludanta.sh

Manual Installation

1. Clone the repository:

git clone https://github.com/jeremehancock/Ludanta.git

2. Change directory:

cd Ludanta

3. Make the script executable:

chmod +x ludanta.sh

Configuration

Edit the script and configure your server settings:

# Plex Configuration
PLEX_ENABLED=true                              # Set to false to disable Plex checking
PLEX_URL="http://localhost:32400"              # Your Plex server URL
PLEX_TOKEN=""                                  # Your Plex token (X-Plex-Token)

# Jellyfin Configuration
JELLYFIN_ENABLED=true                          # Set to false to disable Jellyfin checking
JELLYFIN_URL="http://localhost:8096"           # Your Jellyfin server URL
JELLYFIN_API_KEY=""                            # Your Jellyfin API key

Finding Your Credentials

• Plex Token: Follow the instructions here
• Jellyfin API Key: In Jellyfin, go to Dashboard → API Keys to generate a new key

Usage

Basic Usage

./ludanta.sh

Command Line Options

-v    Show version information
-u    Update to latest version
-d    Show extra details for streams

Output Format

Ludanta displays currently playing media in the following format:

Now Playing on SERVER (Plex):
Show Name - Episode Title ................... Username •

Now Playing on SERVER (Jellyfin):
Movie Title ................... Username •

The bullet point (•) indicates that transcoding is active for that stream.

You can also use the -d flag to give more details for each stream.

Updates

Ludanta includes an automatic update system that:

• Creates backups of your current version
• Preserves your configuration settings
• Downloads the latest version from the repository
• Verifies successful updates

To update:

./ludanta.sh -u

Note

Ludanta needs to be on the same network as your Plex Media Server to run.

If you want to connect remotely you will need to use something like Tailscale to ensure that Ludanta can communicate with your Plex Media Server.

License

MIT License

AI Assistance Disclosure

This tool was developed with assistance from AI language models.