# Phonograph Plus

<p align="center">
    <img src= "fastlane/metadata/android/en-US/images/icon.png" alt="ICON" height="120"/>
</p>

[English](./README.md) |
[简体中文](./README_ZH.md)
<br/>

[![Crowdin](https://badges.crowdin.net/phonograph-plus/localized.svg)](https://crowdin.com/project/phonograph-plus)
[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://github.com/chr56/Phonograph_Plus/blob/release/LICENSE.txt)
[<img src="https://github.com/chr56/Phonograph_Plus/actions/workflows/dev.yml/badge.svg" alt="Dev CI Status">](https://github.com/chr56/Phonograph_Plus/actions/workflows/dev.yml)
![DownloadsStatistics](https://img.shields.io/github/downloads/chr56/Phonograph_Plus/total)


**A revived classic material designed music player for Android**

Phonograph is a light-weighted material designed local music player for Android. And Phonograph Plus currently is an _independent_ fork of [Phonograph](https://github.com/kabouzeid/Phonograph) since it is no longer maintained (which has been no longer active after 2020 and has been archived in 2023), and has been in maintenance and development since 2021.

## **Downloads**

[<img src="https://img.shields.io/github/v/release/chr56/phonograph_plus?label=Github%20Releases" alt="Github%20Release">](https://github.com/chr56/Phonograph_Plus/releases/latest)
[<img src="https://img.shields.io/github/v/release/chr56/phonograph_plus?label=Github%20Releases%20(Latest)&include_prereleases" alt="Github%20Release%20(Latest)">](https://github.com/chr56/Phonograph_Plus/releases/)
[<img src="https://img.shields.io/f-droid/v/player.phonograph.plus?label=F-droid" alt="F-droid">](https://f-droid.org/packages/player.phonograph.plus/)

Phonograph Plus is available on GitHub Releases (Stable Channel and Preview Channel[^1]) and F-Droid[^2] (Stable Channel).

[^1]: Package name of Preview version has suffix of `preview`. 

[^2]: Reproducible Builds are enabled on F-droid, Apks from F-droid shall be exactly equivalent to ones from GitHub Releases, byte by byte.


## **Additional Features**

Here is a list of _notable_ changes or enhancements compared with the original Phonograph.

### User Interface

- Automatic dark mode based on system datk mode.

- Unlock pro, supporting all themes.

- <del>Poor</del> support of Monet.

- Brand-new File tab with new design.

- Brand-new App Intro with new design.

- Improve "Library" pages user experience.

... and more user interface changes.

### Improvements

- Change language in application manually.

- Show Time Axis in "Lyrics" Dialog and allow seeking basing lyric's time axis and support lyrics following.

- Support more sort orders.

- Path filter, support "exclude mode" (blacklist) and "include mode" (whitelist).

- Add song menu shortcuts to add new items to excluded-list (blacklist).

- Better Notification Image Quality for Android T and above.

- Improved experience of storage management for Android 11 and above.

- Allow deleting songs file along with its external lyrics file.

- Increase history played tracks and top played tracks entries capacity (100->150).

- Enhance multi-selecting.

- Better Playlist support.

- Improve menu experience, collapse less frequently used options.

- Allow tabs fixed.

### Enhancements

- Playback speed control.

- User-defined click behavior for songs.

- Support history of playing queue.

- Brand-new Detail page with more information like tags.

- Brand-new Tag Editor supporting more tags.

- Support for Android Auto.

- Resume playing after interruptions.

- Allow collecting app crash report.

- Co-work-with/Support [StatusBar Lyric Xposed Module (api)](https://github.com/Block-Network/StatusBarLyric).

- Export internal databases and settings for backups.

...

and more small features/fixes.

It is suggested to browser the [Changelog](https://phonographplus.github.io/changelogs/changeslogs/changelog.html) to
view all changes, improvements and new features completely.

## **Translation**

Translate Phonograph Plus into your language -> [Crowdin](https://crowdin.com/project/phonograph-plus)

We have removed Swedish and Norwegian Nynorsk translations due to missing too many translations

## **Trouble Shooting & FAQ**
See [Trouble Shooting & FAQ](docs/FAQ.md)

## **Screenshot**
See [Gallery](docs/Gallery.md)

## **Build Instructions & Developer Guide**

See [Build_Instructions.md](docs/Build_Instructions.md)

See [Developer Guide](docs/Developer_Guide.md)

## **Development Plan** & **TO-DO list**

See [Road Map](docs/Road_Map.md)

## **Repository Mirrors**

[![GitHub](https://img.shields.io/badge/Git-Github-Blue)](https://github.com/chr56/Phonograph_Plus/)
[![Codeberg](https://img.shields.io/badge/Git-Codeberg-Blue)](https://codeberg.org/PhonographPlus/Phonograph_Plus)
[![BitBucket](https://img.shields.io/badge/Git-BitBucket-Blue)](https://bitbucket.org/phonograph-plus/phonograph_plus/)

**Only** these three sites above are considered as official Git Repositories (mirroring each other), all the other are non-official.