This is the first stable release of a complete rewrite of react-native-track-player, built from the ground up on the New Architecture.
Important
Starting with V5, react-native-track-player is commercially licensed. Personal and educational use remains free; commercial use requires a paid license — see rntp.dev/pricing. V4 (Apache-2.0) is frozen on the v4 branch and will not receive further updates.
V5 also ships as a new npm package: @rntp/player. The V4 package (react-native-track-player) remains as-is on its last release.
This release supersedes the V5 alpha and beta versions on npm — anyone on those should upgrade to 5.0.0.
Highlights
- TurboModule + JSI — synchronous state getters (
getProgress(),getQueue(),isPlaying()) with no bridge overhead - Media3 on Android — new native core for queueing, caching, and playback control
- Native CarPlay — first-class iOS car dashboard support via
setBrowseTree(), the same call that drives Android Auto - Sleep Timer — native countdown with optional volume fade-out, works reliably in the background
- Progress Sync — server-side progress tracking with a configurable HTTP endpoint and native persistence
- Audio caching — built-in caching layer for offline playback and bandwidth savings
- Preloading — background buffering of upcoming tracks for gapless-like playback
- React hooks —
usePlaybackState,useIsPlaying,useProgress,useActiveMediaItem
Breaking changes
V5 is not backwards-compatible with V4. Both the native layers and the JS API have been rewritten.
There is no automated V4 → V5 migration path. The new API surface is small — most apps can migrate by following the Introduction, Installation, and Quick Start guides.
Package and license changes
- New npm package: V5 ships as
@rntp/player. V4 remains published asreact-native-track-player. - License: V5 is commercially licensed — free for personal and educational use, paid for everything else. See rntp.dev/pricing for plans.
- V4 remains available under Apache-2.0 on the
v4branch, but will not receive further updates.
Requirements
- React Native 0.74 or later
- New Architecture enabled (Fabric + TurboModules)
Install
npm install @rntp/player
# iOS
cd ios && pod install