MediaSage
github.com
What it is
MediaSage is a free, MIT-licensed self-hosted web app for building Plex playlists and recommending albums from a music library. Users can describe a playlist in natural language or start with a selected song; prompts can include mood, era, instrumentation, genre, production style, and a seed track. Album suggestions can focus on owned albums or look beyond the library. Filters cover library genres, decades, minimum rating, and excluding live recordings. The app syncs Plex music data to a local SQLite database for filtering and track selection. Users can preview tracks, create or update playlists, and send tracks to active Plex clients. It works with Google Gemini, Anthropic Claude, OpenAI GPT, Ollama, and custom OpenAI-compatible APIs, and displays estimated provider costs before generation. Setup requires Docker or Python 3.11 or newer, a Plex server containing music, a Plex token, and an AI provider key or local model. The maker documents Linux, macOS, and Windows use, with NAS instructions for Synology, Unraid, and TrueNAS SCALE. Approximate provider capacity limits are listed, and local model support is described as experimental.
Spec sheet
- Purpose
- MediaSage is a self-hosted web app that generates Plex playlists and album recommendations using music in the user’s library.Read 9 Oct 2026 · github.com
- Deployment
- The maker documents Docker installation and direct Python installation on Linux, macOS, and Windows, including NAS examples.Read 9 Oct 2026 · github.com
- License
- The repository identifies the software as MIT licensed.Read 9 Oct 2026 · github.com
- Maker
- The repository owner is identified on GitHub as Eric Wilson; no headquarters or founding date is stated on the maker pages opened.Read 9 Oct 2026 · github.com
- AI integrations
- It supports Google Gemini, Anthropic Claude, OpenAI GPT, Ollama, and custom OpenAI-compatible APIs.Read 9 Oct 2026 · github.com
- Album recommendations
- It recommends albums in library mode or discovery mode and offers familiarity controls, a written pitch, and secondary picks.Read 9 Oct 2026 · github.com
- Cost disclosure
- The app displays estimated provider cost before generation; the README lists a free Gemini API tier and describes Ollama as free.Read 4 Oct 2026 · github.com
- Filtering
- Users can filter by their library’s genre tags, decade, minimum rating, and whether to exclude live recordings.Read 9 Oct 2026 · github.com
- Library-aware playlists
- It offers natural-language playlist prompts and playlists based on a seed track’s mood, era, instrumentation, genre, or production style.Read 9 Oct 2026 · github.com
- Limits
- The page lists approximate provider track capacities of 18,000 for Gemini, 3,500 for Claude, and 2,300 for OpenAI.Read 9 Oct 2026 · github.com
- Local data
- It syncs the Plex music library to a local SQLite database for filtering and track selection.Read 4 Oct 2026 · github.com
- Local processing
- A local SQLite cache supports library filtering and counting, and local language models are available for privacy and zero API costs.Read 9 Oct 2026 · github.com
- Plex integration
- MediaSage syncs a Plex music library and can create, replace, or append playlists and send tracks to active Plex devices.Read 9 Oct 2026 · github.com
- Plex playback
- Users can send tracks to active Plex clients, create or update playlists, and preview tracks before saving.Read 4 Oct 2026 · github.com
- Provider limits
- The README lists approximate maximum track counts of 18,000 for Gemini, 3,500 for Claude, and 2,300 for OpenAI, and says local model support is experimental.Read 4 Oct 2026 · github.com
- Requirements
- Setup requires Docker or Python 3.11+, a Plex server with music, a Plex token, and an AI provider API key or local model.Read 9 Oct 2026 · github.com
- Security and privacy
- The maker describes local-model support as experimental and says it enables privacy and zero API costs; no security certification is stated on the page.Read 9 Oct 2026 · github.com
- Supported environments
- The README describes running it on Linux, macOS, or Windows, and gives NAS installation instructions for Synology, Unraid, and TrueNAS SCALE.Read 4 Oct 2026 · github.com
- Usage costs
- The app page lists estimated typical AI costs by provider and says Google Gemini has a free API tier for personal use.Read 9 Oct 2026 · github.com
Strong points and limits
Strong points
- Builds playlists from prompts or a selected song.
- Offers owned-library and discovery album recommendation modes.
- Filters by genre, decade, rating, and live status.
- Previews tracks and sends them to active Plex clients.
- Estimated provider cost appears before generation.
Limits
- Requires a Plex server with music and a Plex token.
- Setup requires Docker or Python 3.11 or newer.
- Local model support is experimental.
- Provider track capacities vary and are listed as approximate.
Who it suits
It suits Plex music-library owners who want playlist generation or album suggestions based on their collection. It also fits users comfortable setting up a self-hosted app and supplying an AI provider or local model.
Verdict
MediaSage combines Plex-aware playlist creation, album suggestions, and playback actions in a self-hosted app. Its requirements and provider capacity limits are important to check for the size of your library.
Where Specifiction places it
- AI Music Playlist Generators#19 of 237.4