# Lidify - Feature Overview

A self-hosted music streaming platform with intelligent discovery, podcast support, audiobooks, and a unique vibe-matching system.

---

## Music Discovery

**Discover Weekly** - AI-generated weekly playlists based on your listening history. Customize parameters like track duration and date ranges to fine-tune your discoveries.

**Smart Mixes** - Automatically generated playlists including era-based mixes (90s, 2000s), genre mixes, top tracks, rediscover mix (songs you haven't played in a while), and artist similarity mixes.

**Library Radio Stations** - One-click radio modes including Shuffle All, Workout (high energy), Discovery (lesser-played gems), and Favorites (most played). Genre and decade-based radio stations are dynamically created from your library.

**Similar Artists & Recommendations** - Powered by Last.fm integration, discover artists similar to ones you love and get personalized recommendations based on your listening habits.

---

## The Vibe System

**Vibe Button** - The standout feature. While listening to any track, tap the vibe button to see real-time audio analysis including energy, mood (valence), danceability, tempo, and arousal levels displayed on a visual radar chart.

**Keep The Vibe Going** - Uses ML mood predictions (Happy, Sad, Relaxed, Aggressive, Party, Acoustic, Electronic) to queue tracks that match your current vibe with a match percentage score.

**Mood Mixer** - Create custom playlists by adjusting mood sliders or using presets like Happy, Energetic, Chill, Focus, or Workout. The system finds tracks in your library matching your desired vibe.

---

## Playlist Import

**Spotify Import** - Paste any Spotify playlist URL to import. Preview shows which tracks match your library, which albums need downloading, and which tracks have no matches. Selectively download what you need.

**Deezer Import** - Same functionality for Deezer playlists. Browse Deezer's featured and genre playlists directly in-app.

---

## Podcasts

**Full Podcast Support** - Search iTunes for podcasts, subscribe, and manage your library. Browse top podcasts and discover by genre (Comedy, True Crime, News, Business, Sports, etc.).

**Progress Tracking** - Continue listening picks up exactly where you left off across all your subscribed shows.

---

## Audiobooks

**Audiobookshelf Integration** - Connect your Audiobookshelf instance to browse and play your audiobook collection directly in Lidify.

**Smart Organization** - Filter by currently listening or finished books. Group by series with proper sequence ordering. Sort by title, author, or recently played.

**Progress Sync** - Seamless progress tracking so you never lose your place.

---

## Library Management

**Multi-View Library** - Browse by Artists, Albums, or Tracks with flexible sorting and filtering options.

**Smart Filters** - View owned music, discovery tracks (from Discover Weekly), or everything combined.

**Bulk Operations** - Delete artists, albums, or tracks with confirmation. Paginated views for large libraries.

---

## Player

**Adaptive Player** - Full-width desktop player, mini player for mobile, and an immersive overlay mode.

**Universal Playback** - Single unified player handles music, podcasts, and audiobooks with type-specific controls.

**Queue Management** - Full control over what's playing next with shuffle and repeat modes.

---

## Additional Features

- Global search across artists, albums, and tracks
- Featured playlists from Deezer
- Recently added and popular artists sections
- Create and share playlists with other users
- MusicBrainz integration for accurate metadata
- Clean, responsive UI that works on desktop, tablet, and mobile

---

*Lidify is self-hosted, giving you full control over your music library with the discovery features of commercial streaming services.*