Skip to content
Aswin C edited this page Jul 7, 2026 · 5 revisions

Boxlore // The Ultimate Podcast Client for Android

Boxlore is a modern, open-source podcast client built from the ground up to showcase Jetpack Compose's full styling, reactive capabilities, and interactive potential. The app combines a local-first SQLite architecture with high-performance vector search space (Qdrant) and automated daily curation.


🎨 Design Philosophy & UX

Boxlore strictly adheres to the Material 3 Expressive guidelines to deliver a highly tactile, responsive interface:

  • Tactile Spring Physics: Avoids standard linear animations. Interactive surfaces utilize custom physics-based springs (BouncySpring and QuickSpring) that scale items down on press and bounce back upon release.
  • Dynamic Ambient Glow: Cover art is processed in real-time through the Android Palette API. It extracts visually dominant colors, dynamically boosts saturation (min 40%), bounds lightness (25%–55%), and injects clean ambient gradients behind the player controls and headers.
  • Variable Typography: Integrates variable typefaces like Roboto Flex, utilizing slanted, width, and weight axes dynamically to emphasize status changes and action items.
  • Adaptive Layouts & Shapes: Replaces standard rounded corners with expressive M3 shapes (Sunny, Burst, Puffy, Cookie) that reactively shift size depending on context.

🎧 Feature Matrix

1. The Home Feed & Mixtape Ingestion

  • Dynamic Time Blocks: Adapts content suggestions dynamically depending on when you open the app (Morning briefing, Afternoon study sessions, Evening chill feeds).
  • Mixtape Curation: Custom smart queue that merges recently played shows, new release notifications, and recommended topics.
  • Mosaic Layouts: Staggered grids organize feeds organically rather than using rigid columns, scaling elegantly based on device form factor.

2. Semantic Search & AI Exploration

  • Vector Search Engine: Leverages Qdrant Cloud vector embeddings to perform conceptual searches. You can search by abstract topic ideas (e.g., "unexplained disappearances at sea") rather than exact keyword matches.
  • Featured Results: Top-matching semantic results are highlighted on the Explore tab with a prominent FEATURED RESULT badge.
  • Local Hybrid Indexing: Combines local SQLite FTS5 database indices for instant offline matching with live Podcast Index API fetches for global coverage.

3. Podcasting 2.0 Core Compliance

  • Synchronized Live Transcripts: Displays scrollable, time-synced transcripts for supported episodes. Tapping a transcript line instantly seeks the audio player to that exact word.
  • Seekbar Chapters: Generates clickable, visual notches along the progress bar denoting chapter changes, displaying current chapter titles dynamically.
  • 16:9 Video Podcast Support: Detects video streams and locks orientation-locked video players inline, adapting composition grids dynamically.

4. Smart Library & Downloads

  • Collapsible Downloads Sheet: Grouped downloads categorized by status (Downloading, Paused, Completed).
  • Batch Operations: Multi-select capabilities allowing users to bulk-pause, resume, or delete downloaded episodes with a single tap.
  • Disk Preservation: Background worker that periodically cleans up stale or fully listened cached files.

5. Customization & Backup

  • Region-Specific Feeds: Built-in country/region selector supporting profiles like US, UK/GB, and India/IND. Highlights react dynamically during onboarding and settings.
  • Reactive JSON Backup & Restore: Import and export app subscriptions and preferences. Restoring a JSON file triggers an immediate, reactive UI recreation so settings load instantly without requiring a manual app relaunch.

📊 Telemetry & Optimization

  • Anonymized PostHog Telemetry: Firebase Analytics has been replaced in favor of a clean PostHog migration. It records anonymous playback milestones, onboarding sheets, and user flow metrics to refine recomendation algorithms.
  • No Stale Caching: Edge proxies automatically resolve track redirects (removing nested redirects like Chartable, Podtrac, OP3, etc.) to serve sanitized, playable direct audio URLs to the client.

Clone this wiki locally