Skip to content

Hamza417/Felicity

Repository files navigation

Felicity

Felicity is the third and final app of the three project I planned for my own learning, the first two are Positional and Inure App Manager.

The development of the app has started and if you've used the first two apps you might wanna join the Telegram Channel and become the part of the whole initial development process.

I am taking my time developing it because I want it to exceed my own expectations and by that I mean the quality of the software. I hope you are patient enough until the first few results :)

The project will be developed under the codename Felicity, the final name maybe updated in the future.

Stats

Release

Features

Custom Audio Engine

  • Dual Decoder utilizing both hardware and software decoding through FFmpeg.
  • Custom DSP: All audio processors are native and custom-built for optimal performance and extensive control over the audio output.
    • Supports bass, treble and more.
    • Native downmixing support to pass multichannel audio to stereo output.
  • Advanced Effects: Integrated spatial effects including stereo widening and tape saturation for an analog feel.
  • 10-band Equalizer: A powerful equalizer with 10 adjustable frequency bands upto +/-15 dB with dedicated PreAmp support.
  • Gapless Playback: Seamless transition between tracks without any gaps or interruptions.
  • High-Resolution Audio Support: Support for high-resolution audio formats such as FLAC, ALAC, and DSD for audiophile-grade sound quality.
  • Multi-Channel Audio Support: Support for multichannel audio formats like 5.1 and 7.1 surround sound for an immersive listening experience.

User Interface

  • Fully custom-built and highly optimized interface inspired by Inure App Manager.
  • Dynamic Theming: The app's theme dynamically adapts to the album art of the currently playing track, creating a visually cohesive and immersive experience.
  • Custom Animations: Smooth and visually appealing animations throughout the app, enhancing the user experience and making interactions more engaging.
  • Themes: Multiple themes including light, dark, AMOLED black, Material You and others.
  • Core: Predictive back, edge to edge and adapted to all modern Android UI features.
  • Embedded Lyrics: Reliable, on-the-fly LRC extraction and support for online downloading from LrcLib.
  • Dual Fast Scroll: Simultaneous support for both slide to scroll and jump to letter fast scroll.
  • Visualizer: Realtime audio visualizer.

Library Management

  • Realtime Library Updates: The app automatically detects and updates the music library in real-time as new tracks are added or removed from the device adapted from Peristyle app.
  • All Storage Support: Full support for both internal and external storages including SD cards and USB drives.
  • Auto Scanning: The app automatically scans for new music files and updates the library without requiring manual refreshes.

Smart Core

  • True Randomized Shuffle: Choose between Miller and Fisher-Yates shuffle algorithms.

This feature is list is not exhaustive and only main features are listed.

Roadmap

  • Initial development and setup
  • Custom audio engine implementation
  • Basic playback controls and UI
  • Library management and scanning
  • Advanced audio effects and equalizer
  • Dynamic theming and custom animations
  • Embedded lyrics support
  • Realtime audio visualizer
  • Milkdrop visualizer support
  • Crossfade support
  • Multiple Player interface styles.
  • Playlist support
  • Cue sheet support
  • Local server for centralized music access across multiple devices.
  • Selection support for library management and playlist creation.

... and more features will be updated here as development progresses.

Screenshots

Last Updated: 16 March 2026

License

Felicity Music Player Copyright © 2026 - Hamza Rizwan

Felicity Music Player is released as open source software under the GNU AGPL v3 license, see the LICENSE file in the project root for the full license text.

About

A feature rich premium Android music player currently in initial development with foundational design from Inure App Manager.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors