Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/tjysunset/phocid

A modern offline music player with familiar designs for Android 11+.
https://github.com/tjysunset/phocid

android-application music-player

Last synced: 19 days ago
JSON representation

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

Awesome Lists containing this project

README 

        
= Phocid

:toc: preamble



image:metadata/en-US/images/icon.png[Icon,64px]

image:https://img.shields.io/f-droid/v/org.sunsetware.phocid[F-Droid Version,link=https://f-droid.org/en/packages/org.sunsetware.phocid/]

image:https://img.shields.io/badge/official-website-blue[Official website,link=https://sunsetware.org/phocid]

image:https://img.shields.io/badge/works_on-my_machine-yellow[Works on my machine]

image:https://img.shields.io/github/license/tjysunset/phocid[License]



image:metadata/en-US/images/phoneScreenshots/00-screenshot-home-tracks.png[Screenshot,15%]

image:metadata/en-US/images/phoneScreenshots/01-screenshot-home-albums.png[Screenshot,15%]

image:metadata/en-US/images/phoneScreenshots/02-screenshot-home-folders.png[Screenshot,15%]

image:metadata/en-US/images/phoneScreenshots/03-screenshot-search.png[Screenshot,15%]

image:metadata/en-US/images/phoneScreenshots/04-screenshot-player.png[Screenshot,15%]



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 https://github.com/kabouzeid/Phonograph[Phonograph] music player, but has no connections with it.



Phocid is not officially available on Google Play or other app stores except https://f-droid.org/en/packages/org.sunsetware.phocid/[F-Droid]. I don't provide support for unauthorized repackaged versions, and you should report repackagers who violate GPL.



== 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 compared to Phonograph



=== Features that are intentionally left out



* Tag editing

+

The scene of audio file tagging is a disaster.

The best metadata support library I could find is still buggy; I recommend using well-known dedicated software for this task.

* Deleting files

* Anything that requires an internet connection

* Lock screen



=== Features that might be added



These features are hard to implement and/or of no personal interest.

If you want to see a feature, please https://github.com/TJYSunset/Phocid/issues[file an issue].



* Playback statistics

* Widgets

* Notification customization



== Known issues



* Expect hangs or crashes when having a large number of tracks queued.

This is an upstream issue at https://github.com/androidx/media/issues/81.

* Phocid consumes more system resources than other players, and the UI occasionally stutters.



== Troubleshooting common problems



First of all, please try https://github.com/tjysunset/phocid/releases/latest[the latest release] from GitHub.

F-Droid updates can lag behind for as long as 7 days.

GitHub and F-Droid builds have the same signature, which means you don't have to uninstall when switching download source.



=== Playback is misbehaving



Disable "Audio offloading" in preferences.



=== Metadata are incorrect / embedded lyrics not showing



Enable "Advanced metadata extraction" in preferences.



=== Unwanted files are listed



See "Indexing help" in preferences.

Apparently a lot of people miss that button.



== Reporting a crash



A crash report should have been saved to `Android/data/org.sunsetware.phocid/files/crash.txt` in your external storage.

Please https://github.com/TJYSunset/Phocid/issues[create an issue] with the report attached.



NOTE: Depending on your system, you might need to connect your phone to a computer to see this file.



WARNING: 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 https://bitbucket.org/ijabz/jaudiotagger/issues/65/add-support-for-ogg-opus-format or https://github.com/androidx/media/issues/81. (Please let me know if you have successfully closed those!)



If you would like to help with translations, see https://github.com/TJYSunset/Phocid/issues/1[issue #1].

Please don't submit machine translations or AI hallucinations.



I don't accept donations.



== License



=== App icon artwork



....

This work by tjysunset is licensed under CC BY-SA 4.0. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/

....



=== Code



....

Phocid

Copyright (C) tjysunset 



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 .

....