[v5.0.0-alpha0] Missing properties in UpdateOptions (icon, color, colorized, pitchAlgorithm)

[ItsLhuis]

In v4.1.2, UpdateOptions included several icon-related properties that are missing in v5.0.0-alpha0:

v4.1.2 - Available properties:

TrackPlayer.updateOptions({
  icon: require('./notification-icon.png'),
  playIcon: require('./play-icon.png'),
  pauseIcon: require('./pause-icon.png'),
  stopIcon: require('./stop-icon.png'),
  previousIcon: require('./previous-icon.png'),
  nextIcon: require('./next-icon.png'),
  rewindIcon: require('./rewind-icon.png'),
  forwardIcon: require('./forward-icon.png'),
  compactCapabilities: [Capability.Play, Capability.Pause],
  // ...
});

v5.0.0-alpha0 - Removed properties:

• icon - Custom notification icon
• playIcon - Custom play button icon
• pauseIcon - Custom pause button icon
• stopIcon - Custom stop button icon
• previousIcon - Custom previous button icon
• nextIcon - Custom next button icon
• rewindIcon - Custom jump backward button icon
• forwardIcon - Custom jump forward button icon
• compactCapabilities - Buttons shown in compact notification

Documentation comparison:

• v4.1.2: https://rntp.dev/docs/api/objects/update-options
• v5.0.0-alpha0: https://rntp.dev/docs/next/api/objects/update-options

Questions:

1. Is this removal intentional or an oversight in the alpha?
2. If intentional, what's the migration path for customizing notification icons?
3. The v5 docs still mention "¹ - The custom icons will only work in release builds" but all icon properties are missing - is this note outdated?

Environment:

• RNTP version: 5.0.0-alpha0
• Comparing with: 4.1.2 stable
• Platform: Android

Additional context:
These properties were commonly used for customizing Android notification appearance with custom icons. The removal of compactCapabilities also affects notification layout control. Understanding if they're permanently removed or temporarily unavailable would help with migration planning.

[lovegaoshi]

the new media3 implementation no longer allows these. specifically

since android 13 you are NOT able to change play, pause, next, prev icons

the notif icon now is a android xml resource. please google that and add to the android folder urself

the rewind and forward icons are now purely imolemented via customactions. right now they are not customizable, forking is recommended to customize any of them (thks might be wrong please review musicservice.kt yourself)

[ItsLhuis]

Icon Discrepancy Between Native Media Players and RNTP v5.0.0-alpha0

Description

Following up on the missing properties discussion - I've noticed visual inconsistencies between native media notifications and RNTP v5 notifications on Android.

Native media player (Brave/YouTube):

• Uses system default media icons (Image 1 - Rauw Alejandro track)
• Icons are consistent with Android's standard design

RNTP v5.0.0-alpha0:

• Uses different icon set for previous/next buttons (Image 2 - Longing track)
• Icons don't match native Android media controls styling
• Note: Interestingly, play/pause buttons ARE using native system icons, but previous/next and other control buttons are not

Screenshots:

Native media notification with system default icons

RNTP notification showing different previous/next icons

Control Center showing both notification and quick controls

Issue with Control Center (HyperOS)

On Xiaomi devices running HyperOS, there are two ways to access media controls:

1. Left swipe (Notification panel) - Works correctly

   • Shows full notification with album art
   • Play/Pause, Previous, Next all functional

2. Right swipe (Control Center) - Partially broken

   • Shows media controls with brightness/volume sliders
   • ✅ Play/Pause works
   • ❌ Previous/Next buttons don't respond

Questions

1. Icon customization: Since Media3 removed custom icon support for play/pause/next/prev on Android 13+, is there a way to ensure RNTP uses system default icons instead of custom ones? This would maintain visual consistency with native media players.

2. Control Center integration: Is the Control Center skip button issue a known limitation with Media3, or is there additional configuration needed for RNTP to properly expose these controls to the system?

Environment

