maxrave-dev / maxrave-dev/SimpMusic

Add a music player for the lock screen.

Open
#2,068 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Kotlin
Stars
11.4k
Forks
599
Avg merge
3d 18h
Merged PRs (30d)
7

Description

Problem Description

While standard Android notification/lock screen media controls allow for basic playback manipulation, they do not support advanced features like viewing lyrics. To read lyrics, users must fully unlock their devices. This introduces a security risk in public spaces (like buses or trains), where an unlocked phone is highly vulnerable to theft or snatching. Providing a way to engage deeply with the music directly from a locked state would greatly improve both user security and convenience.

Proposed Solution

Implement a dedicated, optional full-screen lock screen UI for SimpMusic (similar to classic music players or custom lock screen overlays). This view should display large album art, playback controls, and dynamically syncing lyrics—all accessible without requiring the user to unlock the device.

Alternative Solutions

If a full lock screen overlay is not feasible due to Android OS limitations, try instead:

  • Dynamic Media Notification: Enhance the existing media notification to optionally cycle or display the current lyric line within the expanded notification view.
  • Picture-in-Picture (PiP) Lyrics: Implement a PiP window mode specifically for lyrics, allowing users to view them while using other apps or overlaying it securely where applicable.
Additional Context

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by investigating Android lock-screen media controls and the feasibility of full-screen overlays, dynamic notifications, and Picture-in-Picture lyrics. Compare the proposed alternatives against Android security restrictions and existing SimpMusic playback behavior. Done would mean a defined, optional locked-state lyrics experience with album art and playback controls, or a documented implementation boundary.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, kotlin
Domain
mobile
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.