Hal.f (minimal)

A tiny Home Assistant custom integration that scrobbles tracks from selected media_player entities to Last.fm.

What it does

• Authenticates once during setup and stores the Last.fm session key.
• Lets you enable/disable scrobbling per media player (integration options).
• Tracks playback sessions per player.
• Sends one track.updateNowPlaying per session after a short debounce.
• Sends one track.scrobble when playback reaches scrobble threshold.
• Emits HA event lastfm_scrobble_status for now_playing, scrobble, skip, fail, and duplicate_blocked.

Install

Copy custom_components/hal_f into your Home Assistant config custom_components directory and restart HA.

Setup

Add integration: Hal.f

Required:

• API Key
• API Secret
• Last.fm Username
• Last.fm Password (used only at setup to fetch session key)

Then open integration options and select enabled media_player entities.

Notes

• Duplicate guards:
  • in-session scrobble_sent
  • short-term dedupe cache keyed by player + track identity
• Fallback scrobble threshold is used when duration is missing.