vancedx/README.md

266 lines
14 KiB
Markdown
Raw Normal View History

2024-03-27 23:32:21 +00:00
# YouTube Vanced+ [placeholder]
2024-03-27 23:02:15 +00:00
**Modification of YouTube/YouTube Music app for Android with ad-free, background playback and many other tweaks made by Cuynu!**
2024-02-29 08:24:57 +00:00
2023-11-22 12:12:31 +00:00
<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>
2024-03-27 23:32:21 +00:00
</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>
2024-03-27 23:02:15 +00:00
<p align="left">
2023-11-22 12:12:31 +00:00
2023-07-25 14:08:31 +00:00
## Table of Contents (Quick navigation)
2022-12-05 16:03:38 +07:00
2024-03-27 23:32:21 +00:00
* [When Vanced+ will be available?](#well)
* [Wait](#wait)
2023-12-05 05:09:27 +00:00
* [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-)
2023-07-25 14:08:31 +00:00
* [Credits](#credits)
2024-03-27 23:02:15 +00:00
* [Features](#features)
* [Known issues](#known-issues)
* [Building YouTube Vanced+ from source](#building)
* [Download YouTube Vanced+ APKs](#download)
* [Troubleshoot](#troubleshoot)
2023-07-25 14:08:31 +00:00
* [Source code](#source-code)
2022-11-09 00:51:07 +07:00
2024-03-27 23:02:15 +00:00
## Introduction
This project was created after discontinuation of Vanced official aswell wars between Unofficial Vanced and ReVanced Extended. Its not `YouTube Vanced`. The project are in development and will going release soon as possible!
2023-07-25 14:08:31 +00:00
2024-03-27 23:02:15 +00:00
## Features
- **YouTube Vanced+ blocks ads from YouTube and uses SponsorBlock to skip in-video sponsor segments**
- **The picture-in-picture mode allows watching videos in a floating window**
- **Background play allows playing video sound in background**
- **Override max resolution**
- **Swipe control for brightness and volume**
- **Google login like the original YouTube app using Vanced+ MicroG**
- **Dislike counter re-added using the Return YouTube Dislike database**
- **Disable YouTube Shorts function everywhere**
- **Enable old layout of YouTube**
- **Download videos from YouTube using external downloader app**
- **Custom video speed**
- **Enable YouTube Premium header (not actually enable Premium features!)**
- *Many more...*
2023-07-25 14:08:31 +00:00
2024-03-27 23:02:15 +00:00
## Wait...
**Why i couldn't find any Vanced+ APKs or its source code, does this project abandoned ?**
We are tired of "ReVanced Extended/ReVanced" community cuz of their measures to force we to don't do anything related to Vanced+ development and only want "ReVanced Extended/ReVanced/ReX" to be exists as their only YouTube for Android mods, that why this project literally abandoned months ago. The Vanced+ source code (patches/integrations/cli) are private until new announcement. (ofc if Vanced+ ready to release, its will come with prebulit + source code).
Thanks for visting this project and we hope one day we can back and continue to implement Vanced+ !
## Download
2024-03-28 03:29:39 +00:00
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 :)
2024-03-27 23:02:15 +00:00
-------------------------
### YouTube Vanced+ root variant (Magisk/KernelSU)
Notice : Install **[detach module](https://github.com/j-hc/zygisk-detach/releases)** to prevent Play Store from update and replace installed Vanced+. If you are using microG services core as replacement for GMS, enable `Fix video playback issue` on Vanced+ settings -> Video to fix buffering issue !
Current Version : **19.01.32** | **[Older version](https://gitlab.com/cuynu/ytvancedx/-/releases)**
Minimum Android version : **9+ (Pie)**
### Black Theme
**[Download Black theme variant for Universal](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Root%20Packages%20%28Magisk%20or%20KSU%20Module%29/Vanced%2B%2019.01.32/Black%20Theme/)**
-------------------------
### Dark Theme
**[Download Dark theme variant for Universal](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Root%20Packages%20%28Magisk%20or%20KSU%20Module%29/Vanced%2B%2019.01.32/Dark%20Theme/)**
-------------------------
### Material You Theme (Android 12+)
**[Download Material You theme variant for Universal](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced%2B/Vanced%2B%20Root%20Packages%20%28Magisk%20or%20KSU%20Module%29/Vanced%2B%2019.01.32/Material%20You%20Theme/)**
-------------------------
### YouTube Music Vanced+ non-root variant
**[Download latest version of Vanced+ MicroG](https://gitlab.com/cuynu/VancedxMicroG/-/releases)**
Current Version : **6.28.52** | **[Older version](https://gitlab.com/cuynu/ytvancedx/-/releases)**
Minimum Android version : **9+ (Pie)**
[![Download YouTube Vanced+ Prebulit ](https://a.fsdn.com/con/app/sf-download-button)](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced+/Music%20Vanced%2B%20Non-root%20Packages)
-------------------------
### YouTube Music Vanced+ root variant
Notice : Install **[detach module](https://github.com/j-hc/zygisk-detach/releases)** to prevent Play Store from update and replace installed Vanced+.
[![Download YouTube Vanced+ Prebulit ](https://a.fsdn.com/con/app/sf-download-button)](https://sourceforge.net/projects/vancedx/files/Prebulit%20Vanced+/Music%20Vanced%2B%20Root%20Packages%20(Magisk%20or%20KSU%20Module))
2023-11-20 16:44:35 +00:00
-------------------------
2023-07-25 14:08:31 +00:00
## Source code
2023-02-25 15:18:02 +07:00
2023-09-30 07:47:52 +00:00
**Official YouTube app itself are proprietary and closed source, we can't access YouTube source code because its are private which only Google/YouTube developer can see its original code in kotlin and java which is not obfuscated and modify it. So we can only patch and modify YouTube from published compiled binary apk which is extremely obfuscated by Google/YouTube developer when they compiling YouTube app. Here is source code for what was modified and all of Vanced+/Vanced features, again, DONT ask for YouTube app source code! :**
2023-02-25 15:18:02 +07:00
2023-09-30 07:47:52 +00:00
#### [View source code of YouTube Vanced+ (patches)](https://gitlab.com/cuynu/vancedx-patches)
2023-02-25 15:18:02 +07:00
2023-09-30 07:47:52 +00:00
#### [View source code of YouTube Vanced+ (integrations)](https://gitlab.com/cuynu/vancedx-integrations)
2023-11-20 04:49:00 +00:00
#### [View source code of YouTube Vanced+ (cli)](https://gitlab.com/cuynu/vancedx-cli)
2023-11-22 12:12:31 +00:00
2024-03-27 23:02:15 +00:00
-------------------------
## 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+
2023-11-20 04:49:00 +00:00
-------------------------
2023-12-06 11:36:12 +00:00
## Troubleshoot
2023-03-14 14:29:31 +07:00
2023-09-30 07:53:13 +00:00
> If these solution isn't fix your problem, please create issues **[here.](https://gitlab.com/cuynu/ytvancedx/-/issues)**
2023-03-14 14:29:31 +07:00
**Video playback not working (buffer issue)**
2023-04-14 15:31:21 +07:00
2023-11-20 04:49:00 +00:00
Solution for YouTube Vanced+ (18.44.40+) :
2023-07-25 14:08:31 +00:00
- Enable `Fix video playback buffer issue` option on Vanced settings -> Video. Buffering problem should fix.
2023-04-14 15:31:21 +07:00
2023-03-14 14:29:31 +07:00
**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.
2023-03-14 14:29:31 +07:00
**App not installed :**
- Free up some storage space and try again
2023-07-25 14:08:31 +00:00
- 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
2023-03-14 14:29:31 +07:00
2023-11-20 04:49:00 +00:00
**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.
2023-03-14 14:29:31 +07:00
- Wipe app data and cache
2023-06-03 16:19:43 +00:00
- Reinstall YouTube Vanced+ client
2023-03-14 14:29:31 +07:00
**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.
2022-09-23 18:41:39 +07:00
2023-11-20 04:49:00 +00:00
-------------------------
2023-12-06 11:36:12 +00:00
## Building
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
**Building from Vanced+ source code**
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
**CAUTION : Only Android & Linux are supported! If you are building on unsupported platform, we will refuse to support!**
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
Clone essential repository
2023-11-20 04:49:00 +00:00
`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`
2024-03-27 23:02:15 +00:00
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`
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
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`
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
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`
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
**Patching YouTube app**
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
- For Android users or who lazy to bulit patches & integrations & cli from source, use pre-bulit package here :
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
[vancedx-patches pre-bulit](https://gitlab.com/cuynu/vancedx-patches/-/releases)
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
[vancedx-integrations pre-bulit](https://gitlab.com/cuynu/vancedx-integrations/-/releases)
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
[vancedx-cli pre-bulit](https://gitlab.com/cuynu/vancedx-cli/-/releases)
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
**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.
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
**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.
2023-11-20 07:52:22 +00:00
2024-03-27 23:02:15 +00:00
**Command & example**
2023-11-20 07:52:22 +00:00
2024-03-27 23:02:15 +00:00
**YouTube (Linux) (dont run as sudo !) :**
2023-11-20 05:24:57 +00:00
2024-03-27 23:02:15 +00:00
`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'`
2023-11-20 04:49:00 +00:00
2023-11-20 07:52:22 +00:00
**YouTube Music (Linux) (dont run as sudo !) :**
2023-11-20 05:24:57 +00:00
2024-03-27 23:02:15 +00:00
`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'`
2023-11-20 05:24:57 +00:00
2024-03-27 23:02:15 +00:00
**YouTube (Termux):**
2023-11-20 07:52:22 +00:00
2024-03-27 23:02:15 +00:00
`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'`
2023-11-20 07:52:22 +00:00
2024-03-27 23:02:15 +00:00
**YouTube Music (Termux):**
2023-11-20 07:52:22 +00:00
2024-03-27 23:02:15 +00:00
`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'`
2023-11-20 07:52:22 +00:00
2024-03-27 23:02:15 +00:00
Tips : If you getting `Error: Invalid or corrupt jarfile`, redownload essential components then try again.
2023-11-20 05:24:57 +00:00
2024-03-27 23:02:15 +00:00
After patching process, its will generate base-vx.apk in `/sdcard/VancedXAPKs` (Android) or `/home/username/VancedXAPKs` (Linux)
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
For non-root users, install Vanced+ microG and patched `base-vx.apk` then enjoy !
2023-11-20 04:49:00 +00:00
2024-03-27 23:02:15 +00:00
For root users, follow additional steps on **[Vanced+ Module Template](https://gitlab.com/cuynu/vancedx-module-template)** !
2023-11-20 04:49:00 +00:00
2023-12-05 05:09:27 +00:00
## Why this project still exists even ReVanced was a replacement of YouTube Vanced ?
2023-12-05 05:15:04 +00:00
- 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.
2023-12-05 05:20:18 +00:00
- 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
2024-02-05 19:30:26 +00:00
- ReVanced Extended are discontinued again recently, so its time for us!
2023-12-05 05:20:18 +00:00
2024-03-27 23:32:21 +00:00
# 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
2024-03-27 23:02:15 +00:00
## 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 !
2023-12-06 11:36:12 +00:00
Contributors :
2023-12-05 05:24:49 +00:00
- Cuynu : maintainer
- [Syuugo](https://github.com/s1204IT) : help with japanese translation for Vanced+ microG
2023-12-05 05:09:27 +00:00
2023-12-06 11:36:12 +00:00
## Credits
2023-07-25 14:08:31 +00:00
**[Team Vanced](https://github.com/TeamVanced)** : Old YouTube Vanced official which is closed source
**[inotia00](https://github.com/inotia00)** : Old YouTube Vanced (RVX) based patches (17.34.36-18.21.34)
2022-03-30 18:09:11 +07:00
2023-09-30 07:47:52 +00:00
**[ReVanced Team](https://github.com/revanced)** : ReVanced Team
2022-03-14 11:50:31 +07:00
2023-11-20 04:49:00 +00:00
-------------------------
2023-09-30 07:53:13 +00:00
2024-03-27 23:02:15 +00:00
## [Go back to top of this page](#youtube-vanced-placeholder)