Skip to content

HyperMusicCover-Enhanced v1.0.0 — Our largest update yet

Choose a tag to compare

@Lewewe Lewewe released this 11 Oct 03:42
· 162 commits to main since this release

HyperMusicCover-Enhanced 1.0.0 — our largest update yet

The largest update to this fork so far, led by two major additions: HyperCanvas brings Spotify Canvas to the lock screen, and real audio-reactive visualizers let the Super Island and media players follow actual playback audio. Player customization, built-in extension management and wallpaper background mode complete the update.

Changes since v0.3.5. Download the 1.0.0 release APK. Existing NextLyrics, lyric search/effects, dictionaries, kaomojis and notification-sink features were already part of 0.3.5.

New features

HyperCanvas — optional Spotify Canvas extension

  • A separate LSPosed APK hooks Spotify and SystemUI, controlled from HMC-Enhanced. HyperCanvas only works with HyperMusicCover-Enhanced, with a matching signing certificate.
  • Use available Spotify Canvas videos as lock-screen backgrounds. Tracks without available Canvas keep the normal artwork background.
  • When Canvas becomes ready, fold big artwork into the media player. Manually reopening big cover art or lyrics smoothly blurs and dims the video.
  • Move the Canvas lyrics toggle beside the playback controls, using a filled icon while lyrics are visible. Users can hide/show lyrics without folding the player into the pill.
  • Default Canvas dimming is 35%, with adjustable dimming and additional blur/dimming behind big artwork or lyrics.
  • Pause with music, blur/pause on the password screen, and freeze/blur on AOD. Keep video and snapshots outside native keyguard scaling.
  • Choose whether Canvas stays visible in pill mode; otherwise hide and pause it. Restore the user’s cover/lyrics/compact-player scene when reopening the pill.
  • Keep the clock above the content with coordinated artwork colors and stable size/position across Canvas, lyrics, cover, seeking and AOD transitions.
  • Keep at most three cached videos around the current track when Spotify supplies the relevant data; clear them when HyperCanvas is disabled.
  • Bound download attempts and discard stale host/surface replies to avoid late results replacing the current scene.
  • Choose the default opaque TextureView renderer or experimental OpenGL ES rendering with aspect-aware cropping, GPU Gaussian blur, surface recovery and a TextureView fallback.

Canvas availability and loading speed depend on Spotify and the network. Opening Spotify’s Now Playing screen may be necessary before Canvas data is available; predictive loading is not guaranteed.

Real audio-reactive visualizers — beta

  • Replace the decorative wave around the camera with five frequency bands from actual playback audio.
  • Independently replace the output-device button with a visualizer on the lock screen, notification panel and expanded Super Island, retaining its native click action.
  • Share privileged media-only PCM capture with BPM analysis; fall back to Android’s output-mix Visualizer when needed. Internal capture can continue at zero media volume without microphone input or changes to playback routing.
  • Use a windowed FFT, DC removal, balanced frequency bands, restrained gain and time-based normalization, with equal bar widths and native artwork-color gradients.
  • Add Bluetooth synchronization using Android’s estimated routed output latency and an optional manual timing offset. This is an estimate, not an acoustic measurement of the headphones.
  • Reduce lock-screen rendering to 5 FPS on AOD; stop unnecessary capture and bound buffered frames.
  • Add an outlined Beta badge and an option to hide the headphone/audio-device icon so it does not cover the Super Island wave.
  • Recover interrupted capture and stale native playback state when tracks advance automatically.

Media player customization

  • Separate appearance profiles for the notification/lock-screen player and expanded Super Island player, adapted from HyperLyrics-Enhanced.
  • Default, circular, rotating circular and hidden artwork styles; optional hiding of cover-source and output-device icons.
  • Cover collage, blurred cover, radial gradient, linear gradient and soft-cover backgrounds, including soft-cover tone adjustment.
  • System, light and dark themes; background motion modes, pause behavior, animated background changes, blur strength and bright-cover color inversion.
  • Animated transitions between big artwork and circular player artwork.
  • Native materials, corners, foreground colors and AOD layout are preserved or restored when customization is disabled.
  • Audio visualization and appearance settings now have separate tabs, with Audio visualization on the left.
  • Add Scrolling song information as its own section in Appearance, with independent notification/lock-screen and expanded-island switches. Long song titles and artist names use native Android marquee; short labels remain static. Scrolling pauses on AOD or while the label is hidden, and disabling it restores the native presentation. It defaults to off and applies immediately. This implements the request in issue #11.

