Skip to content

v1.1.0 - 2026-08-07 πŸ‘‹β€‹

Choose a tag to compare

@bastgau bastgau released this 07 Aug 00:16
· 20 commits to main since this release
92f2645

Summary

First stable release of a complete HACS integration for BetaSeries, providing full visibility into your TV series/movie tracking account and built-in automation tools.

Features Delivered

Authentication

  • Secure OAuth Device Flow (no password storage)
  • Basic Authentification Flow
  • Reauth to update credentials
  • Support: Home Assistant 2026.7.0+

Sensors (15 sensors)

  • Account stats: episodes to watch, time to spend, progress, badges, XP, streaks, etc.
  • Timestamps: last aired episode / next episode to air
  • Watchlist: number of shows to catch up on + preview of next episodes per show

Binary Sensors (2)

  • Episodes available
  • Movies available

Calendar

  • Calendar view of current and upcoming month episode releases
  • Includes show poster images, streaming platforms, links to BetaSeries

Services (10 actions)

  • Mark episode/season watched/unwatched
  • Rate episode/season/show (1-5)
  • Unrate episode/season/show

Configuration

  • User-friendly setup: device code flow + OptionsFlow
  • Customizable: refresh intervals (15/60/30 min defaults), calendar month window
  • API response language: FR/EN

Quality

  • CI/CD: linters (ruff/pylint/pyright/docstring-linter), integration tests, hassfest/HACS validation
  • No external dependencies beyond Home Assistant

Architecture

  • 3 coordinators: Member (15 min), Planning (60 min), WatchList (30 min)
  • Bundled API client: faithful to BetaSeries API, independently usable
  • Diagnostics: aggregated export only, no personal show titles exposed

Technical Highlights

  • Handles token rejection with automatic reauth
  • Multi-month cache for calendar (only refetch missing past months)
  • Bulk requests on /shows/display for artwork/ratings (optimized)
  • Locale parameter tested and fixed (EN/FR supported)

Deliverables

  • HACS custom component ready for submission