A suite of visual tools for music lovers, integrated with the Last.fm API. This project generates aesthetic reports ("receipts"), listening statistics, and music compatibility analysis, optimized for social sharing (Instagram Stories).
This repository is a Monorepo hosting three distinct tools in subdirectories, serving both the main domain and its subdomains.
The project is organized to handle multiple tools within a single repository:
auvly-fm/
├── index.html
├── assets/
├── css/ & js/
│
├── counter/
│ ├── index.html
│ ├── assets/
│ └── ...
│
├── matcher/
│ ├── index.html
│ ├── assets/
│ └── ...
Click to expand and see what each tool can do.
1. 🎵 AuvlyFM (Main)
A visualization tool designed to generate Last.fm charts based on your scrobble history.
Features:
- Focus: Based purely on scrobble counts.
- Count: Calculates total scrobbles over specific periods: Monthly (30 days) or Weekly (7 days, starting Monday).
- Report generation: Generates 9:16 or 1:1 charts for Top Tracks, Top Artists, or Top Albums.
2. ⏱️ Counter (/counter)
Converts your total scrobbles into estimated listening time (minutes), processing up to the first 1,000 tracks.
Features:
- Focus: Based exclusively on listening duration (minutes).
- Count: Calculates total minutes listened over Monthly (30-day) or Weekly (7-day, starting Monday) periods.
- Report generation: Generates 9:16 or 1:1 charts for Most Listened Tracks, Artists, or Albums based on duration.
3. 👥 Matcher (/matcher)
Compares scrobble data between two users over the last 30 days, identifying shared artists and highlighting unique listening habits for each user.
Features:
- Focus: Based exclusively on user compatibility and taste comparison.
- Count: Analyzes scrobble data from the last 30 days.
- Report generation: Generates 9:16 or 1:1 split-view charts, visually comparing the "vibe" of both users side-by-side.
4. ▶️ Live (/live) — ⛔ Discontinued
This tool has been discontinued. Due to Spotify's new strict API policies requiring a premium developer subscription, the Live tool — which relied heavily on the Spotify API for album artwork and background images — is no longer functional and has been removed.
This project relies on client-side calls to public APIs (Last.fm & Spotify).
API Keys: API Keys used in frontend JavaScript are publicly visible by design.
Important for Forks:
-
Please generate your own API Keys via the Last.fm API Console and Spotify for Developers.
-
NEVER commit a Spotify "Client Secret" to a public repository. If backend authentication is needed, use environment variables or a server-side proxy.
-
Be mindful of API rate limits.
This project integrates Google Analytics 4 (GA4) to track anonymous usage statistics (e.g., popular report formats, screen resolution, and error rates).
-
For Users: No personal data (such as Last.fm session keys or passwords) is stored or sent to Google. We only track interaction events to improve the tools. See our Privacy Policy.
-
For Developers/Forks: The GA tracking script is included in the HTML files. If you fork this repository, please remove or replace the Google Analytics script tag in the
<head>of all HTML files. Failing to do so will send your development/testing data to the official AuvlyFM analytics dashboard.
This project utilizes a direct-to-production workflow tailored for Hostinger:
-
Development: Edits are made directly in the Hostinger environment (or local setup).
-
Version Control: Changes are pushed from the server terminal to GitHub for backup/versioning.
Developed by Snow Mint. AuvlyFM is not affiliated with Last.fm or Spotify. Data is provided courtesy of their respective public APIs.