Lidify offers a self-hosted, on-demand audio streaming platform designed for music enthusiasts who value library ownership alongside the convenience of modern streaming services. It transforms a personal music collection into a Spotify-like experience, providing features such as automatic metadata enrichment, personalized playlist generation, podcast subscriptions, and seamless integration with complementary self-hosted tools like Lidarr and Audiobookshelf. The platform targets users seeking a centralized, customizable media hub for their digital audio content.

How It Works

Lidify employs a robust architecture featuring a Next.js frontend and an Express.js backend, running within a unified Docker container. It scans and catalogs local music files, enriching them with metadata from MusicBrainz and Last.fm, and supports on-the-fly audio transcoding. A standout feature is "The Vibe System," which analyzes tracks in real-time for energy, mood, groove, and tempo, enabling users to discover and queue similar music within their library. Integrations with Lidarr facilitate music requests and automatic library syncing, while Audiobookshelf integration unifies audiobook playback.

Quick Start & Requirements

• Primary Install: Docker is the primary installation method. A single command is provided:

  docker run -d \
    --name lidify \
    -p 3030:3030 \
    -v /path/to/your/music:/music \
    -v lidify_data:/data \
    chevron7locked/lidify:latest
  

  Docker Compose is also supported with a sample docker-compose.yml.
• Prerequisites: Docker, a local music library accessible via a Docker volume mount (/path/to/your/music:/music).
• Dependencies: None explicitly listed beyond Docker. Environment variables can be set for session secrets, timezone, and integration callbacks.
• Platform Support: Progressive Web App (PWA) for mobile/tablet, with a dedicated, optimized interface for Android TV. Native mobile apps are on the roadmap.

Highlighted Details

• Deep Integrations: Connects with Lidarr for music requests and library sync, Audiobookshelf for audiobooks, and includes direct Soulseek network support for finding rare tracks.
• Advanced Discovery: Features "Made For You" mixes, dynamic genre/decade stations, "Discover Weekly" (requires Lidarr), and "The Vibe System" for mood-based music discovery via audio analysis.
• Playlist Management: Supports importing playlists from Spotify and Deezer, creating custom playlists, and converting auto-generated mixes into permanent collections.
• Multi-User Support: Allows for separate user accounts, each with its own playlists, listening history, and preferences, managed via an admin interface.

Maintenance & Community

Lidify is described as being under active development, with contributions and suggestions welcomed. Specific details regarding notable contributors, sponsorships, or dedicated community channels (like Discord/Slack) are not provided in the README.

Licensing & Compatibility

The project is licensed under the GNU General Public License v3.0 (GPL-3.0). This is a strong copyleft license, meaning derivative works must also be distributed under the GPL-3.0. This may impose restrictions on commercial use or integration into closed-source projects.

Limitations & Caveats

Native mobile applications for iOS and Android are planned but not yet implemented; users currently rely on the PWA for mobile access. External access requires configuration of a reverse proxy with HTTPS and careful management of ALLOWED_ORIGINS. The full feature set is best realized when integrated with other self-hosted services like Lidarr and Audiobookshelf.