diff --git a/README.md b/README.md index 1c6627c..313c1e0 100644 --- a/README.md +++ b/README.md @@ -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!** - - Discord -

+ + Discord + -## 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