Aria

A free, open-source, and extensible music player

---

Features

• Library Management — Organize your collection across songs, artists, albums, and playlists.
• Plugin Architecture — Extend functionality with first-class metadata and playback providers.
• Offline Playback — Listen anywhere, no connection required.
• Theming — Light and dark mode with dynamic accent colors.
• Material 3 — Modern, adaptive UI built on Material You principles.

Download

Get the latest release from the Releases page.

Screenshots

Setup

git clone https://github.com/carlelieser/aria.git
cd aria
npm install
npx expo start

Press w to open in browser, or run a native build:

npm run ios        # Build and run on iOS
npm run android    # Build and run on Android

Build

Cloud (EAS Build)

Requires EAS CLI:

npm install -g eas-cli
eas login

# Development build (with dev client)
eas build --profile development --platform android
eas build --profile development --platform ios

# Production build
eas build --profile production --platform android
eas build --profile production --platform ios

Local

npm run build:android
npm run build:ios

Project Structure

app/                   # Screens & navigation (Expo Router)
src/
├── components/        # UI components (organized by domain)
├── hooks/             # React hooks
├── domain/            # Entities & repository contracts
├── application/       # Services & Zustand stores
├── infrastructure/    # Storage & DI
├── plugins/           # Metadata, playback, sync providers
└── shared/            # Utilities

See CLAUDE.md for architecture details and code standards.

Publishing

See PUBLISHING.md for app store submission guides (F-Droid, etc.).

Contributing

PRs welcome. Use Conventional Commits. See CLAUDE.md.

License

MIT