-
-
Notifications
You must be signed in to change notification settings - Fork 52
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #43 from toasterofbread/readme
Add README and LICENSE
- Loading branch information
Showing
8 changed files
with
737 additions
and
180 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,58 @@ | ||
# SpMp | ||
##### README under construction | ||
A YouTube Music client with a focus on language and metadata customisation, built with Jetpack Compose for Android using Kotlin. | ||
Support for Compose Multiplatform on desktop is [in-progress](https://github.com/toasterofbread/spms). | ||
|
||
## Features | ||
|
||
#### Metadata | ||
- Edit song, artist, and playlist titles | ||
- Set UI and metadata languages separately (ex. display the app's UI in English and show songs and artists in Japanese) | ||
- Option to log into your YouTube Music account for displaying your personal feed, as well as interactions like liking songs and subscribing to artists | ||
|
||
#### QOL | ||
- Undo queue actions (no more accidental swipe removals) | ||
- Store songs locally for offline playback | ||
- Fetch and display lyrics from [PetitLyrics](https://petitlyrics.com/), with timed lyrics support (in-progress) | ||
- Display timed lyrics above the home feed | ||
- Accessibility service for fine volume control, even when screen is off if device is rooted | ||
|
||
#### YouTube parity | ||
- Home feed (with filters support) | ||
- Song radio (with filters support) | ||
- Radio builder | ||
- Like/dislike songs | ||
- Subscribe/unsubscribe from artists | ||
- Display artists and playlists (in-progress) | ||
|
||
#### Other | ||
- UI theme editor | ||
- Option to automatically use a colour from the current song thumbnail as the theme accent colour | ||
- Customisable Discord rich presence (with image support) using [KizzyRPC](https://github.com/dead8309/KizzyRPC) | ||
- Display furigana for Japanese kanji using [Kuromoji](https://github.com/atilika/kuromoji) | ||
|
||
And more | ||
|
||
## Planned features | ||
- Full offline functionality | ||
- Use [UtaTen](https://utaten.com/) as fallback for lyrics | ||
- Playlists | ||
|
||
## About the project | ||
This project was started after I got tired of dealing with YouTube's official music app's lack of language features and customisation. I tried several alternatives, but all had at least a few issues that bugged me. | ||
|
||
So instead of spending a few weeks learning the codebase of an existing project and contributing to it, I decided to spend almost a year (as of writing) creating my own solution. | ||
|
||
## Contributing | ||
Pull requests and feature suggestions (particularly for UI design!) are welcome. This is my first Compose project so there is probably plenty of room for improvement. | ||
|
||
## Thanks to | ||
- [ViMusic](https://github.com/vfsfitvnm/ViMusic): A major inspiration for this project | ||
- [ytmusicapi](https://github.com/sigma67/ytmusicapi/): Used as a reference for the YouTube Music API | ||
- [KeyMapper](https://github.com/keymapperorg/KeyMapper): For screen off volume control implementation | ||
- [ExoVisualizer](https://github.com/dzolnai/ExoVisualizer): Music visualiser implementation | ||
|
||
## Disclaimer | ||
This project and its contents are not affiliated with, funded, authorized, endorsed by, or in any way associated with YouTube, Google LLC 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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...m/spectre7/exovisualiser/ExoVisualiser.kt → ...ctre7/spmp/exovisualiser/ExoVisualiser.kt
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters