Skip to main content

Introduction

React Native Music Library is a powerful library for accessing local music files with full metadata support. Built with React Native's New Architecture (TurboModules) for optimal performance.

✨ Features​

  • 🎵 Rich Metadata - Access local music with full metadata including lyrics
  • 🚀 TurboModules - Built with React Native's New Architecture for maximum performance
  • 📄 Pagination - Efficient handling of large music collections
  • 🔍 Flexible Sorting - Multiple sorting options for tracks, albums, and artists
  • 📁 Directory Filtering - Filter music by specific directories
  • 🔄 TypeScript - Full type definitions and type safety
  • 🎨 Album Artwork - Support for album artwork and cover images
  • 🤖 Android Support - Full native Android implementation
  • 📱 iOS Support - Coming soon

🚀 Quick Start​

Installation​

npm install @nodefinity/react-native-music-library
# or
yarn add @nodefinity/react-native-music-library

Basic Usage​

import { getTracksAsync, getAlbumsAsync, getArtistsAsync } from '@nodefinity/react-native-music-library';

// Get all tracks
const tracks = await getTracksAsync();

// Get albums with sorting
const albums = await getAlbumsAsync({
  sortBy: ['title', true], // Sort by title ascending
  first: 50
});

// Get artists
const artists = await getArtistsAsync();

Android Permissions​

Add to android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

📖 What's Next?​