[Project] Blu-ray Catalog Manager — Full Home Assistant Integration (Flask + TMDB + Dashboard)

Share your Projects!
1

Blu-ray Catalog Manager — Full Home Assistant Integration

Hi everyone!

I’m sharing a project I’ve been building (that I don’t think anyone has ever asked for) to manage physical Blu-ray / 4K UHD collections with full Home Assistant integration.

Its a project I’ve been working for several months (excuse me, I’m no pro programmer and took me some time…) as I was lacking a inventory to quickly track my blu ray movies in the cabinet. I saw my iPad with HA dashboards open and said it would be great to have everything in the same place!

If you collect movies and want a clean, automated dashboard inside HA, this might be useful.

I know its a feature that wasn’t initially intended for HA (but well… a blu ray cabinet has the Home thing in it…) and also that I feel “too small” compared to this huge community of real good technical guys… Just wanted to give back a tiny part of my work and I hope its of some help to anyone who at some point thought on having something similar.

Dashboard-1
Dashboard-12240×1198 164 KB

What it does

  • Flask backend with REST API
  • Web app for editing your catalog (DV, Atmos, runtime, location…)
  • TMDB metadata pipeline (posters, backdrops, overview, year)
  • CSV import from Blu-ray com webpage
  • JSON master catalog (locations.json)
  • Home Assistant REST sensors
  • Lovelace dashboard with:
    • Search
    • Filters (4K, DV, Atmos)
    • Sorting
    • Responsive grid
    • Posters + backdrops

Everything runs locally.

No cloud uploads. Your real catalog stays on your machine. You just keep track of your owned movies on blu-ray.com and then export as CSV… The rest is nearly “magic”.

Home Assistant Dashboard

The dashboard includes:

  • Movie grid
  • Search bar
  • Filters
  • Sorting
  • Poster view
  • Backdrop view
  • Responsive layout for tablets and TVs

Example YAML is included in the repo.

Installation

Quick summary:

  1. Import your Blu-ray web CSV
  2. Run the TMDB resolver
  3. Start the Flask backend
  4. Add REST sensors in Home Assistant
  5. Import the Lovelace dashboard example

Repository

GitHub:

Includes:

  • Full documentation
  • Example files
  • Systemd service
  • Dashboard YAML
  • Screenshots

Roadmap

  • Docker container
  • Statistics dashboard
  • NFC/QR tagging
  • Multi-collection support
  • Automatic TMDB refresh

Suggestions, improvements, and PRs are welcome!

2

This is so cool! This is really cool. Does blu-ray.com cost anything, I couldn’t find it easily on their website? A few months ago I decided to make a google spreadsheet with all of my media, physical and digital, movies and audiobooks. I haven’t really done much with it because it wasn’t easy to update then find what I was looking for in it. I didn’t even think a CSV could be used to put information onto HA. I gotta look into that.

3

Thanks, really! :slight_smile:
No, blu-ray.com its totally free, and also has a mobile app where you can easily add your movies! The bad news its that it has no public API you can retrieve your movies nor get the posters (or I wasn’t able to do so). The “good” news it has a “hidden” part where you can “generate” a CSV (it pastes it on the html and you have to copy/paste into a CSV file). Oh, BTW, its a great place to see the best deals on any country, I totally recommend you to give it a try!

bluray
bluray2528×482 110 KB