ViMusic/README.md

55 lines
2.6 KiB
Markdown
Raw Normal View History

2022-06-03 11:05:33 +00:00
<div align="center">
<img src="./app/src/main/ic_launcher-playstore.png" width="128" height="128" style="display: block; margin: 0 auto"/>
<h1>ViMusic</h1>
<p>A Jetpack Compose Android application for streaming music from YouTube Music</p>
2022-06-02 16:59:18 +00:00
2022-06-03 11:05:33 +00:00
[![Downloads](https://img.shields.io/badge/-Jetpack%20Compose-3a83f9?style=for-the-badge&logo=jetpackcompose&logoColor=white&labelColor=2ec781)](https://developer.android.com/jetpack/compose)
</div>
2022-06-02 16:59:18 +00:00
---
2022-06-03 11:05:33 +00:00
<p>
2022-07-13 13:17:12 +00:00
<img src="./fastlane/metadata/android/en-US/images/phoneScreenshots/1.jpg" width="15.5%" />
<img src="./fastlane/metadata/android/en-US/images/phoneScreenshots/2.jpg" width="15.5%" />
<img src="./fastlane/metadata/android/en-US/images/phoneScreenshots/3.jpg" width="15.5%" />
<img src="./fastlane/metadata/android/en-US/images/phoneScreenshots/4.jpg" width="15.5%" />
<img src="./fastlane/metadata/android/en-US/images/phoneScreenshots/5.jpg" width="15.5%" />
<img src="./fastlane/metadata/android/en-US/images/phoneScreenshots/6.jpg" width="15.5%" />
2022-06-02 16:59:18 +00:00
</p>
## Features
2022-07-23 08:51:48 +00:00
- Play (almost) any song or video from YouTube Music
2022-06-02 16:59:18 +00:00
- Background playback
- Cache audio chunks for offline playback
2022-06-06 16:08:52 +00:00
- Search for songs, albums, artists videos and playlists
2022-06-15 16:27:53 +00:00
- Display and edit songs lyrics
2022-06-02 16:59:18 +00:00
- Local playlist management
- Reorder songs in playlist or queue
- Light/Dark theme
2022-06-13 21:06:40 +00:00
- Skip silence
2022-06-15 16:27:53 +00:00
- Sleep timer
2022-06-23 11:40:26 +00:00
- Audio normalization
2022-07-13 13:17:12 +00:00
- Persistent queue
2022-06-06 18:47:46 +00:00
- Open YouTube/YouTube Music links (`watch`, `playlist`)
2022-06-02 16:59:18 +00:00
- ...
## Installation
2022-07-18 05:56:38 +00:00
[<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/it.vfsfitvnm.vimusic/)
[<img src="https://github.com/machiav3lli/oandbackupx/blob/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png"
alt="Get it on GitHub"
height="80">](https://github.com/vfsfitvnm/ViMusic/releases/latest)
2022-06-02 16:59:18 +00:00
After installing, I recommend executing the following ADB command to neutralize some animation lags you may experience in cold starts:
```
adb shell cmd package compile -r bg-dexopt it.vfsfitvnm.vimusic
```
## Similar projects, inspirations and acknowledgments
- [**Beatbump**](https://github.com/snuffyDev/Beatbump): Alternative YouTube Music frontend built with Svelte/SvelteKit.
- [**music**](https://github.com/z-huang/music): A material design music player with music from YouTube/YouTube Music.
- [**YouTube-Internal-Clients**](https://github.com/zerodytrash/YouTube-Internal-Clients): A python script that discovers hidden YouTube API clients. Just a research project.
- [**ionicons**](https://github.com/ionic-team/ionicons): Premium hand-crafted icons built by Ionic, for Ionic apps and web apps everywhere.