Introduction

MusicKeeper (formerly part of the Timekeeper suite) is a specialized tool for music enthusiasts. It automates the collection of listening data from ListenBrainz and transforms raw logs into meaningful, AI-analyzed insights delivered directly to Discord.

The Architecture

• Collector: Python service that polls FreshRSS feeds to ingest track data.
• Analysis Engine: Integrates the Gemini 1.5 Pro API to analyze weekly and monthly trends, identifying genre shifts and favorite artists.
• Storage: SQLite database with unique GUID constraints to ensure data integrity and prevent duplicates.
• Delivery: Discord Webhooks for automated daily, weekly, and monthly "Listening Reports."

Key Features

• AI Sentiment Analysis: Uses LLMs to describe the "mood" and "evolution" of listening habits over time.
• Cross-Service Sync: Bridges ListenBrainz data via FreshRSS into a local, searchable database.
• Automated Reporting: Generates beautiful Discord summaries including top artists, tracks, and genre breakdowns.