🎵 Audiseerr

A music discovery and request app for Lidarr - Like Overseerr/Jellyseerr, but for music!

✨ Features

• 📊 Charts - View Top 10 Albums and Singles from Australia and USA (iTunes)
• 🔍 Discover - Personalized recommendations based on your library's genres
  • Full Library Scan - Scans ALL artists in your library for similar artists
  • Artist Linked - Each recommendation shows which library artists it's based on
  • Genre Filtering - Filter recommendations by genre
  • Progress Indicator - See real-time scanning progress
• 🔥 Trending - Multiple trending sources including:
  • 🔥 Hot Right Now (iTunes Hot Tracks)
  • 📊 Deezer Global Charts
  • 💿 New Album Releases
  • ✨ Fresh Releases (iTunes + MusicBrainz)
• 🏷️ Genre Browsing - Click genres to discover artists by style
• 📚 Library Sync - See what you already have in Lidarr
  • Artist Details - Click any library artist to see their info and similar artists
• ➕ One-Click Requests - Add artists to Lidarr with full discography download
• 📋 Request History - Track all requests with status and remove option
• 🎯 Smart Integration - Seamlessly connects with your Lidarr instance
• 📱 Mobile Responsive - Hamburger menu and responsive design
• 🐳 Docker Ready - Lightweight container deployment
• 💾 SQLite Database - Simple, portable data storage

🚀 Quick Start

Docker Compose (Recommended)

version: '3.8'

services:
  Audiseerr:
    build: .
    container_name: Audiseerr
    restart: unless-stopped
    ports:
      - "5055:3000"
    volumes:
      - ./data:/app/data
    environment:
      - NODE_ENV=production

docker-compose up -d

Then visit http://localhost:5055

Manual Installation

# Clone the repository
git clone https://github.com/yourusername/Audiseerr.git
cd Audiseerr

# Install dependencies
npm install

# Start the server
npm start

⚙️ Configuration

Lidarr Setup

1. Open Audiseerr in your browser
2. Go to Settings (gear icon)
3. Enter your Lidarr details:
   • Lidarr URL: e.g., http://localhost:8686 or http://lidarr:8686
   • API Key: Found in Lidarr → Settings → General → API Key
4. Click Test Connection
5. Select your preferred Quality Profile, Metadata Profile, and Root Folder
6. Click Save Profiles

Environment Variables

Variable	Description	Default
PORT	Server port	3000
DB_PATH	SQLite database path	./data/Audiseerr.db
LASTFM_API_KEY	Optional: Last.fm API key for enhanced discovery	-

📱 Screenshots

Home - Charts

View the top albums and singles from Australia and USA iTunes charts. Australian charts are displayed first.

Discover

Get personalized artist recommendations based on the genres in your Lidarr library. Filter by genre to find exactly what you're looking for.

Trending

Browse multiple trending sources:

• Hot Right Now - Artists from iTunes hot tracks
• Deezer Global Charts - Most streamed artists worldwide
• New Album Releases - Artists with new albums out
• Fresh Releases - Latest singles and tracks

Library

See all artists synced from your Lidarr library with album and track counts.

Requests

Track all your artist requests and their status. Remove requests to mark them as deleted (keeps history). Option to also remove from Lidarr.

🛠️ Tech Stack

• Backend: Node.js + Express
• Database: SQLite (via better-sqlite3)
• Frontend: Vanilla JS + Tailwind CSS (CDN)
• Data Sources:
  • iTunes RSS (Charts, Hot Tracks, New Releases)
  • Deezer API (Global Charts)
  • MusicBrainz (New Releases)
• Integration: Lidarr API v1
• Recommendations: Background engine analyzes library genres

📡 API Endpoints

Settings

• GET /api/settings - Get app settings
• POST /api/settings - Save app settings

Lidarr Integration

• GET /api/lidarr/test - Test Lidarr connection
• GET /api/lidarr/search?term= - Search for artists
• POST /api/lidarr/request - Request an artist
• POST /api/lidarr/sync - Sync library from Lidarr
• GET /api/lidarr/library - Get cached library

Charts

• GET /api/charts/all - Get all charts (AU + US, albums + singles)
• GET /api/charts/us/albums - US Top 10 Albums
• GET /api/charts/us/singles - US Top 10 Singles
• GET /api/charts/au/albums - AU Top 10 Albums
• GET /api/charts/au/singles - AU Top 10 Singles

Discover & Trending

• GET /api/discover - Get personalized recommendations
• GET /api/discover/trending - Get categorized trending artists
• GET /api/discover/genres - Get trending genres
• GET /api/discover/genre/:genre - Get artists by genre

Requests

• GET /api/requests - Get all requests
• DELETE /api/requests/:id - Remove a request (marks as removed, optionally deletes from Lidarr)

🐳 Docker Network

If running Lidarr in Docker, make sure Audiseerr can reach it:

services:
  Audiseerr:
    # ... config
    networks:
      - your-media-network

networks:
  your-media-network:
    external: true

Then use http://lidarr:8686 as the Lidarr URL.

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a feature branch
3. Submit a Pull Request

📄 License

MIT License - feel free to use this project however you like!

🙏 Credits

• Inspired by Overseerr and Jellyseerr
• Chart data from iTunes RSS feeds
• Global charts from Deezer API
• Artist metadata from MusicBrainz

---

Made with ❤️ for music lovers and home media enthusiasts