ReVanced Troubleshooting Guide

🚨 "App Not Installed" Error

This is the most common installation error. Here are proven solutions:

Solution 1: Enable Unknown Sources

1. Go to Settings → Security → Unknown Sources
2. Enable "Install unknown apps" for your file manager
3. Try installing ReVanced again

Solution 2: Uninstall Original YouTube

1. Uninstall the official YouTube app
2. Clear any cached installation files
3. Restart your device
4. Install ReVanced APK

Solution 3: Check Package Name Conflicts

• Ensure no conflicting apps with same package name
• Uninstall any previous ReVanced versions
• Clear package installer cache

🔑 Login and Account Issues

Cannot Sign In to Google Account

1. Install MicroG First: MicroG must be installed before ReVanced
2. Clear MicroG Data: Settings → Apps → MicroG → Storage → Clear Data
3. Re-add Account: Open MicroG → Add Google account
4. Sign in to ReVanced: Use the same account in ReVanced

"Authentication Required" Error

• Ensure MicroG has all necessary permissions
• Check device registration in MicroG settings
• Try using a different Google account
• Update MicroG to latest version

💥 App Crashes and Freezing

ReVanced Keeps Crashing

1. Update to Compatible Version: Use supported YouTube version
2. Reduce Patches: Install with fewer patches enabled
3. Clear App Data: Settings → Apps → ReVanced → Storage → Clear Data
4. Reinstall Clean: Uninstall and reinstall without previous data

App Freezes During Playback

• Disable hardware acceleration in settings
• Lower default video quality
• Clear cache and restart app
• Check available storage space

🎵 Background Play Not Working

Quick Fixes

1. Check Settings: Ensure background play is enabled in ReVanced settings
2. Battery Optimization: Disable battery optimization for ReVanced
3. Auto-Start: Enable auto-start permission for ReVanced
4. Notification Access: Grant notification access permissions

Advanced Solutions

• Add ReVanced to battery whitelist
• Disable power saving mode
• Check if background app limits are applied
• Ensure MicroG is also whitelisted

🔧 MicroG Related Issues

MicroG Not Working Properly

1. Signature Verification: Disable signature verification if possible
2. Install Order: Always install MicroG before ReVanced
3. Permissions: Grant all requested permissions to MicroG
4. Device Registration: Ensure device is registered in MicroG

"MicroG Not Installed" Error

• Download MicroG from our official download page
• Install MicroG APK before installing ReVanced
• Verify MicroG installation in device settings
• Restart device after MicroG installation

📱 Device-Specific Issues

Samsung Devices

• Disable Samsung's app verification
• Use Samsung's file manager for installation
• Turn off "Scan device for security threats"
• Add ReVanced to Secure Folder if needed

Xiaomi/MIUI Devices

• Enable "Install via USB" in Developer Options
• Turn off MIUI Optimization temporarily
• Use MIUI's file manager for APK installation
• Disable "Verify apps over USB"

Huawei/EMUI Devices

• Enable installation from unknown sources
• Disable "External sources app check"
• Use HiSuite for APK management if needed
• Install MicroG manually without app store

🔄 Update and Version Issues

Cannot Update ReVanced

1. Uninstall current version completely
2. Download latest ReVanced APK
3. Install fresh copy (don't update over old version)
4. Restore settings from backup if available

Version Compatibility Problems

• Check supported YouTube version for current ReVanced build
• Use ReVanced Manager to build compatible version
• Avoid beta or experimental YouTube versions
• Match YouTube version with ReVanced patches

🌐 Network and Connectivity Issues

Videos Not Loading

• Check internet connection stability
• Clear DNS cache or use public DNS (8.8.8.8)
• Disable VPN temporarily to test
• Try different WiFi network or mobile data

Login Server Errors

• Ensure MicroG has internet access
• Check firewall/antivirus blocking connections
• Try logging in during off-peak hours
• Use mobile data instead of WiFi for initial setup

🛠️ General Troubleshooting Steps

Before Seeking Help, Try These:

1. Restart Device: Simple restart solves many issues
2. Clear Cache: Clear both ReVanced and MicroG cache
3. Check Storage: Ensure sufficient free storage space
4. Update Everything: Update MicroG, check for ReVanced updates
5. Clean Install: Uninstall completely and reinstall fresh
6. Check Permissions: Verify all app permissions are granted