little...

This commit is contained in:
Cuynu 2024-03-31 01:51:46 +00:00
commit 20b311fa81

206
README.md
View file

@ -1,24 +1,22 @@
# YouTube Vanced+ [placeholder]
**Modification of YouTube/YouTube Music app for Android with ad-free, background playback and many other tweaks made by Cuynu!**
<a href="https://discord.gg/U7z2hsxbyM">
<img alt="Discord" src="https://img.shields.io/discord/1077997663628296333?color=%2300C853&label=YouTube%20VancedX%20Server&logo=discord&logoColor=%2300C853&style=for-the-badge">
</a>
</p>
<a href="https://telegram.me/vxupdate" ><img src="https://img.shields.io/badge/YouTube Vanced+ Channel-2CA5E0?style=for-the-badge&logo=telegram&logoColor=dark"></a>
<p align="left">
<a href="https://discord.gg/U7z2hsxbyM">
<img alt="Discord" src="https://img.shields.io/discord/1077997663628296333?color=%2300C853&label=YouTube%20VancedX%20Server&logo=discord&logoColor=%2300C853&style=for-the-badge">
</a>
## Table of Contents (Quick navigation)
## Table of Contents
* [When Vanced+ will be available?](#well)
* [Wait](#wait)
* [Why this project still exists even ReVanced was a replacement of YouTube Vanced ?](#why-this-project-still-exists-even-revanced-was-a-replacement-of-youtube-vanced-)
* [Credits](#credits)
* [Features](#features)
* [Known issues](#known-issues)
* [Building YouTube Vanced+ from source](#building)
* [Building YouTube Vanced+ from source](https://gitlab.com/cuynu/vancedx/-/wikis/Building)
* [Download YouTube Vanced+ APKs](#download)
* [Troubleshoot](#troubleshoot)
* [Troubleshoot](https://gitlab.com/cuynu/vancedx/-/wikis/Troubleshoot)
* [Source code](#source-code)
## Introduction
@ -49,7 +47,61 @@ Thanks for visting this project and we hope one day we can back and continue to
## Download
Notice : It is recommended to build Vanced+ yourself instead of using pre-bulit apk or module, follow **[this instruction](#building)** to build for yourself. if you can't build or lazy, use pre-bulit apk below, its have all patches included :)
### You won't be able to download **YouTube Vanced+** as this project are not publicly available yet, the repository and the download section are just "placeholder".
### Instead, you can try old Unofficial Vanced by clicking "Older version" on download section below, sorry for this inconvenient.
Notice : It is recommended to build Vanced+ yourself instead of using pre-bulit apk or module, follow **[this instruction](https://gitlab.com/cuynu/vancedx/-/wikis/Building)** to build for yourself. if you can't build or lazy, use pre-bulit apk below, its have all patches included :)
-------------------------
### YouTube Vanced+ non-root variant
**[Download latest version of Vanced+ MicroG](https://gitlab.com/cuynu/VancedxMicroG/-/releases)**
Current Version : **19.12.36** | **[Older version](https://gitlab.com/cuynu/ytvancedx/-/releases)**
Minimum Android version : **9+ (Pie)**
### Black Theme
**[Download Black theme variant for arm64-v8a](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Black%20Theme/)**
**[Download Black theme variant for armeabi-v7a](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Black%20Theme/)**
**[Download Black theme variant for x86](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Black%20Theme/)**
**[Download Black theme variant for x86_64](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Black%20Theme/)**
**[Download Black theme variant for Universal](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Black%20Theme/)**
-------------------------
### Dark Theme
**[Download Dark theme variant for arm64-v8a](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Dark%20Theme/)**
**[Download Dark theme variant for armeabi-v7a](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Dark%20Theme/)**
**[Download Dark theme variant for x86](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Dark%20Theme/)**
**[Download Dark theme variant for x86_64](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Dark%20Theme/)**
**[Download Dark theme variant for Universal](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Dark%20Theme/)**
-------------------------
### Material You Theme (Android 12+)
**[Download Material You theme variant for arm64-v8a](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Material%20You%20Theme/)**
**[Download Material You theme variant for armeabi-v7a](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Material%20You%20Theme/)**
**[Download Material You theme variant for x86](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Material%20You%20Theme/)**
**[Download Material You theme variant for x86_64](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Material%20You%20Theme/)**
**[Download Material You theme variant for Universal](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Non-root%20Packages/Vanced%2B%2019.01.32/Material%20You%20Theme/)**
-------------------------
@ -113,136 +165,8 @@ Notice : Install **[detach module](https://github.com/j-hc/zygisk-detach/release
#### [View source code of YouTube Vanced+ (cli)](https://gitlab.com/cuynu/vancedx-cli)
-------------------------
## Known issues
- Chromecast v2 casting does not works on non-root variant due to Vanced+ microG
- In-app purchases can't be processed on non-root variant
- Video playback issue may still occurrs for non-root users with Vanced+ microG (no with rooted user + GMS)
- Most features are still BETA.
- RYD might not works if patched on version 18.46+
-------------------------
## Troubleshoot
> If these solution isn't fix your problem, please create issues **[here.](https://gitlab.com/cuynu/ytvancedx/-/issues)**
**Video playback not working (buffer issue)**
Solution for YouTube Vanced+ (18.44.40+) :
- Enable `Fix video playback buffer issue` option on Vanced settings -> Video. Buffering problem should fix.
**No internet connection:**
- Remove your account from Vanced+ MicroG (If have and try again)
- Wipe Vanced+ MicroG & YouTube Vanced+ & YouTube Music Vanced+ app data and cache
- Enable auto start for Vanced+ MicroG if you use heavy customized Android version such as MIUI,OneUI,FlymeOS,HarmonyOS,etc
- For Tecno user : Find and open Phone Master app, go to auto start manager, allow Vanced+ microG and YouTube Vanced+ auto start.
**App not installed :**
- Free up some storage space and try again
- Uninstall official YouTube Vanced client downloaded from Vanced Manager or other unknown sources then try again.
- Make sure you have downloaded Universal version of YouTube Vanced+/YouTube Music Vanced+
- Check out if old YouTube Vanced still installed in multiple user & virtual space mode
**Crash when opening & "Vanced+ microG can't be started :(" toast showing :**
- Install or reinstall Vanced+ MicroG
- Turn off battery optimization for Vanced+ MicroG
- Allow Vanced+ MicroG run on background or auto start (on heavy customized OS : MIUI,OneUI,FlymeOS,HarmonyOS,etc)
- For Tecno user : Find and open Phone Master app, go to auto start manager, allow Vanced+ microG and YouTube Vanced+ auto start.
- Wipe app data and cache
- Reinstall YouTube Vanced+ client
**There was a problem parsing the package:**
- Check your Android version, Make sure your current Android version meet minimum required Android version.
- Redownload APK file.
-------------------------
## Building
**Building from Vanced+ source code**
**CAUTION : Only Android & Linux are supported! If you are building on unsupported platform, we will refuse to support!**
Clone essential repository
`git clone https://gitlab.com/cuynu/vancedx-patches.git`
`git clone https://gitlab.com/cuynu/vancedx-integrations.git`
`git clone https://gitlab.com/cuynu/vancedx-cli.git`
Open `vancedx-patches` repository in IntelliJ IDEA, make your changes and compile it, after finished compiled, the compiled file should be `vancedx-patches-vX.XXX.jar`
Open `vancedx-integrations` repository in Android Studio, make your change and compile it, after compiled, the compiled file should be `vancedx-integrations-vX.XXX.apk`
Open `vancedx-cli` repository in IntelliJ IDEA, make your change and compile it, after compiled, the compiled file should be `vancedx-cli-vX.XXX.jar`
**Patching YouTube app**
- For Android users or who lazy to bulit patches & integrations & cli from source, use pre-bulit package here :
[vancedx-patches pre-bulit](https://gitlab.com/cuynu/vancedx-patches/-/releases)
[vancedx-integrations pre-bulit](https://gitlab.com/cuynu/vancedx-integrations/-/releases)
[vancedx-cli pre-bulit](https://gitlab.com/cuynu/vancedx-cli/-/releases)
**Linux :**
- Make sure you have installed `openjdk-17`
- Compile all of essential components or download pre-bulit package above
- Download YouTube or YouTube Music apk (not apks,apkm) and rename it to youtube.apk (YouTube), ytm.apk (for YouTube Music)
- Use Command below to patch.
**Android :**
- Install [Termux](https://termux.dev/en/), open and install openjdk `pkg install openjdk-17` `y`
- type `curl -sLo vancedx-patches.jar [paste download url]`
- type `curl -sLo vancedx-integrations.apk [paste download url]`
- type `curl -sLo vancedx-cli.jar [paste download url]`
- Download YouTube or YouTube Music apk (not apks,apkm) and rename it to youtube.apk (YouTube), ytm.apk (for YouTube Music)
- Use Command below to patch.
**Command & example**
**YouTube (Linux) (dont run as sudo !) :**
`java -jar 'vancedx-cli-vX.XXX.jar' -p 'vancedx-patches-vX.XXX.jar' -i 'vancedx-integrations-vX.XXX.apk' -lp 'patch-name' --jks 'yourjkskey.jks' --input 'youtube.apk' --output '/VancedXAPKs/base-vx.apk'`
**YouTube Music (Linux) (dont run as sudo !) :**
`java -jar 'vancedx-cli-vX.XXX.jar' -p 'vancedx-patches-vX.XXX.jar' -i 'vancedx-integrations-vX.XXX.apk' -lp 'patch-name-music' --jks 'yourjkskey.jks' --input 'ytm.apk' --output '/VancedXAPKs/base-vx.apk'`
**YouTube (Termux):**
`java -jar 'vancedx-cli.jar' -p 'vancedx-patches.jar' -i 'vancedx-integrations.apk' -lp 'patch-name' --jks 'yourjkskey.jks' --input '/sdcard/Download/youtube.apk' --output '/VancedXAPKs/base-vx.apk'`
**YouTube Music (Termux):**
`java -jar 'vancedx-cli.jar' -p 'vancedx-patches.jar' -i 'vancedx-integrations.apk' -lp 'patch-name-music' --jks 'yourjkskey.jks' --input '/sdcard/Download/ytm.apk' --output '/VancedXAPKs/base-vx.apk'`
Tips : If you getting `Error: Invalid or corrupt jarfile`, redownload essential components then try again.
After patching process, its will generate base-vx.apk in `/sdcard/VancedXAPKs` (Android) or `/home/username/VancedXAPKs` (Linux)
For non-root users, install Vanced+ microG and patched `base-vx.apk` then enjoy !
For root users, follow additional steps on **[Vanced+ Module Template](https://gitlab.com/cuynu/vancedx-module-template)** !
## Why this project still exists even ReVanced was a replacement of YouTube Vanced ?
- This project was renamed to "YouTube Vanced+", basically i just add + after Vanced, but its still is a different project than original Vanced or ReVanced. ReVanced are too different from original Vanced and has too many useless feature that enabled by default, specially ReVanced Extended (eg : Hide suggested actions, Hide Subscription tab, Hide every YouTube components that not ADS make original YouTube experience impacted), our goal is continuing Vanced as Vanced+ branding without breaking original YouTube experience, all of features that NOT related to ADS, Downloader or Playback/PIP will be disabled by default
- That means when you install and open YouTube Vanced+ first time, all you see is a YouTube app with no ADS but without any layout modifications, unlike how ReVanced does. you still can modify layout on Vanced+ settings -> Layout but we will never set these tweaks as ON by default.
- Also we still provide pre-bulit YouTube Vanced+ app for who can't patch for yourself just or lazy. Unlike ReVanced (official channel), they never provide pre-bulit app and requires you to bulit from source
- ReVanced Extended are discontinued again recently, so its time for us!
# Well...
- I don't know when Vanced+ will available to anyone, but for now this project still being developed on PRIVATE REPOSITORY. Vanced+ always been my dream, but most ppls include u knows, i have bad memories about Unofficial Vanced and bad programming skill, that why its still not available yet
## Contribute
Users can contribute translation or new features to this project, but remember put your contributed features to "Community features" section on `Vanced+ settngs -> Extra` instead of other section and make sure these feature must be **DISABLED** by default !
@ -252,6 +176,14 @@ Contributors :
- Cuynu : maintainer
- [Syuugo](https://github.com/s1204IT) : help with japanese translation for Vanced+ microG
## Why this project still exists even ReVanced was a replacement of YouTube Vanced ?
- This project was renamed to "YouTube Vanced+", basically i just add + after Vanced, but its still is a different project than original Vanced or ReVanced. ReVanced are too different from original Vanced and has too many useless feature that enabled by default, specially ReVanced Extended (eg : Hide suggested actions, Hide Subscription tab, Hide every YouTube components that not ADS make original YouTube experience impacted), our goal is continuing Vanced as Vanced+ branding without breaking original YouTube experience, all of features that NOT related to ADS, Downloader or Playback/PIP will be disabled by default
- That means when you install and open YouTube Vanced+ first time, all you see is a YouTube app with no ADS but without any layout modifications, unlike how ReVanced does. you still can modify layout on Vanced+ settings -> Layout but we will never set these tweaks as ON by default.
- Also we still provide pre-bulit YouTube Vanced+ app for who can't patch for yourself just or lazy. Unlike ReVanced (official channel), they never provide pre-bulit app and requires you to bulit from source
- ReVanced Extended are discontinued again recently, so its time for us!
Well...
- I don't know when Vanced+ will available to anyone, but for now this project still being developed on PRIVATE REPOSITORY. Vanced+ always been my dream, but most ppls include u knows, i have bad memories about Unofficial Vanced and bad programming skill, that why its still not available yet
## Credits
**[Team Vanced](https://github.com/TeamVanced)** : Old YouTube Vanced official which is closed source