How to Use ReVanced GmsCore for YouTube ReVanced
Complete Setup Guide 2026 — Install ReVanced GmsCore (the ReVanced GmsCore fork), patch YouTube with ReVanced Manager v2, and restore Google sign-in on any non-rooted Android device.
Using modified YouTube clients violates YouTube’s Terms of Service. This guide is for educational purposes only. We do not distribute copyrighted APKs. Always patch the official YouTube APK yourself using ReVanced Manager.
🎤 Quick Answers (Voice Search)
"GmsCore support" patch, then sign in normally.📋 Table of Contents
- What Is ReVanced GmsCore?
- The Old “Vanced microG” Is Dead
- How ReVanced GmsCore (GmsCore) Works
- Key Entities in the Ecosystem
- ReVanced Manager v2: What’s New in 2026
- Pre-Flight Checklist
- Prerequisites & Official Downloads
- Step-by-Step: Install ReVanced GmsCore
- Default Patches & Dangerous Patches
- Rooted Devices: Do You Need GmsCore?
- ReVanced Extended vs. Official ReVanced
- ReVanced CLI vs. ReVanced Manager
- Troubleshooting
- Privacy & Security
- YouTube ReVanced vs. YouTube Premium
- Frequently Asked Questions
- Conclusion
What Is ReVanced GmsCore?
New to the ReVanced ecosystem? Start with our YouTube Vanced vs. ReVanced comparison to understand how the projects differ.
When ReVanced users talk about signing into a patched YouTube app, they are using ReVanced GmsCore — a downstream fork of the upstream microG project. It is the authentication layer that lets you sign into YouTube ReVanced with your Google account on a non-rooted phone.
Upstream microG is an open-source reimplementation of Google Play Services created by Marvin Wißfeld (mar-v-in) for custom ROMs like LineageOS and /e/OS. The ReVanced Team forked this project, changed its package name to app.revanced.android.gms, stripped out unnecessary components, and tailored it specifically for ReVanced apps. Huawei users should also see our microG for Huawei setup guide.
The Old “Vanced microG” Is Dead
If you are searching for “Vanced microG,” “microG for YouTube Vanced,” or downloading APKs labeled com.mgoogle.android.gms, you are following outdated guides. Vanced MicroG was discontinued along with YouTube Vanced in March 2022 and became nonfunctional for ReVanced users by March 2024.
The only working solution today is ReVanced GmsCore.
How ReVanced GmsCore Works
When you patch YouTube with ReVanced Manager, you must include the GmsCore support patch. This patch modifies YouTube to look for app.revanced.android.gms instead of the official com.google.android.gms. Here is the actual flow:
- YouTube ReVanced requests Google sign-in.
- The GmsCore support patch redirects the request to ReVanced GmsCore.
- ReVanced GmsCore handles the OAuth login flow with Google’s servers.
- Your account token is returned to YouTube ReVanced.
- Subscriptions, playlists, and watch history sync normally.
Key Entities in the ReVanced GmsCore Ecosystem
The ReVanced Team
Led by oSumAtrIX, they maintain:
- ReVanced Manager (the patching tool)
- ReVanced Patches (the modification bundle)
- ReVanced GmsCore (the microG fork for ReVanced)
The ReVanced Team maintains the core patching tools, GmsCore, and patch bundles used across the ecosystem.
inotia00 & ReVanced Extended (RVX)
inotia00 maintains ReVanced Extended, a popular fork with more aggressive patches. RVX uses mMicroG (also called GMSCore by inotia00) — a different microG fork with the legacy package name com.mgoogle.android.gms. For the music-focused build, check out RVX YT Music Extended.
ReVanced GmsCore (app.revanced.android.gms) does not work with ReVanced Extended, and mMicroG does not work with official ReVanced.
Upstream microG Project
Led by mar-v-in, this is the source project. ReVanced GmsCore is derived from it. If you want microG for a custom ROM (LineageOS, /e/OS), see the upstream microG documentation instead. This article focuses specifically on ReVanced use.
ReVanced Manager v2: What’s New in 2026
In March 2026, the ReVanced Team released ReVanced Manager v2.0.0, a complete rewrite using Jetpack Compose. As of mid-2026, development builds have progressed significantly. For early access builds, see our ReVanced Manager beta guide.
Key changes for GmsCore users:
- Auto-download APKs: Manager can now fetch compatible YouTube APKs automatically via a plugin system.
- Faster patching: Improved performance on low-end devices.
- Better error reporting: Clearer logs when GmsCore support patch fails.
The Auto-Download System
ReVanced Manager v2 includes a plugin-based APK downloader system:
- APK Downloader Plugin — Fetches compatible YouTube APKs and automatically merges .apkm bundles into a single .apk file.
- Play Store Downloader — Logs into your Google account to download the APK directly. Warning: Due to technical limitations, this only fetches the latest YouTube version, which may not match the suggested patch version. If the latest version is newer than what the patches support, supply an offline APK manually.
Only use the official ReVanced Manager release. Third-party sites distributing pre-built “ReVanced APKs” are counterfeit and have been found to contain malware, injected ads, and view-farming scripts.
Pre-Flight Checklist
Before you start patching, verify every item on this list to avoid common failures:
- Android 8 or higher (Settings > About Phone)
- ARMv8 or x86 architecture (use AIDA64 or DevCheck to verify)
- At least 1 GB free storage
- At least 2 GB free RAM (close all background apps first)
- Original YouTube app uninstalled (the patched APK will not install over the official one)
- Device battery above 50% (patching is CPU-intensive)
- Private DNS disabled (Settings > Network > Private DNS > Off)
- VPN disconnected
- Downloaded ReVanced Manager from the official source only
- Downloaded ReVanced GmsCore from the official source only
Prerequisites & Official Downloads
Before you start, you need:
- An Android device running Android 8+ (Android 16 supported).
- ReVanced Manager — the official patching tool. See our ReVanced Manager setup guide or the v2 feature overview.
- ReVanced GmsCore — the companion authentication service.
- A compatible YouTube APK (if not auto-downloaded by Manager). As of February 15, 2026, the latest supported YouTube version is 20.14.43. Always check the ReVanced Patches documentation for the current target version range.
Where to Get ReVanced GmsCore
| Source | Notes |
|---|---|
| Official ReVanced Release | The official GmsCore fork. This is what you want for ReVanced. |
| Upstream microG F-Droid | For custom ROM users; do not use for ReVanced. |
Do not download GmsCore from random APK hosting sites. Unofficial builds may contain spyware or outdated signatures that break authentication.
Step-by-Step: Install ReVanced GmsCore (Non-Root)
This guide assumes you are using ReVanced Manager v2 on a non-rooted device running Android 14, 15, or 16.
Install ReVanced GmsCore
Download the latest app.revanced.android.gms APK from the official release source. Open the APK file. If prompted, allow installation from your browser or file manager. Complete the installation. You do not need to open it immediately.
Patch YouTube with ReVanced Manager
Open ReVanced Manager. Tap “Patch” and select the YouTube app (or supply a compatible APK). In the patch selection screen, ensure “GmsCore support” is enabled. This patch is mandatory for Google sign-in on non-root devices.
Add other desired patches such as SponsorBlock, Return YouTube Dislike, and background playback. Tap “Patch” and wait for the process to complete.
Install the patched APK. The patched APK will not install over your existing official YouTube app. You must uninstall the original YouTube app first, then install the patched APK.
Sign In
Open the patched YouTube ReVanced app. Tap the profile icon and select “Sign in.” Choose your Google account and complete the OAuth flow. Your subscriptions, playlists, and history will sync.
Patching Time Benchmarks
Based on community speedrun data:
Default Patches & The Dangerous Patches List
Default Selection for Beginners
The official ReVanced Team recommends a default patch selection for noobs and starters. Unless you have a specific reason and understand the consequences, do NOT disable the default patches. Once you are comfortable, explore advanced customization options.
Unless you are an advanced user who knows exactly what you are doing, do not enable these patches. They will break your install, cause crashes, or make the patched APK fail to install entirely:
- Change package name
- Change version code
- Enable Android debugging
- Export all activities
- Hex
- Override certificate pinning
- Predictive back gesture
- Remove screen capture restriction
- Remove screenshot restriction
- Spoof wifi connections
- Spoof SIM country
- Spoof Wi-Fi connection
Selecting any of these is the most common cause of “App not installed” errors after patching.
Rooted Devices: Do You Need ReVanced GmsCore?
If your device is rooted with Magisk, you generally do not need ReVanced GmsCore. On rooted devices, YouTube ReVanced can use the official com.google.android.gms (Google Play Services) directly because root access allows signature spoofing at the system level. Need root help? See our Magisk Manager guide.
However, some users still prefer ReVanced GmsCore on rooted devices to:
- Avoid modifying system-level Google components.
- Maintain a cleaner separation between official and modified apps.
- Use ReVanced alongside banking apps that detect Play Integrity API failures.
ReVanced Extended vs. Official ReVanced
Not sure which mod to pick? Our ReVanced vs. other YouTube mods comparison breaks down all the options.
If you are using ReVanced Extended by inotia00, the setup differs:
| Feature | Official ReVanced | ReVanced Extended (RVX) |
|---|---|---|
| Maintainer | ReVanced Team (oSumAtrIX) | inotia00 |
| GmsCore Fork | ReVanced GmsCore | mMicroG |
| Package Name | app.revanced.android.gms |
com.mgoogle.android.gms (legacy) |
| Patch Names | ReVanced Patches | ReVanced Extended Patches |
| Update Frequency | Regular | Regular |
| Patch Philosophy | Stable, minimal | Feature-rich |
| Manager | ReVanced Manager v2 | RVX Manager |
| Target YouTube Versions | 20.14.43 (check docs) | Varies; check RVX docs |
| Best For | Stability seekers | Power users |
Installing ReVanced GmsCore with ReVanced Extended, or mMicroG with official ReVanced, will result in authentication failures.
ReVanced CLI vs. ReVanced Manager
Most users should use ReVanced Manager. However, power users may prefer the CLI:
| Factor | ReVanced Manager | ReVanced CLI |
|---|---|---|
| Skill Level | Beginner-friendly | Advanced / developers |
| Auto-download APK | Yes (v2+) | No |
| Patch Selection | GUI with defaults | Manual JSON/flags |
| Patching Speed | Slower (on-device) | Faster (desktop) |
| Best For | Most users | Bulk patching, custom builds |
If you are new to ReVanced, stick with ReVanced Manager v2.
Troubleshooting ReVanced GmsCore
Even with correct setup, Google’s evolving anti-tampering measures (including Play Integrity API and PoToken validation) can cause issues. Here are verified fixes for 2026. For a broader overview, see our full YouTube Vanced troubleshooting guide.
Sign-In Loop or “Can’t Sign In” Error
If you are seeing persistent login failures, also read our dedicated account login error fix guide for device-specific solutions.
- Match your versions. Ensure ReVanced Manager, ReVanced Patches, ReVanced GmsCore, and your YouTube base APK are all from the same time period. Mismatched versions are the #1 cause of auth failures.
- Update GmsCore. In February 2026, Google changed authentication endpoints that broke login. The ReVanced Team merged fixes from upstream microG. The GmsCore support patch now includes a version check that prompts you to update GmsCore if it is outdated. If you prefer not to receive update prompts, you can disable the version check in the patch options, though this is not recommended.
- Disable Private DNS. Go to Settings > Network > Private DNS and set it to Off temporarily.
- Disable VPN. Some VPN IP ranges are flagged by Google.
- Clear data. Clear storage for both ReVanced GmsCore and YouTube ReVanced, then retry sign-in.
- Exempt from Battery Optimization. Go to Settings > Apps > ReVanced GmsCore > Battery > Unrestricted. Do the same for YouTube ReVanced.
- Check system time. Incorrect device time breaks TLS certificate validation. Use network-provided time.
On many Samsung devices, GmsCore works fine even with battery optimization enabled. The aggressive “disable battery optimization” advice is overprescribed. If you are on a Samsung device, try sign-in first before disabling it. Only disable it if you experience actual sync failures.
“App Not Installed” Error
- Uninstall old Vanced MicroG (
com.mgoogle.android.gms) completely. - Uninstall any previous ReVanced GmsCore builds.
- Ensure you downloaded the correct APK for your CPU architecture (ARM64 for most modern phones).
- Free up storage. You need at least 1 GB free for patching to complete.
- Verify you did not select any patches from the Dangerous Patches List above.
GmsCore Crashing on Android 16
- Update to the latest ReVanced GmsCore release. The ReVanced Team syncs with upstream microG regularly to maintain compatibility with new Android versions.
- If crashes persist, capture an adb logcat during sign-in and report it to the ReVanced GitHub issues page with your device model and patch version.
Not Syncing Subscriptions or History
- Confirm you are signed into the correct account.
- In YouTube ReVanced settings, ensure sync is enabled for history and subscriptions.
- Update both ReVanced GmsCore and the patched YouTube app. Google frequently changes internal APIs that break sync on older patch versions.
Patching Fails or Freezes
Connection drops during patching are a common cause of freezes. See our network connection error guide for connectivity fixes before you retry.
- Low RAM: A documented issue on devices with limited RAM (e.g., 1.48 GB used out of 3.82 GB total) causes
Could not decode attr valuewarnings and patching failure. Close all background apps and ensure at least 2 GB free RAM before patching. - HyperOS / Xiaomi Bug: On devices like the POCO X8 Pro running HyperOS 3.0.5.0 / Android 16, the built-in APK downloader in ReVanced Manager fails indefinitely. Workaround: Download the target APK manually using your browser, then patch it through Storage instead of using the built-in downloader.
ReVanced Manager Download Failed
- If the auto-downloader fails, manually source the YouTube APK as a single .apk file (not .apks or .xapk).
- Ensure you are selecting a version that matches the current ReVanced Patches target (e.g., 20.14.43).
Privacy & Security: What ReVanced GmsCore Actually Does
ReVanced GmsCore is not an “anti-ban” tool, and it does not “hide your usage from Google servers.” These are myths propagated by outdated guides.
What it actually does:
- Implements a subset of Google Play Services APIs (primarily sign-in and push notifications).
- Reduces data collection compared to full Google Play Services by omitting Ads, Firebase Analytics, DroidGuard, and other heavy components.
- Allows signature spoofing so modified apps can authenticate without root.
What it does NOT do:
- Hide the fact that you are using a modified client from YouTube’s server-side detection.
- Guarantee immunity from account warnings or bans. Google uses behavioral analysis, PoToken validation, and traffic fingerprinting that operate independently of the local GmsCore layer.
Best practices:
- Use a secondary Google account for modified apps if you are risk-averse.
- Keep ReVanced GmsCore updated. Security patches from upstream microG are merged regularly.
- Do not grant unnecessary permissions. ReVanced GmsCore requires minimal permissions for basic authentication.
YouTube ReVanced vs. YouTube Premium
| Factor | YouTube Premium ($13.99/mo) | YouTube ReVanced (Free) |
|---|---|---|
| Ad-free viewing | ✅ Yes | ✅ Yes |
| Background playback | ✅ Yes | ✅ Yes |
| SponsorBlock integration | ❌ No | ✅ Yes |
| Return YouTube Dislike | ❌ No | ✅ Yes |
| Creator revenue support | ✅ Yes (revenue share) | ❌ No |
| Multi-device support | ✅ Yes (iOS, TV, web, desktop) | ❌ Android only (see SmartTube for TV) |
| ToS compliance | ✅ Yes | ❌ Violates YouTube ToS |
| Setup time | 2 minutes | 15–35 minutes |
| Risk of account action | None | Low, but non-zero |
If you can afford YouTube Premium and want to support creators directly, it is the safer, simpler choice. ReVanced is for users who want features like SponsorBlock and dislike counts that Premium does not offer, or who cannot access Premium in their region. You can also explore YouTube Premium mod alternatives for other setups.
Frequently Asked Questions
No. Vanced MicroG (com.mgoogle.android.gms) is dead and has not worked since March 2024. ReVanced GmsCore (app.revanced.android.gms) is the current, actively maintained fork for the ReVanced ecosystem.
No. ReVanced GmsCore is designed specifically for non-root devices. Rooted users can use it too, but they also have the option to use official Google Play Services with signature spoofing.
No. ReVanced Extended requires mMicroG by inotia00. Mixing the two will break sign-in.
Yes, if you use the official release source. Avoid third-party APK mirrors.
Google changes its internal authentication APIs frequently. You must re-patch YouTube with the latest ReVanced Patches and ensure your ReVanced GmsCore is up to date. The GmsCore support patch now includes a version check to warn you when updates are needed.
Match your app and GmsCore versions, clear data for both apps, disable Private DNS and VPN temporarily, exempt both apps from battery optimization (if needed), and try again. On Samsung devices, battery optimization may not need to be disabled.
Not always. While many guides recommend disabling it universally, community testing shows that Samsung devices often work fine with battery optimization enabled. Only disable it if you experience sync failures or sign-in loops after trying other fixes.
As of early 2026, the supported version is 20.14.43. This changes frequently. Check the ReVanced Patches documentation or use ReVanced Manager v2’s auto-downloader to fetch a compatible version.
Upstream microG is the open-source project by the microG Project Team for custom ROMs. ReVanced GmsCore is a downstream fork maintained by the ReVanced Team with a different package name and stripped components for compatibility with ReVanced patches.
Patching time depends on your device: flagships take 5–10 minutes, mid-tier devices 10–15 minutes, and low-tier devices 15–35 minutes. Ensure you have at least 2 GB free RAM and 1 GB free storage before starting.
If you are on a Xiaomi device running HyperOS 3.0.5.0 / Android 16, this is a known bug with the built-in downloader. Download the target APK manually via your browser and select it from Storage. Also verify you are not trying to use a .apks or .xapk bundle — only single .apk files work.
Conclusion
If you want to use ReVanced GmsCore for YouTube in 2026, you need ReVanced GmsCore — not the dead Vanced MicroG. By using the official ReVanced Manager v2, patching the GmsCore support patch, selecting the default patches for beginners, avoiding dangerous patches, and downloading GmsCore from the official ReVanced GitHub, you can restore personalized features like subscriptions, playlists, and watch history on any non-rooted Android device.
Always verify your sources. Never install pre-patched APKs from third-party sites, as they are a known vector for malware and account compromise. Stick to official release channels only.
Have a question about your specific setup? Drop your Android version, ReVanced Manager version, device model (especially if you are on Xiaomi/HyperOS), and whether you are on official ReVanced or ReVanced Extended in the comments, and we will help you troubleshoot.