• RNTP version: 5.0.0-alpha0
• Device: Xiaomi 13T
• OS: HyperOS 2.0.211.0 (VMFEUXM)
• Android version: 15 (AP3A.240905.015.A2)
• Security patch: 2025-11-01
• Testing comparison: Brave browser (YouTube playback)

Expected Behavior

Media controls should:

1. Use system-consistent icons matching native Android media players
2. Respond to skip actions in both notification panel and Control Center
3. Maintain full functionality across all system-provided media control interfaces

The goal is to achieve visual and functional parity with native Android media controls, especially for the system-wide Control Center integration.

[lovegaoshi]

please skip the chatgpt format, or if you write like this please stopnwriting like chatgpt. yiu could have desceived it in 3 sentences and sceeenshots.

again i dont believe you can change playpause, next and prev button icons anymore since Android 13. so what you observed are specifically to hyperOS and this lib is currently built with pixels and Samsungs. so unless i or whoever else interested magically have a Xiaomi on our hands, this is going to be solely on you bc you have the reproducible device. my recommendation is check media3s default notification with Xiaomis implementation, you can ask in the media3 community or directly to xiaomi.

the notification btn response issue is likely #2559 please check urself if hyperos needs a patch too

[xinyi-cherry]

@ItsLhuis I got the same issue in hyperOS3 and i fixed it by editing the MusicService.kt

[ItsLhuis]

@xinyi-cherry Thanks. I'll try later

[ItsLhuis]

After applying the missing Player.COMMAND_SEEK_TO_NEXT and Player.COMMAND_SEEK_TO_PREVIOUS inside updateOptions, the Control Center on HyperOS immediately starts working as expected and correctly displays the native Android skip/previous buttons. However, this also exposes a clear issue in RNTP: the library continues rendering its own non-native skip/previous icons on top of the system ones, resulting in duplicated controls. This proves the problem is not device-specific or a platform limitation, but an implementation flaw in RNTP where the notification is incorrectly injecting custom transport controls rather than deferring to Media3’s native defaults. The fact that adding two missing commands fixes system-level functionality yet triggers duplicated icons makes it obvious the package is mishandling which actions should be rendered natively and which should be custom. This needs to be corrected in the library’s notification/control logic.

RNTP notification after update — native skip/previous buttons appear correctly after adding the missing commands, but the library still renders its own non-native icons, causing duplicated controls.

[xinyi-cherry]

Oh yes, i met the same situation, follow this pullrequest to modify the source code can remove the extra skip buttons and it works for me
#2517

[ItsLhuis]

Fixed by adding the following code to android/src/main/java/com/doublesymmetry/trackplayer/service/MusicService.kt:

         notificationCapabilities.forEach {
             when (it) {
                 Capability.PLAY, Capability.PAUSE -> {
                     playerCommandsBuilder.add(Player.COMMAND_PLAY_PAUSE)
                 }

                 Capability.STOP -> {
                     playerCommandsBuilder.add(Player.COMMAND_STOP)
                 }

                 Capability.SEEK_TO -> {
                     playerCommandsBuilder.add(Player.COMMAND_SEEK_IN_CURRENT_MEDIA_ITEM)
                 }

+                Capability.SKIP_TO_NEXT -> {
+                    playerCommandsBuilder.add(Player.COMMAND_SEEK_TO_NEXT)
+                }
+
+                Capability.SKIP_TO_PREVIOUS -> {
+                    playerCommandsBuilder.add(Player.COMMAND_SEEK_TO_PREVIOUS)
+                }

                 else -> {}
             }
         }

This makes the Control Center skip buttons work on Xiaomi devices (tested on HyperOS).

To remove the duplicate custom icons from the notification, also add this filter:

         customLayout = CustomCommandButton.entries
             .filter { notificationCapabilities.contains(it.capability) }
+            .filter { it != CustomCommandButton.NEXT && it != CustomCommandButton.PREVIOUS }
             .map { c -> c.commandButton }

[github-actions]

This issue is stale because it has been open 90 days with no activity. Remove stale label or comment or this will be closed in 7 days.

[github-actions]

This issue was closed because it has been stalled for 7 days with no activity.