Your Music, Your Rhythm
Click to expand
Rhythm is not just another music player - it's a complete audio experience designed with passion and attention to detail. Here's what sets us apart:
- ✨ Dynamic Theming - Colors extracted from your wallpaper (Android 12+)
- 🌓 Adaptive UI - Seamless light/dark mode transitions
- 🎭 Physics-based Animations - Smooth, natural motion throughout
- 📐 Responsive Design - Perfect on phones, tablets, and foldables
- 🎨 Custom Color Schemes - Personalize your experience
- 🎧 Media3 ExoPlayer - Studio-quality audio playback
- 🔊 Gapless Playback - Perfect transitions between tracks
- 🎵 AutoEQ Integration - Device-tuned presets for 6032+ devices with import/export
- 🎼 10-Band Equalizer - Professional-grade audio customization
- 📊 Rhythm Stats - Comprehensive playback statistics and insights
- 🔄 Smart Audio Focus - Handles calls and notifications elegantly
- 📻 Volume Control - Independent app volume or system integration
- 🎯 Audio Quality Detection - Dolby, DTS, Lossless, and Hi-Res badges
Rhythm uses Media3 ExoPlayer 1.9.0 for professional-grade audio playback with comprehensive format support. Here's what you can expect:
| Format | Container | Quality | Notes |
|---|---|---|---|
| FLAC | .flac |
Lossless | Full support for all bit depths and sample rates |
| ALAC | .m4a, .alac |
Lossless | Native Apple Lossless support |
| MP3 | .mp3 |
Lossy | All bitrates and VBR support |
| AAC | .m4a, .aac, .mp4 |
Lossy | AAC-LC, HE-AAC, HE-AACv2 |
| Vorbis | .ogg |
Lossy | Ogg Vorbis audio |
| Opus | .opus, .ogg |
Lossy/Lossless | Modern, efficient codec |
| WAV | .wav |
Lossless | Uncompressed PCM audio |
| PCM | Various | Lossless | Raw audio data |
| Format | Container | Notes |
|---|---|---|
| Dolby Digital (AC-3) | .ac3, .m4a |
Requires compatible device/hardware |
| Dolby Digital Plus (E-AC-3) | .eac3, .m4a |
Requires compatible device/hardware |
| DTS | .dts, .m4a |
Requires compatible device/hardware |
| Dolby Atmos | Various | Requires Atmos-compatible device |
| WMA | .wma |
May require device codecs |
| Format | Alternative |
|---|---|
| APE (Monkey's Audio) | Convert to FLAC |
| DSD/DSF | Convert to FLAC or PCM |
| MQA | Use FLAC version |
| WMA Lossless | Convert to FLAC |
| AIFF | Convert to WAV |
Rhythm automatically detects and displays audio quality badges:
- Lossless: FLAC, ALAC, WAV, PCM
- Dolby: AC-3, E-AC-3, Atmos
- DTS: DTS Audio
- Hi-Res: ≥48kHz sample rate or lossless
- Container Detection: Some formats use identical containers (e.g., AAC and ALAC both use .m4a)
- Hardware Dependencies: Dolby/DTS formats require device-specific decoders
- Codec Extensions: Rare formats may need additional libraries (not included by default)
- Bit Depth: Limited to device capabilities (typically 16-bit or 24-bit)
- Sample Rate: Limited to device hardware (typically up to 192kHz)
- For Best Compatibility: Use FLAC, MP3, or AAC formats
- For Lossless Audio: FLAC is universally supported and recommended
- For Hi-Res Audio: Check your device's capabilities first
- Format Conversion: Use tools like FFmpeg or dBpoweramp for unsupported formats
Note: If a format doesn't play, it may be due to device/exoplayer limitations rather than app issues. Try converting to a supported format or check your device's audio capabilities.
- 🎤 Advanced Lyrics - Synchronized lyrics with LRCLib, embedded extraction, word-by-word display, and manual sync adjustment
- 🔍 Smart Search - Lightning-fast fuzzy search across your library with settings search
- 🎲 Advanced Shuffle - True random, artist-aware, and weighted algorithms with persistent settings
- 📋 Enhanced Playlists - Reorder, sort, multi-select, import/export, grid view, and smart playback options
- 💾 Auto-Resume - Picks up exactly where you left off with RAM removal controls
- 📊 Rich Metadata - Beautiful album art and comprehensive tag support with embedded lyrics
- ⚙️ Smart Settings - Default playlists toggle, gesture controls, player customization, and theme management
- 🎨 Theme Engine - Dynamic colors, custom schemes, system fonts, festive themes, and Material You
- 🌍 LRCLib Integration - Community-driven synced lyrics with priority settings
- 🔄 Auto-Updates - Stay up-to-date via GitHub releases with Obtainium support
- 🎨 Spotify Canvas - Dynamic visual experience for your music
- 🖼️ Online Artwork - Fetch high-quality album art from Deezer
- 📱 Telegram Support - Join our active community
- 🌐 Multilingual - Support for multiple languages with ongoing translations
- 🎭 Festive Themes - Diwali, Christmas, and seasonal theme engines
- 🎛️ Modern Design - Android 16 expressive style with rounded corners and vibrant colors
- 📐 9 Responsive Layouts - From compact 2x1 to premium 5x5, perfect fit for every home screen
- ⚡ Real-Time Updates - Glance widgets with instant state synchronization using Glance framework
- 🎨 Material 3 Colors - Dynamic theming with translucent backgrounds and proper contrast
- 🔄 Dual Support - Both legacy RemoteViews and modern Glance implementations
- 📦 Complete Grid Coverage - 2x1, 2x2, 2x3, 3x2, 3x3, 4x2, 4x4, 5x2, 5x5 layouts available
- 📊 Rhythm Stats Widget - Dedicated statistics widget with real-time data
🏠 Smart Home |
|
🎤 Synced Lyrics |
📚 Rich Library |
📋 Smart Queue |
🔍 Instant Search |
⚙️ Deep Settings |
🎤 Artist Pages |
- 📥 Visit our Releases page
- 💾 Download the latest
Rhythm-vX.X.X-release.apkfile - ⚙️ Enable "Install from unknown sources" in your device settings
- 📲 Open the downloaded APK and install
- 🎉 Launch Rhythm and enjoy your music!
Note: The APK is signed with our official keystore for security
- 📱 Install Obtainium from F-Droid or GitHub
- ➕ Add this repository:
https://github.com/cromaguy/Rhythm/ - 🔍 Search for "Rhythm" and install
- 🔄 Enjoy automatic updates from GitHub releases!
Recommended for tech-savvy users who want direct GitHub integration
- 📱 Install F-Droid if you haven't already
- ➕ Add IzzyOnDroid repository:
https://apt.izzysoft.de/fdroid/repo - 🔍 Search for "Rhythm" in F-Droid
- 📥 Install directly from the app
- 🔄 Enjoy automatic updates!
Recommended for privacy-conscious users
After installing Rhythm, you'll go through a comprehensive onboarding process to set up your music experience. Here's what to expect and how to use the app effectively.
Rhythm features a 9-step guided setup to personalize your music experience:
- Introduction to Rhythm's features
- Overview of the setup process
- Click "Get Started" to begin
- Storage Access: Required to scan and play your music files
- Notification Access (Android 13+): For playback controls and updates
- Bluetooth Access: For wireless audio output devices
- Grant permissions to continue with setup
- Choose whether to restore from a previous backup
- Set up automatic backup preferences
- Configure backup frequency and location
- Haptic Feedback: Enable tactile vibrations for interactions
- Default Landing Screen: Choose Home or Library as your starting screen
- System Volume Control: Use device volume buttons for playback
- Queue Behavior: Auto-add to queue, clear queue on new song
- Playback Persistence: Remember repeat and shuffle modes across restarts
- ExoPlayer Shuffle: Choose media player or manual shuffle handling
- Lyrics Display: Enable synchronized lyrics and choose source priority
- Configure audio focus handling and equalizer access
- Select light/dark theme or system default
- Enable Material You dynamic colors (Android 12+)
- Choose accent colors and app appearance
- Set up custom color schemes
- Advanced Tab Management: Reorder Songs, Playlists, Albums, Artists, and Explorer tabs with show/hide controls
- Tab Visibility Control: Show/hide tabs based on your preferences
- Playlist Management: Create, import, export, reorder, sort, multi-select, and grid view playlists
- Explorer Enhancement: Folder-based browsing with playlist creation from folders
- Genre Browsing: Dedicated genre tab with smart categorization
- Configure detailed library settings in Tuner > Theme Customization
- Additional display and sorting options available in app settings
- Scanning Tips: Understanding blacklist vs whitelist filtering modes
- Storage Management: Information about cache management
- Configure detailed filtering in Tuner > Media Scan after setup
- Review scan results and library statistics
- Configure automatic update checking
- Choose update channel (stable/beta)
- Set update notification preferences
- Enable background update downloads
- Review your configuration
- Start initial media scan
- Begin using Rhythm!
Rhythm requests the following permissions for optimal functionality:
| Permission | Why Needed | Where Used |
|---|---|---|
📁 Storage AccessREAD_EXTERNAL_STORAGE (API ≤32)WRITE_EXTERNAL_STORAGE (API ≤29)READ_MEDIA_AUDIOREAD_MEDIA_IMAGESREAD_MEDIA_VISUAL_USER_SELECTED |
Access music files and album artwork on your device | • Media library scanning • Music playback • Album art display • Playlist management • Metadata editing |
🔔 NotificationsPOST_NOTIFICATIONS |
Show playback controls and update notifications | • Media notification controls • Update availability alerts • Background playback status |
📶 Internet AccessINTERNETACCESS_NETWORK_STATE |
Fetch lyrics, artwork, and app updates | • LRCLib lyrics integration • Online album artwork • GitHub update checking • Deezer & YouTube Music APIs |
🎧 Audio SettingsMODIFY_AUDIO_SETTINGS |
Control audio output and routing | • Audio focus management • Bluetooth device switching • Volume control integration • Equalizer support |
📱 BluetoothBLUETOOTHBLUETOOTH_ADMIN (API ≤30)BLUETOOTH_CONNECTBLUETOOTH_SCAN |
Connect to wireless audio devices | • Bluetooth speaker/headphone support • Audio output device selection • Wireless playback controls |
📲 Install PackagesREQUEST_INSTALL_PACKAGES |
Install app updates automatically | • In-app APK installation • Automatic update deployment |
📲 Home Screen WidgetsBIND_APPWIDGETUPDATE_APPWIDGET |
Display and update home screen widgets | • Legacy RemoteViews widgets • Modern Glance widgets • Real-time playback state • Background widget updates |
🎵 Media PlaybackFOREGROUND_SERVICEFOREGROUND_SERVICE_MEDIA_PLAYBACK |
Background music playback | • Continuous music playback • Lock screen controls • Background audio processing |
Privacy Note: Rhythm is fully FOSS-compliant and only uses standard media permissions. We removed
MANAGE_EXTERNAL_STORAGEandACCESS_MEDIA_LOCATIONas they're not needed for music playback. All permissions are used solely for the app's core functionality, and no personal data is ever uploaded.
Android 16 Update: Widget support now includes modern Glance framework with 9 responsive layouts (2x1 to 5x5), real-time state synchronization, and Material 3 design with dynamic theming.
- Launch the App: Open Rhythm from your app drawer
- Grant Permissions: Allow access to your music library
- Wait for Scan: Initial media scan may take a few minutes
- Start Playing: Browse your library and tap any song to play
- 🏠 Home Screen: Quick access to recently played, favorites, and recommendations
▶️ Player: Full-screen player with lyrics, queue, and controls- 📚 Library: Browse by songs, albums, artists, playlists, and folders
- 🔍 Search: Fast fuzzy search across your entire music collection
- 📋 Queue: Manage playback queue and upcoming tracks
- ⚙️ Settings: Customize appearance, audio, and behavior
- Play/Pause: Tap the play button or use notification controls
- Skip Tracks: Use next/previous buttons or swipe gestures
- Shuffle/Repeat: Access from player controls or notification with persistent modes
- Volume: Use device volume buttons or in-app slider with independent control
- Seek: Drag the progress bar or tap lyrics to jump to any position
- Queue Management: Add next, reorder, and manage upcoming tracks
- Sleep Timer: Set automatic playback stop time
- External Player: Switch to other music apps seamlessly
- Add to Playlists: Long-press songs to create or add to playlists with smart dialogs
- Edit Metadata: View and edit song information and album art
- Full file editing support with proper permission handling
- Changes are saved directly to audio files
- Supports batch operations and artwork editing
- Advanced Playlists: Reorder songs, sort by criteria, multi-select removal, grid view
- Genre Browsing: Explore music by genre with smart categorization
- Explorer: Folder-based browsing with playlist creation capabilities
- Import/Export: Full playlist import/export functionality
- Blacklist Folders: Exclude unwanted folders from your library
- Backup/Restore: Protect your playlists and settings
- Themes: Switch between light/dark modes, system default, and custom color schemes
- AutoEQ: Device-tuned audio presets for 6032+ devices with import/export
- Equalizer: Access 10-band professional equalizer for audio adjustments
- Player Customization: Customize progress bars, gestures, and player appearance
- Gestures: Control gesture usage on mini and full player
- Fonts: System fonts with ability to import custom fonts
- Carousel Styles: Reorder home screen sections and customize layouts
- Time & Home Formatting: Customize time display and home screen appearance
- Sleep Timer: Set automatic playback stop time
- Output Selection: Choose audio output device (speaker, Bluetooth, etc.)
- Default Playlists: Toggle visibility of system-generated playlists
- Add Widget: Long-press home screen → Widgets → Rhythm Music
- Resize Widget: Long-press widget → Drag handles to resize (2x1 to 5x5)
- Widget Types:
- Legacy Widget - RemoteViews with 7 sizes (extra small to 5x5)
- Glance Widget - Modern Material 3 with 9 responsive layouts
- Controls: Play/pause, skip next/previous directly from widget
- Real-Time Updates: Widget shows current song, artist, and album art
- Automatic Updates: Background WorkManager ensures fresh data
- Go to Settings → Apps → Rhythm → Permissions to grant manually
- Restart the app after granting permissions
- Check that storage access is enabled for your music folders
- Full Support: Edit metadata directly in audio files with proper permission handling
- What works:
- ✅ Modify song title, artist, album, genre, year, and track number
- ✅ Edit album artwork and embedded images
- ✅ Batch operations for multiple files
- ✅ Changes persist across app restarts and device reboots
- Permission Requirements:
- Requires storage permissions to modify files
- Go to Settings → Apps → Rhythm → Permissions to grant manually
- Restart the app after granting permissions
- Ensure music files are in accessible locations
- Check blacklist/whitelist settings in Settings → Library
- Try rescanning media from Settings → Library → Rescan Media
- Check audio output device selection
- Verify Bluetooth connection if using wireless audio
- Clear app cache if experiencing audio glitches
- Check internet connection for update downloads
- Enable "Install from unknown sources" for APK updates
- Download updates manually from our Releases page
- 📱 In-App Help: Access help from Settings → About → Help
- 💬 Community Support: Join our Telegram group
- 🐛 Report Issues: Use GitHub Issues for bugs
- 📖 Documentation: Check our website for guides
| Category | Technology | Purpose |
|---|---|---|
| 🎨 UI Framework | Jetpack Compose | Modern declarative UI toolkit for Android |
| 🎭 Design System | Material 3 | Latest Material Design components and theming |
| 🎵 Audio Engine | Media3 ExoPlayer 1.9.0 | Professional-grade media playback |
| 📲 Widgets | Glance 1.1.1 | Modern reactive widgets with Material 3 |
| 💻 Language | Kotlin 100% | Modern, safe, and concise programming |
| 🏗️ Architecture | MVVM + Clean | Separation of concerns and testability |
| ⚡ Async | Coroutines & Flow | Reactive and efficient asynchronous programming |
| 🔄 State Management | StateFlow | Reactive UI state management |
| ⏰ Background Work | WorkManager | Reliable background widget updates |
| 🧭 Navigation | Navigation Compose | Type-safe navigation between screens |
| 🖼️ Image Loading | Coil | Efficient image loading and caching |
| 🌐 Networking | Retrofit + OkHttp | Type-safe HTTP client |
| 📦 Serialization | Gson | JSON parsing and serialization |
| 🎨 Color Extraction | Palette | Dynamic color extraction from images |
| 👆 Permissions | Accompanist | Compose utilities for runtime permissions |
| 🔧 Build System | Gradle KTS | Kotlin-based build configuration |
app/
├── 📱 ui/
│ ├── screens/ # Composable screens (Home, Player, Library, etc.)
│ ├── components/ # Reusable UI components
│ ├── navigation/ # Navigation graph and routes
│ └── theme/ # Material 3 theming and colors
├── 🎵 domain/
│ ├── models/ # Data models (Song, Album, Artist, Playlist)
│ ├── repository/ # Repository interfaces
│ └── usecases/ # Business logic use cases
├── 💾 data/
│ ├── local/ # Local data sources (MediaStore, Room)
│ ├── remote/ # Remote data sources (APIs)
│ └── repository/ # Repository implementations
├── 🎼 services/
│ ├── MusicService # Background music playback service
│ └── MediaNotification # Media notification handling
└── 🔧 utils/ # Utility classes and helpers
Key Patterns:
- ✅ MVVM (Model-View-ViewModel) - Clear separation of UI and business logic
- ✅ Repository Pattern - Abstract data sources
- ✅ Use Case Pattern - Encapsulate business logic
- ✅ Dependency Injection - Loose coupling and testability
- ✅ Observer Pattern - Reactive data flow with Flow and StateFlow
- ✅ State Hoisting - Compose best practices for state management
Rhythm is built on the shoulders of giants. We use the following open source libraries:
Click to view all dependencies
| Library | Purpose | License |
|---|---|---|
| Jetpack Compose | Modern UI toolkit for Android | Apache 2.0 |
| Material 3 | Material Design components | Apache 2.0 |
| Media3 ExoPlayer | Media playback library | Apache 2.0 |
| Kotlin Coroutines | Asynchronous programming | Apache 2.0 |
| Kotlin Flow | Reactive streams | Apache 2.0 |
| AndroidX Navigation | Navigation components | Apache 2.0 |
| Coil | Image loading library | Apache 2.0 |
| Retrofit | Type-safe HTTP client | Apache 2.0 |
| OkHttp | HTTP client | Apache 2.0 |
| Gson | JSON serialization | Apache 2.0 |
| Accompanist Permissions | Permission handling | Apache 2.0 |
| AndroidX Palette | Color extraction | Apache 2.0 |
| AndroidX Core KTX | Kotlin extensions | Apache 2.0 |
| AndroidX Lifecycle | Lifecycle management | Apache 2.0 |
| Material Icons Extended | Comprehensive icon set | Apache 2.0 |
This project is licensed under GPL-3.0. Libraries used have their respective open source licenses, which permit use, reproduction, and distribution with proper attribution.
We're grateful to:
- Google - Android platform, Jetpack libraries, Material Design
- JetBrains - Kotlin programming language
- Square - Retrofit and OkHttp libraries
- Coil - Excellent image loading solution
- Open Source Community - For continuous inspiration and support
We believe great software is built by great communities! Here's how you can help make Rhythm even better:
📖 Quick Links:
- 🐛 Report Issues - Found a bug? Open an issue
- 💡 Suggest Features - Have an idea? Create a feature request
- 👨💻 Code Contributions - Ready to contribute code? See our Contributing Guidelines
- 🌍 Translations - Help translate Rhythm to your language
- 💬 Community Support - Help other users in Discussions
- Read our Contributing Guidelines
- Check existing Issues and Pull Requests
- Join our Telegram Community for discussions
 Anjishnu Nandi Lead Developer & Project Architect Core development, UI/UX design, Head of Team ChromaHub |
We're grateful to these amazing individuals who have contributed to making Rhythm better:
- Izzy - Manages updates on IzzyOnDroid
- Christian - Collaboration & Project Booming's Lead Dev
- Alex - Spotify Canvas API Integration
- Google Material Design Team - For the beautiful Material You design system
- Android Open Source Project - For the amazing Android platform
- Jetpack Compose Team - For revolutionizing Android UI development
- Open Source Community - For continuous inspiration, libraries, and support
- All Beta Testers - For invaluable feedback and bug reports
- Our Users - For choosing Rhythm and making it better with your feedback
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
| Resource | Link |
|---|---|
| 🌐 Official Website | rhythmweb.vercel.app |
| 📥 Latest Release | Download APK |
| 🐙 GitHub Repository | cromaguy/Rhythm |
| 📱 IzzyOnDroid | F-Droid Repo |
| 📱 Obtainium | Add Source |
| 📱 OpenAPK | Download |
| 💬 Telegram Support | Join Group |
| 🐛 Issue Tracker | Report Bug |
| 💡 Discussions | Community Forum |
