Repolode
Submit
TheWicklowWolf

TheWicklowWolf/SonaShow

A web GUI that recommends TV shows similar to the shows already in your Sonarr library, using TMDB data.

View on GitHub
Stars
81
Forks
1
Open issues
0
Last commit
3 months ago

What is it?

SonaShow is a web interface for discovering new TV shows. You select shows from your Sonarr library, and it finds similar titles using TMDB, then lets you add the results back to Sonarr.

The app runs as a Docker container with a web UI on port 5000. It connects to Sonarr through its URL and API key, and to TMDB and TVDB through their API keys. Recommendations can be filtered by minimum rating, minimum vote count, and ISO-639 language code. Matching can fall back to the top search result when no exact match is found.

When adding shows, it can set Sonarr's quality and metadata profiles, root folder, and whether to search for missing episodes. A dry-run mode lets you preview additions without changing Sonarr.

Key features

  • 01Recommends shows similar to selected Sonarr series using TMDB.
  • 02Adds recommended shows to Sonarr directly from the web UI.
  • 03Filters results by minimum rating, vote count, and language.
  • 04Configurable Sonarr quality and metadata profiles and root folder.
  • 05Dry-run mode previews additions without changing Sonarr.
  • 06Ships as a Docker image with environment-variable configuration.

Use cases

  • Finding new shows to watch based on titles already in your Sonarr library.
  • Expanding a media server library with related series in one step.
  • Previewing which recommended shows would be added before committing changes.

Quick start

  1. 1

    Create a docker-compose.yml with the README service definition

  2. 2

    Set Sonarr and TMDB API keys and other settings as environment variables

  3. 3

    Start the container with docker-compose

    docker-compose up -d

Things to know

  • Requires a running Sonarr instance and a TMDB API key.
  • Configuration is done through environment variables, so self-hosting takes some setup.

In collections

Self-hosted apps

Topics

#sonarr#tmdb#recommendations#tv-shows#docker#media-server#self-hosted

FAQ

What is SonaShow?
A web GUI that recommends TV shows similar to the shows already in your Sonarr library, using TMDB data. SonaShow is a web interface for discovering new TV shows. You select shows from your Sonarr library, and it finds similar titles using TMDB, then lets you add the results back to Sonarr.
Is SonaShow free to use? What license does it have?
SonaShow is open source under the MIT license. Check the license terms before using it in commercial products.
Is SonaShow still maintained?
Updated within 6 months. The last commit to SonaShow was on Aug 21, 2026.
What can I use SonaShow for?
Finding new shows to watch based on titles already in your Sonarr library. Expanding a media server library with related series in one step. Previewing which recommended shows would be added before committing changes.
How do I install SonaShow?
Create a docker-compose.yml with the README service definition Set Sonarr and TMDB API keys and other settings as environment variables Start the container with docker-compose: docker-compose up -d
Where can I get SonaShow?
The source code and installation instructions are on GitHub: https://github.com/TheWicklowWolf/SonaShow

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects