# MediaRoulette

MediaRoulette is a self-hosted web app for Plex that randomly selects from your movies, TV shows, or both. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3040/mediaroulette

## Description

MediaRoulette is a self-hosted web app for Plex that randomly selects from your movies, TV shows, or both. It uses optional filters, watchlists, and Plex OAuth to help people with large libraries avoid decision fatigue without storing credentials.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

32/100 (Low), based on 3 of 4 factors.
- Maintained: 44 (last commit 288 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/mediaroulette-1g3xvfn0ap0ogn?q=MediaRoulette

## Common questions

### Which port does MediaRoulette use by default?

The application defaults to port 5000, and the Docker examples map host port 5000 to container port 5000.

### Should I generate my own SECRET_KEY?

Yes, especially if exposing the app outside your local network. It is used to sign session cookies and should be a random value instead of the development default.

### What data should I back up?

All user data is in the /app/data directory, including config.json for Plex connection settings and watchlist.json for saved items. Mount that directory as a volume to persist it across container restarts.

### How does MediaRoulette connect to Plex?

It uses Plex OAuth. You sign in from the app, enter the code Plex provides, then choose your Plex server and libraries in Settings.

---
Source: Our Local Host (https://ourlocalhost.com/app/3040/mediaroulette), the self-hosted and open-source app directory.
