Skip to content

CertMusashi/music-player

 
 

Repository files navigation

Phocid

Icon F-Droid Version Official website Works on my machine License

Screenshot Screenshot Screenshot Screenshot Screenshot

A modern offline music player with familiar designs for Android 11+.

This project aims to be a replacement with personal tweaks for the now-defunct Phonograph music player, but has no connections with it.


Changes from Original Phocid

This fork is based on Phocid and includes the following enhancements:

New Features

  • Tag Editing: Edit music file metadata directly in the app (title, artist, album, album artist, genre, year, track number, disc number, comment, and lyrics) with support for MP3, FLAC, OGG, M4A, MP4, WMA, WAV, AIF, AIFF, and DSF formats

  • File Deletion: Delete music files directly from the app with proper Android 11+ permission handling

Performance Improvements

  • Optimized Battery Usage: Replaced busy-wait polling loops with proper coroutine signaling to reduce CPU wake-ups

  • Reduced RAM Consumption: Removed unnecessary large heap allocation and implemented lazy loading for better memory efficiency

  • Improved Responsiveness: Non-blocking operations and optimized scan intervals for smoother user experience

UI/UX Enhancements

  • App Rebranded: Application name changed from "Phocid" to "Music"


Features

  • Familiar user experience

  • Better metadata support; Namely, multiple artists.

  • Better sorting when your music library differs from your system language

  • Regex-based blocklist

  • Playback speed and pitch control

  • More lyrics styles

  • Optional less-vibrant colors

  • Brand new design based on Material Design 3

Missing features that are intentionally left out

  • Anything that requires an internet connection

  • Lock screen

  • Playback statistics

Reporting a crash

A crash report should have been saved to Android/data/org.sunsetware.phocid/files/crash.txt in your external storage. Please create an issue with the report attached.

ℹ️
Depending on your system, you might need to connect your phone to a computer to see this file.
⚠️
This file contains uncensored logs. Although it should not contain sensitive information, you are responsible for checking whether this holds true.

Building

Remember to clone the submodule with git clone --recurse-submodules.

Contributing

Please ask first if you want to work on big code changes. Instead of directly contributing code to Phocid, it would be great if you can help with big upstream issues first, like androidx/media#81. (Please let me know if you have successfully closed those!)

If you would like to help with translations, please use the translation editor and follow the instructions. Alternatively, you can use your preferred translation tool, set it up for Android + ICU MessageFormat 1.0, then submit a pull request. Please don’t submit machine translations or AI hallucinations.

I don’t accept donations.

Credits

Translators

License

Code

Phocid
Copyright (C) tjysunset <tjysunset@outlook.com>

This program is free software: you can redistribute it and/or modify it under the terms of the GNU 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 General Public License for more details.

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

About

A modern offline music player with familiar designs for Android 11+.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Kotlin 100.0%