Troubleshooting guide for Revanced
This is a guide on solving common issues when using ReVanced YT and ReVanced Manager. If you find something missing, open a new issue and I would add it.
No. You don't download an APK and install it. This is to prevent distribution of copyrighted materials. Instead you "make" it yourself. Checkout this guide by Hokora Yinphine MPP#6969 on discord or this guide by me or this guide for more detailed steps.
https://github.com/revanced/revanced-manager/releases/latest
https://github.com/ReVanced/GmsCore/releases/latest
19.43.41 as of 2025-02-10T08:40 UTC. You can check it in ReVanced manager
Nope.
If you can, donate to the ReVanced team at either:
If you can't donate, you can also contribute to the development by:
You can post your bug on Reddit first to confirm if this is indeed a bug and if anyone else has reported it. Or you can go to the ReVanced discord to ask there. The ReVanced development team regularly hangs out there. DO NOT POST YOUR SUPPORT REQUEST IN CHAT. Post them in ## general > support instead. Remember to add a tag. You can do so on the bottom left.
After that you can go to the relevant Github issues page to file a bug report.
-
Not enough storage space, check that you have ≥1GB to be on the safe side
-
Bad APK, download again
-
Signature mismatch, delete old manager and install (WARNING: this deletes keystore, you may want to export it first)
In ReVanced manager > patcher > select application, it tells you the latest supported / suggested YouTube version to patch
https://www.apkmirror.com/apk/google-inc/youtube/
Make sure you got the version marked APK and nodpi, not the one marked BUNDLE
This is a new feature from version 0.1.0. Go to ReVanced manager > settings > scroll down to import & export > export keystore
If you have an older version (≤0.0.57), you will need to go to Android/data/app.revanced.manager.flutter/files and get the keystore there.
This is a new feature from version 0.1.0. Go to ReVanced manager > settings > scroll down to import & export > import keystore
If you have an older version (≤0.0.57), you will need to go to Android/data/app.revanced.manager.flutter/files and dump your keystore there.
Delete existing ReVanced manager and install the new one. If you have manager version ≥0.1.0, follow the above steps on exporting the keystore. Then, install the new version and import the old keystore back in.
Delete existing ReVanced manager and install the new one. If you have manager version ≥0.1.0, follow the above steps on exporting the keystore. Then, install the new version and import the old keystore back in.
TL;DR: that is a known harmless bug, ignore it and don't update
Select GmsCore support patch in the patches selection screen. If you cannot find it, use the search function and search for "GmsCore". If you still cannot find it, you are using a non-supported YT version.
Your selected app version was incompatible. Use the Suggested version.
Select the default/recommended ones. When you are in the select patches window, you can click the "default" or "recommended" button on the top. You can review the defaults, but don't exclude patches that you don't know what it means. It is probably needed. Don't worry about functions that you may not like, you can disable them in-app later.
DO NOT SELECT ANY OF THE FOLLOWING PATCHES OR YOU WILL RISK HAVING ISSUES:
- Change package name
- enable android debugging
- export all activities
- Predictive back gesture
- Remove screenshot restriction
- Spoof wifi connections
If you don't know where to start but just want to remove some patches, you can safely remove these. I did not select the following patches:
- Disable auto captions
- Hide player overlay
- Hide seekbar
- Hide timestamp
- Wide search bar
Click the "Selected Patches" box
If you don't know what you should select, or want to use the same set of patches as mine, you can download the patches selection. !file Patches Selection.
Then go to ReVanced manager > settings > scroll down to import & export > Import patches selection. Select the downloaded JSON file just now. You now have the same set of patches mine.
If you see the text "exit code = 135" or "exit code = 139", then your devices architecture is not supported.
You are probably using ARMv7. ReVanced Manager has support for ARMv7 since v1.21.0. Update ReVanced Manager and try again.
If that doesn't work, you can patch on a computer with the revanced-cli (official), Taku's auto-cli (Very Easy) or revanced-builder.
Symptoms: after clicking "select an application" > "YouTube", nothing happened and it goes back to the patcher tab without selecting any apps
You probably are not using the stable version of ReVanced manager. Do the following to get it fixed:
- Follow section 2.4 to export the keystore
- Delete existing ReVanced manager
- Install the latest stable version of ReVanced manager here
- Follow section 2.5 to import the keystore
DO NOT SELECT ANY OF THE FOLLOWING PATCHES OR YOU WILL RISK HAVING ISSUES:
- Change package name
- enable android debugging
- export all activities
- Predictive back gesture
- Remove screenshot restriction
- Spoof wifi connections
Probably one of the following:
- split APK is used to patch
- patch again using the full APK
- non-recommended patches
- patch again with the default/recommended patches
- You exited ReVanced manager when patching
- Don't do that. Repatch again.
Include Spoof Video Streams patch and patch again. (spoof signature verification was merged into Spoof Video Streams)
If you cannot find them, you probably patched an unsupported YT version.
Probably one of the following reason
- Signature mismatch between existing ReVanced install
- Delete that existing install
- Google play protect blocked it
- when the play protect window popped up, click "learn more" and "install anyway"
- You exited ReVanced manager when patching
- Don't do that. Repatch again.
- Split APK used
- repatch with non-split APK / full apk
- Artifacts left from previous install / the uninstall was not done cleanly
- This could only happen if you have installed and uninstalled ReVanced previously
- You will need to use ADB to fully remove the old install.
- You can find a guide here
Try swiping up on the left side of your screen. This feature is called swipe brightness control. Swipe down all the way and it would use auto-brightness. You can also swipe to control volume on the right.
You can disable this under ReVanced YT settings > ReVanced > Interaction > Swipe Controls
Did you change your google password? Anyway, go to system settings > accounts > Google (blue icon with lowercase g) > delete/logout account. Don't worry, this will not remove your google account on your device, just remove the one used by GmsCore (hence ReVanced).
Disable: ReVanced YT settings > ReVanced > Layout > Hide Shorts, Hide Shorts button
Disable: ReVanced YT settings > ReVanced > Layout > Hide fullscreen panels
Disable: ReVanced YT settings > ReVanced > Layout > Hide cast button
Note that casting is currently broken. You need to use TV code to pair first
Disable: ReVanced YT settings > ReVanced > Layout > Hide caption button
Disable: ReVanced YT settings > ReVanced > Layout > Hide end screen cards
If that does not work, then it is caused by a side effect of spoofing signatures. For more information, see revanced-patches github issues #1752
Known issue. It would be fixed automatically when you watch the second video. If it still stays on the top, repatch and include the latest patches. Keep in mind that YouTubers can configure subtitle positions so it might be intended for the subtitles to be on the top.
ReVanced/revanced-patches#2003
Turn the function off and on again. Seriously, this fixed it.
Disable: ReVanced YT settings > ReVanced > Layout > Hide action buttons > All toggles listed
Disable: ReVanced YT settings > ReVanced > Layout > Hide action buttons > Hide all other action buttons
- Disable: ReVanced YT settings > ReVanced > Layout > Hide autoplay button
- Restart Youtube ReVanced
- Play any video, in the video player, turn off autoplay
- Enable: ReVanced YT settings > ReVanced > Layout > Hide autoplay button
- Restart Youtube ReVanced
It is probably in ReVanced YT settings > ReVanced > Layout. Scroll a bit and see if you can find it.
One is for copy the video URL, another one does the same but adds a timestamp, so people can click on that link and jump to that exact second.
You can disable one or both under ReVanced YT settings > ReVanced > Interactions > Copy video URL settings
Install it at https://github.com/TeamNewPipe/NewPipe/releases/latest
Or alternatively you can use Seal instead of newpipe. Go install Seal here, then change ReVanced > ReVanced settings > Interaction > Download settings > Downloader Package name to this:
com.junkfood.seal
Use the download button inside the video player
Casting to TV is different. ReVanced YT does not handle the video stream, it basically tells the TV: go and play that video with this link. So you will need a ad-free YouTube TV client. You can get one here. Note that SmartTubeNext is not developed and not affiliated in any way with the ReVanced team.
SponsorBlock is a community project. There might be no marked sponsors yet because
- The video was too new
- Nobody uploaded/marked any segments
Or it might also be that the SponsorBlock server is down. Wait a few minutes and try again. You can check the status at here.
Possible reasons include:
- Return Youtube Dislike server was down
- API timeout, try again later
3.25. Dislike button said hidden
The YouTuber opted-out from the Return Youtube Dislike project
ReVanced setting > SponsorBlock > scroll down > Change segment behabior > select category > skip automatically