Skip to content

Commit 15e8998

Browse files
authored
chore: update README.md
1 parent 638793e commit 15e8998

File tree

1 file changed

+100
-120
lines changed

1 file changed

+100
-120
lines changed

README.md

Lines changed: 100 additions & 120 deletions
Original file line numberDiff line numberDiff line change
@@ -1,121 +1,101 @@
1-
2-
<div align="center">
3-
<img src="https://raw.githubusercontent.com/maxrave-dev/SimpMusic/jetpack_compose/fastlane/metadata/android/en-US/images/featureGraphic.png">
4-
<h1>SimpMusic</h1>A FOSS YouTube Music client for Android with many features from<br>Spotify, Musixmatch, SponsorBlock, ReturnYouTubeDislike<br>
5-
<br>
6-
<a href="https://github.com/maxrave-dev/SimpMusic/releases"><img src="https://img.shields.io/github/v/release/maxrave-dev/SimpMusic"></a>
7-
<a href="https://github.com/maxrave-dev/SimpMusic/releases"><img src="https://img.shields.io/github/downloads/maxrave-dev/SimpMusic/total"></a>
8-
<br>
9-
<br>
10-
<a href="https://trendshift.io/repositories/13482" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13482" alt="maxrave-dev%2FSimpMusic | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
11-
<br>
12-
<h4>Download</h4>
13-
<a href="https://apt.izzysoft.de/packages/com.maxrave.simpmusic/"><img src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" height="80"></a>
14-
<a href="https://f-droid.org/en/packages/com.maxrave.simpmusic/"><img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" height="80"></a>
15-
<a href="https://www.openapk.net/simpmusic/com.maxrave.simpmusic/"><img src="https://www.openapk.net/images/openapk-badge.png" height="80"></a>
16-
<a href="https://www.androidfreeware.net/download-simpmusic-apk.html"><img src="https://www.androidfreeware.net/images/androidfreeware-badge.png" height="80"></a>
17-
<a href="https://github.com/maxrave-dev/SimpMusic/releases"><img src="https://raw.githubusercontent.com/NeoApplications/Neo-Backup/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png" height="80"></a>
18-
<a href="https://www.producthunt.com/posts/simpmusic?embed=true&utm_source=badge-featured&utm_medium=badge&utm_souce=badge-simpmusic" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=797736&theme=light&t=1737299913224" alt="SimpMusic - A&#0032;FOSS&#0032;YouTube&#0032;Music&#0032;client&#0032;for&#0032;Android&#0032;with&#0032;many&#0032;features | Product Hunt" style="width: 250px; height: 80px;" width="250" height="80" /></a>
19-
<h4>Nightly Build</h4>
20-
<a href="https://nightly.link/maxrave-dev/SimpMusic/workflows/android/jetpack_compose/app.zip"><img src="https://github.com/maxrave-dev/SimpMusic/actions/workflows/android.yml/badge.svg"></a><br/>
21-
<a href="https://nightly.link/maxrave-dev/SimpMusic/workflows/android/jetpack_compose/app.zip"><img src="https://raw.githubusercontent.com/NeoApplications/Neo-Backup/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png" height="80"></a>
22-
</div>
23-
## Features ✨️
24-
25-
- Play music from YouTube Music or YouTube free without ads in the background
26-
- Browsing Home, Charts, Podcast, Moods & Genre with YouTube Music data at high speed
27-
- Search everything on YouTube
28-
- Analyze your playing data, create custom playlists, and sync with YouTube Music...
29-
- Spotify Canvas supported
30-
- Play 1080p video option with subtitle
31-
- AI suggestions songs
32-
- Notification from followed artists
33-
- Caching and can save data for offline playback
34-
- Synced lyrics from Musixmatch, LRCLIB, Spotify (require login) and YouTube Transcript and translated lyrics (Community translation from Musixmatch)
35-
- Personalize data (*) and multi-YouTube-account support
36-
- Support SponsorBlock, Return YouTube Dislike
37-
- Sleep Timer
38-
- Android Auto with online content
39-
- And many more!
40-
41-
> (*) For users who chose "Send back to Google" feature
42-
43-
> **Warning**
44-
45-
>This app is in the beta stage, so it may have many bugs and make it crash. If you find any bugs,
46-
> please create an issue or contact me via email or discord sever.
47-
48-
## Screenshots
49-
50-
<p align="center">
51-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/2.png?raw=true" width="200" />
52-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/3.png?raw=true" width="200" />
53-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/4.png?raw=true" width="200" />
54-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/5.png?raw=true" width="200" /> </p> <p align="center">
55-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/6.png?raw=true" width="200" />
56-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/7.png?raw=true" width="200" />
57-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/8.png?raw=true" width="200" />
58-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/9.png?raw=true" width="200" /> </p> <p align="center">
59-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/10.png?raw=true" width="200" />
60-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/11.png?raw=true" width="200" />
61-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/12.png?raw=true" width="200" /> </p>
1+
<div align="center">
2+
<img src="https://raw.githubusercontent.com/maxrave-dev/SimpMusic/jetpack_compose/fastlane/metadata/android/en-US/images/featureGraphic.png"> <h1>SimpMusic</h1>A FOSS YouTube Music client for Android with many features from<br>Spotify, Musixmatch, SponsorBlock, ReturnYouTubeDislike<br> <br> <a href="https://github.com/maxrave-dev/SimpMusic/releases"><img src="https://img.shields.io/github/v/release/maxrave-dev/SimpMusic"></a> <a href="https://github.com/maxrave-dev/SimpMusic/releases"><img src="https://img.shields.io/github/downloads/maxrave-dev/SimpMusic/total"></a> <br> <br> <a href="https://trendshift.io/repositories/13482" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13482" alt="maxrave-dev%2FSimpMusic | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> <br> <h4>Download</h4> <a href="https://apt.izzysoft.de/packages/com.maxrave.simpmusic/"><img src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" height="80"></a> <a href="https://f-droid.org/en/packages/com.maxrave.simpmusic/"><img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" height="80"></a> <a href="https://www.openapk.net/simpmusic/com.maxrave.simpmusic/"><img src="https://www.openapk.net/images/openapk-badge.png" height="80"></a> <a href="https://www.androidfreeware.net/download-simpmusic-apk.html"><img src="https://www.androidfreeware.net/images/androidfreeware-badge.png" height="80"></a> <a href="https://github.com/maxrave-dev/SimpMusic/releases"><img src="https://raw.githubusercontent.com/NeoApplications/Neo-Backup/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png" height="80"></a> <a href="https://www.producthunt.com/posts/simpmusic?embed=true&utm_source=badge-featured&utm_medium=badge&utm_souce=badge-simpmusic" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=797736&theme=light&t=1737299913224" alt="SimpMusic - A&#0032;FOSS&#0032;YouTube&#0032;Music&#0032;client&#0032;for&#0032;Android&#0032;with&#0032;many&#0032;features | Product Hunt" style="width: 250px; height: 80px;" width="250" height="80" /></a> <h4>Nightly Build</h4> <a href="https://nightly.link/maxrave-dev/SimpMusic/workflows/android/jetpack_compose/app.zip"><img src="https://github.com/maxrave-dev/SimpMusic/actions/workflows/android.yml/badge.svg"></a><br/> <a href="https://nightly.link/maxrave-dev/SimpMusic/workflows/android/jetpack_compose/app.zip"><img src="https://raw.githubusercontent.com/NeoApplications/Neo-Backup/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png" height="80"></a> </div>
3+
4+
## Features ✨️
5+
6+
- Play music from YouTube Music or YouTube free without ads in the background
7+
- Browsing Home, Charts, Podcast, Moods & Genre with YouTube Music data at high speed
8+
- Search everything on YouTube
9+
- Analyze your playing data, create custom playlists, and sync with YouTube Music...
10+
- Spotify Canvas supported
11+
- Play 1080p video option with subtitle
12+
- AI suggestions songs
13+
- Notification from followed artists
14+
- Caching and can save data for offline playback
15+
- Synced lyrics from Musixmatch, LRCLIB, Spotify (require login) and YouTube Transcript and translated lyrics (Community translation from Musixmatch)
16+
- Personalize data (\*) and multi-YouTube-account support
17+
- Support SponsorBlock, Return YouTube Dislike
18+
- Sleep Timer
19+
- Android Auto with online content
20+
- And many more!
21+
22+
> (\*) For users who chose "Send back to Google" feature
23+
24+
> **Warning**
25+
26+
> This app is in the beta stage, so it may have many bugs and make it crash. If you find any bugs,
27+
> please create an issue or contact me via email or discord sever.
28+
29+
## Screenshots
30+
31+
<p align="center">
32+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/2.png?raw=true" width="200" />
33+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/3.png?raw=true" width="200" />
34+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/4.png?raw=true" width="200" />
35+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/5.png?raw=true" width="200" /> </p> <p align="center">
36+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/6.png?raw=true" width="200" />
37+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/7.png?raw=true" width="200" />
38+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/8.png?raw=true" width="200" />
39+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/9.png?raw=true" width="200" /> </p> <p align="center">
40+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/10.png?raw=true" width="200" />
41+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/11.png?raw=true" width="200" />
42+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/jetpack_compose/asset/screenshot/12.png?raw=true" width="200" /> </p>
43+
6244
#### More [screenshot](https://photos.app.goo.gl/AbieoXG5ctDrpwzp7) here.
63-
64-
## Data
65-
66-
- This app uses hidden API from YouTube Music with some tricks to get data from YouTube Music.
67-
- Use Spotify Web API and some tricks to get Spotify Canvas and Lyrics
68-
- Thanks to [InnerTune](https://github.com/z-huang/InnerTune/) for the idea to get data from YouTube Music. This repo is my inspiration to create this app.
69-
- Special thanks to [SmartTube](https://github.com/yuliskov/SmartTube). This repo help me to extract the streaming URL of YouTube Music.
70-
- My app is using [SponsorBlock](https://sponsor.ajay.app/) to skip sponsor in YouTube videos.
71-
- ReturnYouTubeDislike for getting information on votes
72-
- Lyrics data from Musixmatch and LRCLIB. More information [Musixmatch](https://developer.musixmatch.com/), [LRCLIB](https://lrclib.net/)
73-
74-
## Privacy
75-
76-
SimpMusic doesn't have any tracker or third-party server for collecting user data. If YouTube
77-
logged-in users enable "Send back to Google" feature, SimpMusic only uses YouTube Music Tracking API
78-
to send listening history and listening record of video to Google for better recommendations and
79-
supporting artist or YouTube Creator (For API reference,
80-
see [this](https://github.com/maxrave-dev/SimpMusic/blob/13f7ab6e5fa521b62a9fd31a1cefdc2787a1a8af/kotlinYtmusicScraper/src/main/java/com/maxrave/kotlinytmusicscraper/Ytmusic.kt#L639C4-L666C1)).
81-
82-
## Translation
83-
84-
[![Crowdin](https://badges.crowdin.net/simpmusic/localized.svg)](https://crowdin.com/project/simpmusic) You can help me translate this app into your language by using Crowdin [SimpMusic on Crowdin](https://crowdin.com/project/simpmusic)
85-
Special thanks to all translators on Crowdin.
86-
87-
## FAQ
88-
89-
#### 1. Wrong Lyrics?
90-
91-
YouTube Music is not an official partner of Musixmatch so you can't get lyrics directly if using YouTube"
92-
videoId" parameter. So I need to use some "String Matcher" and "Duration" for search lyrics. So
93-
sometimes, some songs or videos get the wrong lyric's
94-
95-
#### 2. Why the name or brand is "SimpMusic"?
96-
97-
Simply, because I love this name. It's a combination of Simple and Music. But SimpMusic is not a simple app, it's all you need for a powerful music streaming app.
98-
99-
## Developer/Team
100-
101-
### [maxrave-dev](https://github.com/maxrave-dev/SimpMusic): Founder/Developer/Designer
102-
### [Owen Connor](https://github.com/owencz1998): Discord Server Admin.
103-
### [Ilian Delagrange](https://github.com/ilianoKokoro): Discord Server Admin.
104-
105-
## Support & Donations
106-
<div align="left">
107-
<a href="https://simpmusic.org/"><img alt="Visit the website" height="50" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/documentation/website_vector.svg"></a>
108-
&nbsp;
109-
<a href="https://discord.gg/Rq5tWVM9Hg"><img alt="Discord Server" height="50" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/social/discord-plural_vector.svg"></a>
110-
&nbsp;
111-
<br>
112-
<a href="https://www.buymeacoffee.com/maxrave"><img alt="Buy me a Coffee" height="50" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/donate/buymeacoffee-singular_vector.svg"></a>
113-
&nbsp;
114-
<a href="https://liberapay.com/maxrave/"><img alt="liberapay" height="50"
115-
src="https://raw.githubusercontent.com/liberapay/liberapay.com/master/www/assets/liberapay/logo-v2_black-on-yellow.svg"></a>
116-
</div>
117-
118-
### MOMO or Vietnamese banking
119-
<p float="left">
120-
<img src="https://github.com/maxrave-dev/SimpMusic/blob/dev/asset/52770992.jpg?raw=true" width="300">
121-
</p>
45+
46+
## Data
47+
48+
- This app uses hidden API from YouTube Music with some tricks to get data from YouTube Music.
49+
- Use Spotify Web API and some tricks to get Spotify Canvas and Lyrics
50+
- Thanks to [InnerTune](https://github.com/z-huang/InnerTune/) for the idea to get data from YouTube Music. This repo is my inspiration to create this app.
51+
- Special thanks to [SmartTube](https://github.com/yuliskov/SmartTube). This repo help me to extract the streaming URL of YouTube Music.
52+
- My app is using [SponsorBlock](https://sponsor.ajay.app/) to skip sponsor in YouTube videos.
53+
- ReturnYouTubeDislike for getting information on votes
54+
- Lyrics data from Musixmatch and LRCLIB. More information [Musixmatch](https://developer.musixmatch.com/), [LRCLIB](https://lrclib.net/)
55+
56+
## Privacy
57+
58+
SimpMusic doesn't have any tracker or third-party server for collecting user data. If YouTube
59+
logged-in users enable "Send back to Google" feature, SimpMusic only uses YouTube Music Tracking API to send listening history and listening record of video to Google for better recommendations and
60+
supporting artist or YouTube Creator (For API reference,
61+
see [this](https://github.com/maxrave-dev/SimpMusic/blob/13f7ab6e5fa521b62a9fd31a1cefdc2787a1a8af/kotlinYtmusicScraper/src/main/java/com/maxrave/kotlinytmusicscraper/Ytmusic.kt#L639C4-L666C1)).
62+
63+
## Translation
64+
65+
[![Crowdin](https://badges.crowdin.net/simpmusic/localized.svg)](https://crowdin.com/project/simpmusic) You can help me translate this app into your language by using Crowdin [SimpMusic on Crowdin](https://crowdin.com/project/simpmusic)
66+
67+
#### Special thanks to all translators on Crowdin ❤️
68+
69+
## FAQ
70+
71+
#### 1. Wrong Lyrics?
72+
73+
YouTube Music is not an official partner of Musixmatch so you can't get lyrics directly if using YouTube"
74+
videoId" parameter. So I need to use some "String Matcher" and "Duration" for search lyrics. So
75+
sometimes, some songs or videos get the wrong lyric's
76+
77+
#### 2. Why the name or brand is "SimpMusic"?
78+
79+
Simply, because I love this name. It's a combination of Simple and Music. But SimpMusic is not a simple app, it's all you need for a powerful music streaming app.
80+
81+
## Developer/Team
82+
83+
### [maxrave-dev](https://github.com/maxrave-dev/SimpMusic): Founder/Developer/Designer
84+
85+
### [Owen Connor](https://github.com/owencz1998): Discord Server Admin.
86+
87+
### [Ilian Delagrange](https://github.com/ilianoKokoro): Discord Server Admin.
88+
89+
## Support & Donations
90+
#### Special thanks to all supporter ❤️
91+
92+
<div align="left"> <a href="https://simpmusic.org/"><img alt="Visit the website" height="50" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/documentation/website_vector.svg"></a> &nbsp;
93+
<a href="https://discord.gg/Rq5tWVM9Hg"><img alt="Discord Server" height="50" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/social/discord-plural_vector.svg"></a> &nbsp;
94+
<br> <a href="https://www.buymeacoffee.com/maxrave"><img alt="Buy me a Coffee" height="50" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/donate/buymeacoffee-singular_vector.svg"></a> &nbsp;
95+
<a href="https://liberapay.com/maxrave/"><img alt="liberapay" height="50"
96+
src="https://raw.githubusercontent.com/liberapay/liberapay.com/master/www/assets/liberapay/logo-v2_black-on-yellow.svg"></a> </div>
97+
98+
### MOMO or Vietnamese banking
99+
100+
<p float="left">
101+
<img src="https://github.com/maxrave-dev/SimpMusic/blob/dev/asset/52770992.jpg?raw=true" width="300"> </p>

0 commit comments

Comments
 (0)