State & Progress

All state getters are synchronous — they return values immediately without await.

Playback state

const state = TrackPlayer.getPlaybackState();

Returns a PlaybackState value:

const playing = TrackPlayer.isPlaying(); // boolean shorthand

const { position, duration, buffered, cached } = TrackPlayer.getProgress();

Field	Description
`position`	Current position in seconds
`duration`	Total duration in seconds
`buffered`	How far ahead is buffered (seconds)
`cached`	How much is locally cached (seconds, 0 if caching disabled)

const speed = TrackPlayer.getPlaybackSpeed(); // number
const volume = TrackPlayer.getVolume();       // 0.0 – 1.0

const mode = TrackPlayer.getRepeatMode();       // RepeatMode
const shuffle = TrackPlayer.isShuffleEnabled(); // boolean

const timer = TrackPlayer.getSleepTimer();

Returns the current sleep timer state, or null if no timer is active.

Type	Fields
`'time'`	`remainingSeconds`, `fadeOutSeconds`
`'mediaItem'`	`index`

if (timer?.type === 'time') {
  console.log(`${Math.ceil(timer.remainingSeconds / 60)} minutes left`);
}

For UI components, prefer the hooks — they subscribe to changes and re-render automatically.

See Hooks for usePlaybackState, useIsPlaying, useProgress, and useActiveMediaItem.