Built-in extension management

  • Add an Extensions tab between Features and Settings, with an app-style HyperCanvas entry and animated navigation into its settings.
  • Fetch published HyperCanvas releases from GitHub, including beta releases, and download/install their APKs without manually finding a file.
  • Validate the downloaded package and signing certificate before installation.
  • Show compact Download, Update and Installed pills; prevent redundant downloads and enable the settings page after installation.
  • Read the installed extension’s own app icon and refresh it after package updates.
  • Show an outlined Spotify-hook badge beside the settings header: green when connected, red when not connected.
  • Remove HyperCanvas through root, then restart Spotify/SystemUI after successful removal. Keep its catalogue entry available for reinstallation.

The current catalogue contains HyperCanvas; automatic discovery of arbitrary third-party extensions is not included.

Wallpaper background mode

  • Add Use wallpaper background under Lock screen music cover → Cover & clock.
  • Replace the artwork-blur background with the user’s wallpaper and an adjustable dark overlay behind big cover art or visible lyrics.
  • Remove the overlay for a compact player with no lyrics, restoring the clock’s native placement and wallpaper-based status-bar behavior.
  • Keep white status icons while wallpaper-backed big cover art or lyrics are visible; preserve normal adaptive behavior when this mode is off.
  • Keep the dark overlay full-screen outside AOD scaling.
  • Temporarily suspend HyperCanvas and disable its switch while wallpaper mode is enabled; restart its scopes only when the extension is installed.

Appearance and fixes

  • New app icon with a translucent white foreground and a brighter gradient background; matching About-page styling.
  • Remove the old splash artwork so the obsolete icon no longer appears at launch.
  • Restore native artwork rounding when switching from Circle to Default on lock-screen and notification players.
  • Prevent output-device buttons from flashing over visualizers in all three player locations.
  • Remove the progress/background fragment left visible by customized players on AOD.
  • Correct Canvas lyrics-toggle state, big-cover visibility and restoration from pill mode.
  • Prevent seeking within a Canvas track from causing unnecessary blur, clock movement or disappearing lyric controls.
  • Restore static artwork backgrounds when leaving Canvas, including previous-track navigation; accept fresh/late artwork instead of assigning an old bitmap to the new track.
  • Remove the extra artwork-blur layer behind Canvas on AOD.
  • Fix Canvas snapshot aspect ratio, horizontal compression and zoom flashes on AOD entry/wake.
  • Use white status-bar icons while Canvas is visible, refreshing their appearance when the background changes.
  • Update English/Chinese settings text for the new controls and point puhboo’s credit to his GitHub profile.

Project updates

  • Refresh the README, installation instructions and repository overview, retaining the official Telegram link.
  • Add the GitHub Sponsor button linking to Afdian.
  • Set the default application version to 1.0.0, with version code 10000000. Build-property overrides remain supported.
  • Retain attribution for juren233’s media-player foundation and puhboo’s lyrics and HyperCanvas renderer contributions.

Testing has primarily used Xiaomi 17 Pro running HyperOS 4. Audio capture, Bluetooth latency estimates, hooked SystemUI layouts and Spotify Canvas availability can vary across devices and software versions. The visualizer and HyperCanvas remain experimental.

Installation and credits

  • Requires a rooted HyperOS 4 device, Android 15 or newer and LSPosed with modern Xposed API support. The release APK targets arm64 devices.
  • Existing Enhanced installations keep the same package and signing certificate; install this APK over the previous version, then restart the affected scopes or reboot.
  • For Spotify Canvas, use Extensions → HyperCanvas → Download, approve Spotify/SystemUI scopes in LSPosed and restart the affected processes. HyperCanvas is a separate APK that only works with HMC-Enhanced.
  • Thanks to puhboo for lyrics and HyperCanvas renderer contributions, juren233 for the player styling foundation, and zyl6932 for the original project.
  • Official Telegram: https://t.me/HyperMusicCoverEnhanced

Validation: release APK built and installed on Xiaomi 17 Pro; 397 existing unit tests passed. Scrolling song information was confirmed working on the device.

Updated 1.0.0 APK

  • Check HyperCanvas activation in the background and confirm setup through SystemUI without opening Spotify.
  • Open LSPosed through its supported manager entry point instead of Android’s bug-report dialog.
  • Show available versions, improve update controls and allow retrying installation from the Downloaded button.
  • Restore Download when the cached APK is removed.
  • Refine the HyperCanvas title, version spacing and Beta badge.

SHA256 (HyperMusicCover-Enhanced-1.0.0.apk):

32df4c221202fe2df98bcbbaf1953c2ca8acfb23fbe0091c5d2d3cbfe96e3663