# Audio Browser > React Native audio for apps that span app screens, lock screens, CarPlay, Android Auto, voice controls, and the web, with one shared playback and browse model. For production apps that span app screens, lock screens, CarPlay, Android Auto, voice controls, and the web — with one shared playback and browse model. ## Table of Contents ### Introduction - [Getting Started](https://audiobrowser.dev/guide/getting-started.md): Install react-native-audio-browser and its react-native-nitro-modules peer dependency, complete the iOS and Android native setup, and add shaka-player if you target the browser. - [Basic Usage](https://audiobrowser.dev/guide/basic-usage.md): The browse tree in one page: browsable versus playable Tracks, setting up the player, declaring content, and playing it. - [Configuration](https://audiobrowser.dev/guide/configuration.md): The whole options surface — setupPlayer, updateOptions, and getOptions — mapped to the feature guide that covers each area in depth. - [Track](https://audiobrowser.dev/guide/track.md): The Track shape — the single unit of content: required fields, identity, metadata, and artwork, used for browse rows, queue items, and lock-screen metadata. - [Hooks](https://audiobrowser.dev/guide/hooks.md): The React hooks that keep your UI in sync with playback, the queue, the browse tree, and the device — including changes driven from outside your app. - [Migrating from react-native-track-player](https://audiobrowser.dev/guide/migrating-from-track-player.md): Porting from react-native-track-player v4: what carries over unchanged, what was renamed or reshaped, and what is new. ### Player - [Artwork](https://audiobrowser.dev/guide/artwork.md): Set Track.artwork once and render it everywhere: the fetch and transform pipeline, per-surface sizing, SF Symbols, tinting, light/dark pairs, Android vector icons, and SVG. - [Errors](https://audiobrowser.dev/guide/errors.md): Playback errors versus navigation errors: how each surfaces, what the automatic retry budget does, and how to show an advisory error while it retries. - [Live Streams](https://audiobrowser.dev/guide/live-streams.md): The map for live audio: stream formats, missing durations, dropped connections, expiring URLs, song titles carried in-band, and Android's periodic position updates. - [Metadata](https://audiobrowser.dev/guide/metadata.md): Read the metadata coming out of the media as it plays: the live ICY or HLS song, the static tags baked into a file, and chapter markers. - [Now Playing](https://audiobrowser.dev/guide/now-playing.md): What the system surfaces show: which metadata field lands where, the four layers that decide its value at any moment, and reading the result back in your own UI. - [Playback](https://audiobrowser.dev/guide/playback.md): Control the active track — play, pause, stop, seek, playback state, progress, rate, and volume — and how playback handles the background, interruptions, and audio focus. - [Queue](https://audiobrowser.dev/guide/queue.md): Build and edit the queue, move between tracks with next and previous, and read it back for an "up next" UI. - [Remote Controls](https://audiobrowser.dev/guide/remote-controls.md): Override what the lock-screen, notification, car, and headset buttons do with handleRemote*, observe presses with the onRemote* events, and resume the last session after the app is killed. ### Browser - [Browser](https://audiobrowser.dev/guide/browser.md): The reference for configureBrowser: every source shape (static, callback, JSON API), routing and path patterns, request transforms, and BrowserConfiguration option. - [Favorites](https://audiobrowser.dev/guide/favorites.md): Let listeners heart the active track from the Android notification, Android Auto, CarPlay, and Siri, and surface a Favorites tab and voice command. - [Gate](https://audiobrowser.dev/guide/gate.md): Block premium, login-only, or region-locked content on CarPlay and Android Auto with a short message — without touching your in-app UI or interrupting playback. - [Search](https://audiobrowser.dev/guide/search.md): Configure the search source that answers both your in-app search UI and the voice search on Siri, CarPlay, and Android Auto. ### Extras - [Audio Output](https://audiobrowser.dev/guide/audio-output.md): Read where audio is currently playing (speaker, Bluetooth, AirPlay, the car), react when the route changes, and open the system output switcher. - [Battery](https://audiobrowser.dev/guide/battery.md): Detect the Android 12+ battery restrictions that block the foreground service the player needs, and prompt the listener to fix their settings. - [Equalizer](https://audiobrowser.dev/guide/equalizer.md): Shape playback tone with the Android system equalizer: named presets, custom band levels, and handling its absence on iOS and web. - [Network](https://audiobrowser.dev/guide/network.md): Track the device's internet connectivity with useOnline, getOnline, and onOnlineChanged, and what "online" means on each platform. - [Sleep Timer](https://audiobrowser.dev/guide/sleep-timer.md): Pause playback after a fixed time or at the end of the current track, counted down natively so it fires with the app backgrounded or the screen off. ### Automotive - [In the car](https://audiobrowser.dev/guide/automotive.md): How CarPlay, Android Auto, and Android Automotive all reuse the browse tree, queue, now-playing metadata, and search source you have already built. - [Android Auto](https://audiobrowser.dev/guide/android-auto.md): Put your browse tree and playback on the Android Auto car screen: the automotive app descriptor, the manifest entries the library merges in, and "Hey Google, play…" voice search. - [CarPlay](https://audiobrowser.dev/guide/carplay.md): CarPlay for audio apps: browse templates generated from your browse tree, the UIScene and headless React Native host setup, and Siri voice search via INPlayMediaIntent. ### Troubleshooting - [Networking in native callbacks (don't use `fetch`)](https://audiobrowser.dev/guide/native-callback-fetch.md): Why React Native's fetch hangs inside the callbacks you pass to configureBrowser, such as browse route callbacks and search sources, when the device is asleep, and what to use instead. - [Android: missing intermediate certificates](https://audiobrowser.dev/guide/android-certificates.md): Why Android playback fails with SSLHandshakeException / "Trust anchor for certification path not found" on HTTPS streams whose server omits its intermediate certificate, and what the AIA toolkit does and does not reach. ### Other - [API Reference](https://audiobrowser.dev/api/modules.md) - [Battery](https://audiobrowser.dev/api/features/battery.md) - [Browser](https://audiobrowser.dev/api/features/browser.md) - [Browser Node Types](https://audiobrowser.dev/api/types/browser-nodes.md) - [Browser Types](https://audiobrowser.dev/api/types/browser.md) - [Car](https://audiobrowser.dev/api/features/carConnection.md) - [Equalizer](https://audiobrowser.dev/api/features/equalizer.md) - [Errors](https://audiobrowser.dev/api/features/errors.md) - [Favorites](https://audiobrowser.dev/api/features/favorites.md) - [Gate](https://audiobrowser.dev/api/features/gate.md) - [getTrackIdentity](https://audiobrowser.dev/api/utils/getTrackIdentity.md) - [LazyNativeEmitter](https://audiobrowser.dev/api/utils/LazyNativeEmitter.md) - [Metadata](https://audiobrowser.dev/api/features/metadata.md) - [NativeUpdatedValue](https://audiobrowser.dev/api/utils/NativeUpdatedValue.md) - [Network](https://audiobrowser.dev/api/features/network.md) - [Now Playing](https://audiobrowser.dev/api/features/nowPlaying.md) - [Output](https://audiobrowser.dev/api/features/output.md) - [Playback](https://audiobrowser.dev/api/features/playback.md) - [Player](https://audiobrowser.dev/api/features/player.md) - [Queue](https://audiobrowser.dev/api/features/queue.md) - [react-native-audio-browser](https://audiobrowser.dev/api.md) - [Remote Controls](https://audiobrowser.dev/api/features/remoteControls.md) - [Sleep Timer](https://audiobrowser.dev/api/features/sleepTimer.md) - [useDebug](https://audiobrowser.dev/api/utils/useDebug.md)