Skip to main content
Media server integrations allow you to monitor active streams, view recently added media, and display media statistics on your Homarr dashboard.

​
Supported Media Servers

Plex

Premium media server with transcoding

Jellyfin

Free and open-source media system

Emby

Feature-rich media solution

​
Plex

Connect your Plex Media Server to monitor streams and display recently added media.

​
Configuration

​
url
string
required
Base URL of your Plex server (e.g., http://plex.local:32400)
​
apiKey
string
required
Plex authentication token (X-Plex-Token)

​
Finding Your Plex Token

1

Open Plex Web App

Navigate to your Plex server in a web browser
2

Open Media Info

Click on any media item and click the three dots (⋯) → “Get Info”
3

View XML

Click “View XML” at the bottom of the info panel
4

Copy Token

Look at the URL bar - the token is after X-Plex-Token=Example: http://plex.local:32400/library/metadata/12345?X-Plex-Token=abcdef123456
Alternative method: Use the Plex Token Finder tool on your account page.

​
Available Features

Monitor who is currently streaming from your server:
  • Username and profile picture
  • Currently playing media (movie/show/music)
  • Client device and application
  • Stream quality and transcoding status
  • Episode and season information for TV shows
Widget: Media Server Widget (Current Sessions mode)
Display your latest media additions:
  • Movie posters and backdrop images
  • TV show season artwork
  • Release dates and ratings
  • Studio/network information
  • Genres and tags
  • Direct links to media in Plex Web
Widget: Media Widget (Recently Added mode)

​
Example Configuration

{
  "name": "My Plex Server",
  "url": "http://192.168.1.100:32400",
  "secrets": {
    "apiKey": "your-plex-token-here"
  }
}

​
Troubleshooting

Common Issue: “Unauthorized” error
  • Verify your token is still valid
  • Regenerate token if it was recently rotated
  • Ensure Homarr IP is not blocked in Plex network settings

​
Jellyfin

Connect your Jellyfin server to track streams and media library updates.

​
Configuration

​
url
string
required
Base URL of your Jellyfin server (e.g., http://jellyfin.local:8096)
​
apiKey
string
required
Jellyfin API key
​
username
string
Username (alternative to API key)
​
password
string
Password (alternative to API key)
You can authenticate with either an API key or username/password credentials.

​
Generating an API Key

1

Open Dashboard

Log in to Jellyfin and click the ☰ menu → Dashboard
2

Navigate to API Keys

Go to Advanced → API Keys
3

Create New Key

Click the + button to create a new API key
4

Name Your Key

Enter “Homarr” as the application name and save
5

Copy Key

Copy the generated API key for use in Homarr

​
Available Features

Real-time stream monitoring with detailed information:
  • User details and profile pictures
  • Playing media with episode/season info
  • Client and device name
  • Video resolution and frame rate
  • Audio codec and channel count
  • Transcoding details (resolution, codecs, container)
Widget: Media Server Widget (Current Sessions mode)
View recently added content:
  • Poster and backdrop images (auto-sized)
  • Movie and TV show details
  • Community ratings
  • Release/premiere dates
  • Genres and studios
  • Direct links to media in Jellyfin Web
Widget: Media Widget (Latest Media mode)

​
Example Configuration

{
  "name": "Jellyfin Server",
  "url": "https://jellyfin.example.com",
  "secrets": {
    "apiKey": "your-jellyfin-api-key"
  }
}

​
Transcoding Metadata

Jellyfin integration provides rich transcoding information: 
{
  "video": {
    "resolution": { "width": 1920, "height": 1080 },
    "frameRate": 23.976
  },
  "audio": {
    "codec": "aac",
    "channelCount": 6
  },
  "transcoding": {
    "target": { "videoCodec": "h264", "audioCodec": "aac" },
    "resolution": { "width": 1280, "height": 720 },
    "container": "mp4"
  }
}

​
Emby

Integrate Emby for stream monitoring and media tracking.

​
Configuration

​
url
string
required
Base URL of your Emby server (e.g., http://emby.local:8096)
​
apiKey
string
required
Emby API key (X-Emby-Token)

​
Generating an API Key

1

Access Dashboard

Log in to Emby and navigate to Dashboard
2

Open API Keys

Go to Advanced → API Keys
3

Create Key

Click New API Key
4

Configure

Enter “Homarr” as the application name and save

​
Available Features

Monitor current streaming activity:
  • User information and avatars
  • Currently playing content
  • Client application and device
  • Episode and album details
  • Series and season information
Widget: Media Server Widget (Active Sessions mode)
Display new media additions:
  • High-quality poster images
  • Backdrop/fanart images
  • Release and creation dates
  • Community ratings
  • Studio information
  • Genre tags
  • Direct links to Emby Web
Widget: Media Widget (Latest Items mode)

​
Example Configuration

{
  "name": "Emby Server",
  "url": "http://192.168.1.150:8096",
  "secrets": {
    "apiKey": "your-emby-api-key"
  }
}

​
Supported Media Types

Emby integration recognizes and categorizes:
  • Movies: Full-length films
  • TV Shows: Series, seasons, and episodes
  • Music: Audio tracks, albums, and audiobooks
  • Books: Digital book content
  • Videos: Generic video files

​
Comparison

FeaturePlexJellyfinEmby
AuthenticationTokenAPI Key or User/PassAPI Key
Session Monitoring✅✅✅
User Profiles✅✅✅
Transcoding InfoBasicDetailedBasic
Media Metadata✅✅✅
ImagesRemote URLsProxiedProxied
Direct Links✅✅✅
Free/Open Source❌✅❌

​
Using Media Server Widgets

After configuring your media server integration:
1

Add Widget

Click Edit Mode → Add Widget → Media Server
2

Select Integration

Choose your configured media server integration
3

Choose Mode

Select “Current Sessions” to show active streams
4

Configure Display

Adjust widget size, refresh interval, and display options
Create multiple widgets with different integrations to monitor all your media servers from one dashboard!

​
Next Steps

Media Organizers

Connect Sonarr, Radarr, and more

Download Clients

Monitor download progress for your media

Build docs developers (and LLMs) love

Get started for freeTalk to us