HUB
Sign inSign up
lexitag logo

lokeshsg/lexitag

By lokeshsg

•Updated 15 days ago

Self-Hosted Music Metadata, Lyrics, and Artwork Manager (v0.1.9 Build 20261105)

Image
Machine learning & AI
0

2.3K

lokeshsg/lexitag repository overview

⁠LexiTag (v0.1.9 — Build 20261105)

Self-Hosted Music Metadata, Lyrics, and Artwork Manager

LexiTag is a self-hosted music library manager built to clean watermarked tags, organize metadata, fetch lyrics, and manage album artwork using configurable AI providers and a fast SQLite backend.


⁠Quick Start

Deploy LexiTag 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. Open the UI at http://localhost:3030.

⁠Key Features

  • Dynamic Lyrics Header & Watermark Cleaner: Centralized sanitization engine dynamically strips downloader/tool metadata headers ([ti:...], [ar:...], [by:Mornye], [tool:...], [length:...], [id:...], [x-...]), keeping only actual sung lyric lines without hardcoding specific scrapers.
  • Lyrics Junk Detection & Visual Alerts: Indexed lyrics_has_junk tracking with eye-catching ⚠️ Lyrics Junk status badges in library tables, a dedicated Lyrics Junk filter tab, animated ⚠️ Header Junk chips, and 1-click 🧹 Clean Lyrics action in the track inspection dialog.
  • Cleanup Rules Search & Interactive Guide: Real-time keyword/regex search and category filters (All, Junk, Soundtrack, Regex) in Settings with a collapsible educational guide for Promotional Junk, Soundtrack Markers, and Regex syntax.
  • Cleanup Suggestion Deduplication: Automatic root domain extraction and redundancy filtering to prevent proposing duplicate URLs or subpaths when rules already exist.
  • Automated Live Watch & Scheduled Auto-Scan: Background filesystem watcher and auto-scheduler that actively monitors library folders, flags dirty tags on arrival, and triggers real-time UI updates without requiring page reloads.
  • Selective Custom Fix Workflow: Granular modal allowing users to independently configure operations per batch or track: AI vs. local zero-token vs. ignore for metadata, lyrics, language detection, junk purge, and file renaming.
  • LRC Standardization Engine: Strips proprietary base64/JSON header bloat while strictly preserving standard musical sections ([Chorus], [Verse 1], etc.), vocal indicators (v1:, v2:), and <mm:ss.xx> timestamps for clean playback on Jellyfin and Symfonium.
  • Bidirectional Sidecar LRC Synchronization: Automatically detects adjacent .lrc sidecars, updates tags, and mirrors standardized lyrics back to disk files.
  • Adaptive Mobile & Multi-Viewport Responsive UI: Automatically detects browser dimensions and touch capabilities (320px phones, tablets, laptops, and ultra-wide displays) to render touch-friendly track cards, symmetrical action toolbars, 2-column mobile album grids, and responsive modals.
  • Database Maintenance & Old Path Cleanup: Inspect active vs. orphaned library paths, purge stale database entries, and run non-blocking background SQLite VACUUM from the dedicated /settings page.
  • Recently Added Filter & Multi-Sort: 1-click Recently Added filter pill and sorting controls (Recently Added, Recently Scanned, Recently Fixed, A → Z, Release Year) across both the Music Library and Album Art Gallery.
  • 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 Search: Cover art lookup across Apple Music, Deezer, Discogs, Wikipedia, MusicBrainz, and Cover Art Archive with exact album/year matching.
  • Media Server Artwork Synchronization: Synchronizes folder-level images (cover.jpg, folder.jpg) alongside embedded audio tags for Navidrome and Jellyfin compatibility.
  • Tag & Lyrics Enrichment: Cleans titles, artists, albums, genres, release years, and fetches synced or plain lyrics (including regional & soundtrack releases).
  • History & Revert System: Retains manual edits during scans and provides 1-click history restoration across all supported audio formats.
  • Multi-Format Audio Support: Full ID3, Vorbis, MP4 atom, and WAV RIFF tag scanning and writing for MP3, FLAC, M4A, and WAV files.

⁠Deployment Notes

  • Music Path: Point the volume mount to your music directory (/path/to/your/music:/app/music).
  • Database: The SQLite database and settings are stored in ./data (./data:/app/data).
  • Default Port: Web UI listens on port 3030.

Source Repository: https://github.com/lokesh-sg/lexitag⁠

Tag summary

Content type

Image

Digest

sha256:a1ed2c7e2…

Size

321.7 MB

Last updated

15 days ago

docker pull lokeshsg/lexitag