AndroidJetpack/Gramophone/readme.md

# Gramophone
![GitHub](https://img.shields.io/github/license/AkaneTan/Gramophone?style=flat-square&logoColor=white&labelColor=black&color=white)
![GitHub tag (with filter)](https://img.shields.io/github/v/tag/AkaneTan/Gramophone?style=flat-square&logoColor=white&labelColor=black&color=white)
[![Static Badge](https://img.shields.io/badge/Telegram-Content?style=flat-square&logo=telegram&logoColor=black&color=white)](https://t.me/AkaneDev)

A sane music player built with media3 and material design library that is following android's standard strictly.

[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
     alt="Get it on F-Droid"
     height="80">](https://f-droid.org/packages/org.akanework.gramophone/)

## Features
- Up-to-date material 3 design
- Monet themed icon on Android 12+
- Dynamic player UI monet color
- View and play your favorite music
- Search your favourite music
- Web streaming (coming soon!)
- Synced lyrics
- Manage & Add your playlist (coming soon!)

## Screenshots
| ![Screenshot 1](https://raw.githubusercontent.com/AkaneTan/Gramophone/beta/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_1.jpg) | ![Screenshot 2](https://raw.githubusercontent.com/AkaneTan/Gramophone/beta/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_2.jpg) | ![Screenshot 3](https://raw.githubusercontent.com/AkaneTan/Gramophone/beta/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_3.jpg) |
|---------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|
| ![Screenshot 4](https://raw.githubusercontent.com/AkaneTan/Gramophone/beta/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_4.jpg) | ![Screenshot 5](https://raw.githubusercontent.com/AkaneTan/Gramophone/beta/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_5.jpg) | ![Screenshot 6](https://raw.githubusercontent.com/AkaneTan/Gramophone/beta/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_6.jpg) |
| ![Screenshot 7](https://raw.githubusercontent.com/AkaneTan/Gramophone/beta/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_7.jpg) | ![Screenshot 8](https://raw.githubusercontent.com/AkaneTan/Gramophone/beta/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_8.jpg) | ![Screenshot 9](https://raw.githubusercontent.com/AkaneTan/Gramophone/beta/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_9.jpg) |


## Installation
You can download the latest stable version of the app from [GitHub releases](https://github.com/AkaneTan/Gramophone/releases/latest), or from [F-Droid](https://f-droid.org/packages/org.akanework.gramophone/).

Beta versions and sneak peeks are available in the [telegram channel](https://t.me/AkaneDistribution) or [chat](https://t.me/AkaneDev).

## Building
To build this app, you will need the latest beta version of [Android Studio](https://developer.android.com/studio) and a fast network.

### Set up package type
Gramophone has a package type that indicates the source of the application package. Package type string is extracted from an external file named `package.properties`.

Simply open your favorite text editor, type `releaseType=SelfBuilt`, and save it in the root folder of the repository as `package.properties`.

After this, launch Android Studio and import your own signature. You should be able to build Gramophone now.

## License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](https://github.com/AkaneTan/Gramophone/blob/beta/LICENSE) file for details.

## Translation
<a href="https://hosted.weblate.org/engage/gramophone/">
<img src="https://hosted.weblate.org/widget/gramophone/strings-xml/287x66-white.png" alt="Translation status" />
</a>

## Notice
- For bug reporting: [Telegram](https://t.me/AkaneDev)

## Friends
[SongSync](https://github.com/lambada10/songsync)