vancedx/README.md

165 lines
10 KiB
Markdown
Raw Normal View History

2024-03-27 23:32:21 +00:00
# YouTube Vanced+ [placeholder]
2024-06-06 17:14:22 +00:00
**Another open source YouTube modification that does NOT based on any ReVanced code and implemented from scratch, made by [Cuynu](https://gitlab.com/cuynu) !**
2024-02-29 08:24:57 +00:00
2024-05-23 16:46:24 +00:00
# Does this project based on ReVanced/RVX/ReX ?
2024-06-06 17:14:22 +00:00
- If you see someone saying this project are literally ReVanced, that are completely FAKE because they can't even access the Vanced+ source code or its prebulit package and what they said are just old Unofficial Vanced :)
2024-05-23 16:46:24 +00:00
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">
2024-03-31 01:51:46 +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>
2023-11-22 12:12:31 +00:00
2024-03-31 01:51:46 +00:00
## Table of Contents
2022-12-05 16:03:38 +07:00
2024-06-06 16:25:02 +00:00
* [Frequently Asked Questions](#frequently-asked-questions)
2024-06-06 17:01:28 +00:00
* [Support this project](#support-this-project)
2024-06-06 16:25:02 +00:00
* [Why this project are not on GitHub?](#why-this-project-are-not-on-github)
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)
2024-03-31 01:51:46 +00:00
* [Building YouTube Vanced+ from source](https://gitlab.com/cuynu/vancedx/-/wikis/Building)
2024-03-27 23:02:15 +00:00
* [Download YouTube Vanced+ APKs](#download)
2024-03-31 01:51:46 +00:00
* [Troubleshoot](https://gitlab.com/cuynu/vancedx/-/wikis/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**
2024-05-27 20:17:21 +00:00
- **Download videos and audios from YouTube using external downloader app (NewPipe,Seal,etc...)**
2024-03-27 23:02:15 +00:00
- **Custom video speed**
2024-05-27 20:17:21 +00:00
- **Kids miniplayer**
- **Restore old YouTube layout (Q2/2019, Q2/2020, Q1/2022 layout available)**
- **Restore old Library Tab**
- **Restore old video layout**
- **Many more...**
2023-07-25 14:08:31 +00:00
2024-03-27 23:02:15 +00:00
## Download
2024-03-31 01:51:46 +00:00
### 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.
2024-06-06 16:25:02 +00:00
**[Older Version](https://gitlab.com/cuynu/vancedx/-/releases)**
2024-03-31 01:51:46 +00:00
-------------------------
### YouTube Vanced+ non-root variant
**[Download latest version of Vanced+ MicroG](https://gitlab.com/cuynu/VancedxMicroG/-/releases)**
2024-03-27 23:02:15 +00:00
-------------------------
### YouTube Vanced+ root variant (Magisk/KernelSU)
2024-06-06 16:25:02 +00:00
Notice : Install **[detach module](https://github.com/j-hc/zygisk-detach/releases)** to prevent Play Store from update and replace installed Vanced+.
2024-03-27 23:02:15 +00:00
-------------------------
### YouTube Music Vanced+ non-root variant
**[Download latest version of Vanced+ MicroG](https://gitlab.com/cuynu/VancedxMicroG/-/releases)**
-------------------------
### YouTube Music Vanced+ root variant
2024-06-06 16:25:02 +00:00
Notice : Install **[detach module](https://github.com/j-hc/zygisk-detach/releases)** to prevent Play Store from update and replace installed Music Vanced+ app.
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
2024-06-06 16:25:02 +00:00
**Official YouTube, YT Music and YT Studio app itself are proprietary and closed source, we can't access or have that source code because its are private which only Google/YouTube developer can see its source code. We can only patch and modify YouTube from published compiled apk which is obfuscated by default with ProGuard when they compiling YouTube app.**
- Here is source code for what was modified and all of 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)
2024-03-27 23:02:15 +00:00
-------------------------
2024-06-06 16:25:02 +00:00
## Frequently Asked Questions
FAQ for Vanced+ project :
Q: Why Vanced+ take longer time to be available to anyone?
A: Because my skills. My life always been going with lazy habits, makes me unable to study needed programming language (Kotlin/Java) which is required to reverse engineering YouTube app and create an modifications called Vanced+. Well, this always been my dreams and i want to make its available ASAP. (When Vanced+ available to anyone, this answer will also disappear.)
Q: Does this project implemented from scratch by peoples?
A: No. This project are implemented by only me from scratch but its may contain commits from other contributor after then but it limited to bugfix, translations only.
Q: Does this project contributed by any old Vanced Team members?
A: No, Vanced contributor are not allowed to contribute to Vanced+ project. also, Vanced+ code are all different from Vanced but keep its inspiration
Q: Is there any pre-bulit Vanced+ package so i can just download the package and install without building?
A: Yes, its available on GitLab repository and SourceForge but we can't guarantee that we still can provide pre-bulit package for long time as Vanced has been taken down from 2022 due to distributing modified YouTube APKs (they also selling NFTs).
Q: Does Vanced+ support Android 5 & 6 & 7 ?
A: Nope, because YouTube already dropped support new version for these Android version and we do not support older version as it will return with 400 error soon
Q: Why Q2 2019 layout greyed out and can't be selected on layout selection in Vanced+ settings -> Layout settings -> Override app layout ?
A: From 2020 and above, YouTube bulit-in layout changed much component, make it incompatible when override Q2 2019 layout so in order to use Q2 2019 layout, it requires specific build of Vanced+ named q2y19, you have to download the build or patch with q2y19-layout (remember that you can't patch both q2y19-layout and newer layout to the same app)
Q: Does override older layout also spoof app version to older version ?
A: Nope, this method directly override layout to older layout depend on your selection but does not spoof app version to older version as Q2/2019, Q2/2020, Q1/2022 layout are all from older version which is deprecated long time ago, spoofing to older version will lead to 400 error response.
## Contributing to this project
Thanks for your support, but you can only contribute to this project in two ways :
- Contribute translations for Vanced+
- Report issues with full details info (logcat)
Why not bugfixes, new features?
- This limitations is to prevent someone put or use ReVanced related code to contribute to this project, as my aim is Vanced+ should be NOT contains any ReVanced related code.
2024-03-27 23:02:15 +00:00
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
2024-06-06 16:25:02 +00:00
2024-03-31 01:51:46 +00:00
## 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
2024-06-06 16:25:02 +00:00
## Why this project are NOT on GitHub?
- This project are available on GitHub "in the past" with >3k stars and >3.5M total downloads. But in 2024/01 GitHub requires all old users MUST be enable 2FA Authentication with DOTP, i don't want to do that as i usually factory reset and install/testing custom ROMs on my device (I have own YT Channel : [@cuynu](https://youtube.com/@cuynu/videos)) which is for that purpose but that not big issues, the big issues here is i was too lazy to backup secret code (used to generate 2FA code), so i deleted almost all repository on GitHub include my personal and VancedxMicroG project.
After a month, i recreated ytvanced repository on github but its only a wrapper to redirect user to this GitLab repository. I stopped using GitHub since 2024/05.
2024-03-31 01:51:46 +00:00
2024-06-06 17:00:51 +00:00
## Support this project
- Vanced+ are NON-PROFIT project and i don't want to earn any moneys from it, even if you want.
- Instead, you can support me by subscribing my [personal YouTube channel](https://youtube.com/@cuynu/community) but remember its content are just custom ROMs, rooting Android devices and some other guides but you can just ignore all of them. Also, you can request Vanced+ updates/report issues if you don't want to use GitLab by commenting on any videos i uploaded to. That enough to makes me happy and continue with Vanced+ development:)
2023-12-06 11:36:12 +00:00
## Credits
2023-07-25 14:08:31 +00:00
2024-06-06 16:25:02 +00:00
**[Team Vanced](https://github.com/TeamVanced)** : Old YouTube Vanced official which is closed source, I use its icon assets (Vanced, SponsorBlock, RYD icons)
2023-07-25 14:08:31 +00:00
2024-06-06 16:25:02 +00:00
**[inotia00](https://github.com/inotia00)** : Old YouTube Vanced (RVX) based patches which is used on Unofficial Vanced v17.34.36-v18.21.34 (this is my bad part)
2022-03-30 18:09:11 +07:00
2024-06-06 16:25:02 +00:00
**[ReVanced Team](https://github.com/revanced)** : ReVanced Team for CLI used to build old Unofficial Vanced
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)