lokeshsg/lexitag repository overview

⁠LexiTag (v0.1.8)

Intelligent Music Metadata Manager with AI-Powered Junk Discovery

LexiTag is a state-of-the-art self-hosted music library manager designed to clean, organize, fetch lyrics, and discover junk in your track metadata using advanced AI search grounding and an asynchronous SQLite engine.

⁠🚀 Quick Start

Deploy LexiTag instantly using Docker Compose:

services:
  lexitag:
    image: lokeshsg/lexitag:latest
    container_name: lexitag
    network_mode: "host" # Required for multicast discovery
    environment:
      - DATA_DIR=/app/data
    volumes:
      - ./data:/app/data
      - /path/to/your/music:/app/music
    restart: unless-stopped

1. Create a docker-compose.yml with the content above.
2. Run docker compose up -d.
3. Access the UI at http://localhost:3030.

⁠🛠 Key Features

• Album Art Gallery: Full-page gallery with group-by-album and flat-track views, multi-select, bulk Apply / Remove, and per-album artwork override workflow.
• Artwork Research Agent: AI-powered cover art search across Apple Music, Spotify, Deezer, Discogs, Wikipedia, MusicBrainz, and Cover Art Archive — with exact album/year matching and source-ranked scoring.
• One-Click Broad Search: Instant discovery of artist/composer discography artwork and related releases without needing custom text prompts.
• Media Server Artwork Synchronization: Synchronizes folder-level images (cover.jpg, folder.jpg) alongside embedded audio tags for seamless Navidrome and Jellyfin compatibility.
• Bounded LRU Image Cache: Client-side LRU cache prevents memory bloat while keeping recently viewed artwork instantly available.
• Instant Hover Track Previews & 1-Click Morphing Sync: Hovering over track number pills previews artwork on demand and transforms the pill into an instant 1-click sync icon button to sync that track's artwork across the entire album without expanding the track drawer.
• Automatic Multi-Screen & Mobile Optimization: Seamlessly responsive UI across mobile phones, tablets, laptops, and ultra-wide displays.
• Periodic Library Auto-Scanner: Configurable background auto-sync scheduler with preset standard frequencies (1h, 6h, 12h, 24h, 7d) and custom minute/hour intervals.
• AI-Powered Tag & Lyrics Enrichment: Uses Gemini Google Search Grounding to clean titles, artists, albums, genres, release years, and fetch full lyrics (including regional & Tamil songs).
• Metadata Protection & Revert System: Retains manual edits during scans and provides 1-click backwards history restoration across all audio formats.
• Multi-Format Audio Support: Full ID3, Vorbis, MP4 atom, and WAV RIFF tag scanning & writing for MP3, FLAC, M4A, and WAV files.
• System Logs & Live Debug Mode: Interactive terminal viewer, runtime log level toggle, and direct log file download directly from the browser UI.

⁠⚙️ Deployment Notes

• Music Path: Ensure the volume mount points to your physical music library (/path/to/your/music:/app/music).
• Database: The SQLite database and settings are persisted in the ./data folder on your host (./data:/app/data).
• Default Port: Access the Web UI on port 3030.

Official Repository: GitHub (Source)⁠