Skip to content

Latest commit

 

History

History
250 lines (204 loc) · 15 KB

File metadata and controls

250 lines (204 loc) · 15 KB

Music app screen previews

Music 🎶

Android-API Release Pre-release License

A Nothing inspired local music player.

Get it on Google Play Get it on GitHub

The default branch (dev) is the development version of the repository. For the stable version, see the main branch.

Screenshots

Features

  • Supports Android 7+
  • Works with Nothing Music Widget & Glyph Music Visualization
  • Diverse music organization: Albums, Artists, Favorites, Folder Structure, Genres, Playlists
  • Local metadata editor for quick changes (doesn't modify the actual file)
  • Multi-artist support
  • Custom theme & font support
  • Artwork customizability for Albums, Artists, Genres, Playlists, and Tracks
  • Lyrics (BYO - Bring Your Own, Embedded, Providers)
  • Background playback w/ media control notification
  • Queue manipulation (track removal & reordering)
  • Vinyl on "Now Playing" screen acts as a seekbar (24s for a full rotation)
  • Theoretical support of these media formats
  • Community translations
  • [🧪 Experimental] Sleep timer support
  • [🧪 Experimental] Importing/Exporting playlists from/as M3U files
  • [🧪 Experimental] 4 widget variants
  • [🧪 Experimental] Android Auto support
  • [🧪 Experimental] 5-band Equalizer support

Note

This app is designed to work best on "phone" layouts and isn't tested for larger screens (i.e., foldables/tablets). We may improve the layout for larger screens in the future.

Installation

Note

If you install the app via Google Play, you can't update via the APKs from GitHub (and vice versa).

Google Play

Install the app directly from the Play Store.

GitHub (APK)

  1. Go to the Releases page.
  2. Download the latest APK.
  3. Enable "Install unknown apps" if needed.
  4. Install the APK on your device.

Built With

React Native Expo TypeScript Zustand React Query React Native Audio Browser Tailwind CSS Drizzle

Permissions

This (hopefully) lists all permissions required by Music based on those requested in the code and defined in the App Manifest.

Category Permission Constraint Purpose
Storage READ_MEDIA_AUDIO Android 13+ To read & play your music files.
READ_EXTERNAL_STORAGE Before Android 13
WRITE_EXTERNAL_STORAGE Before Android 11 To write files to other directories (ie: backup, M3U).
Services FOREGROUND_SERVICE Enables media playback while the app is in the background.
FOREGROUND_SERVICE_MEDIA_PLAYBACK
WAKE_LOCK
Other ACCESS_NETWORK_STATE Work around for ExoPlayer requiring network permissions.
INTERNET Used to check and notify you if a new update is available. Update checks can be disabled.
POST_NOTIFICATIONS Android 13+ Enables the notification settings in "App Info" screen.

Documentation

See all the available documentation here. Some highlights include:

Translations

Read the Translations documentation for a rundown of how to contribute translations to this app.

The full list of translators can be found here. A huge thanks to the early translators prior to our move to Crowdin:

Translation Translator
日本語 @reindex-ot
Deutsch @The-Ladle
Indonesia @naturbrilian
Español @G4b-0
Français @nin7o
简体中文 @yang1206
Русский @klinoff0
Türkçe @mikropsoft
Català @T-K-Y-M
हिंदी @OxSourabh

Star History 🌟

Star History Chart

Legal

Nothing Technology Limited or any of its affiliates, subsidiaries, or related entities (collectively, "Nothing Technology") is a valid licensee and can use this app for any purpose, including commercial purposes, without compensation to the developers of this app. Nothing Technology is not required to comply with the terms of the GNU Affero General Public License v3.0.

This app is developed by cyanChill and is not affiliated with, funded, authorized, endorsed by, or in any way associated with Nothing Technology or any of its affiliates and subsidiaries. Any trademark, service mark, trade name, or other intellectual property rights used in this project are owned by the respective owners.

Licenses of Used Dependencies

Refer to THIRD_PARTY.md.

License

Copyright (C) 2024 - present, MissingCore

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

See LICENSE for the full license text.

Privacy Policy

Privacy Policy Link