🧩 Patches

The official Patch bundle provided by ReVanced and the community.

Looking for the JSON variant of this? Click here.

📦 com.google.android.youtube

💊 Patch	📜 Description	🏹 Target Version
client-spoof	Spoofs the YouTube client to prevent playback issues.	17.49.37
custom-branding-icon-afn-blue	Changes the YouTube launcher icon (Afn / Blue).	17.49.37
custom-branding-icon-afn-red	Changes the YouTube launcher icon (Afn / Red).	17.49.37
custom-branding-icon-revancify	Changes the YouTube launcher icon (Revancify).	17.49.37
custom-branding-name	Changes the YouTube launcher name to your choice (defaults to ReVanced Extended).	17.49.37
custom-video-buffer	Lets you change the buffers of videos.	17.49.37
custom-video-speed	Adds more video speed options.	17.49.37
default-video-quality	Adds ability to set default video quality settings.	17.49.37
default-video-speed	Adds ability to set default video speed settings.	17.49.37
disable-haptic-feedback	Disable haptic feedback when swiping.	17.49.37
enable-external-browser	Use an external browser to open the url.	17.49.37
enable-hdr-auto-brightness	Makes the brightness of HDR videos follow the system default.	17.49.37
enable-minimized-playback	Enables minimized and background playback.	17.49.37
enable-old-layout	Spoof the YouTube client version to use the old layout.	17.49.37
enable-old-quality-layout	Enables the original quality flyout menu.	17.49.37
enable-old-seekbar-color	Enable old seekbar color in dark mode.	17.49.37
enable-open-links-directly	Bypass URL redirects (youtube.com/redirect) when opening links in video descriptions.	17.49.37
enable-seekbar-tapping	Enables tap-to-seek on the seekbar of the video player.	17.49.37
enable-tablet-miniplayer	Enables the tablet mini player layout.	17.49.37
enable-wide-searchbar	Replaces the search icon with a wide search bar. This will hide the YouTube logo when active.	17.49.37
force-premium-heading	Forces premium heading on the home screen.	17.49.37
header-switch	Add switch to change header.	17.49.37
hide-auto-captions	Hide captions from being automatically enabled.	17.49.37
hide-auto-player-popup-panels	Hide automatic popup panels (playlist or live chat) on video player.	17.49.37
hide-autoplay-button	Hides the autoplay button in the video player.	17.49.37
hide-button-container	Adds options to hide action buttons under a video.	17.49.37
hide-cast-button	Hides the cast button in the video player.	17.49.37
hide-channel-watermark	Hides creator's watermarks on videos.	17.49.37
hide-comment-component	Adds options to hide comment component under a video.	17.49.37
hide-create-button	Hides the create button in the navigation bar.	17.49.37
hide-crowdfunding-box	Hides the crowdfunding box between the player and video description.	17.49.37
hide-email-address	Hides the email address in the account switcher.	17.49.37
hide-endscreen-cards	Hides the suggested video cards at the end of a video in fullscreen.	17.49.37
hide-endscreen-overlay	Hide endscreen overlay on swipe controls.	17.49.37
hide-filmstrip-overlay	Hide flimstrip overlay on swipe controls.	17.49.37
hide-flyout-panel	Adds options to hide player settings flyout panel.	17.49.37
hide-fullscreen-buttoncontainer	Hides the button containers in fullscreen.	17.49.37
hide-general-ads	Hooks the method which parses the bytes into a ComponentContext to filter components.	17.49.37
hide-info-cards	Hides info-cards in videos.	17.49.37
hide-mix-playlists	Removes mix playlists from home feed and video player.	17.49.37
hide-pip-notification	Disable pip notification when you first launch pip mode.	17.49.37
hide-player-captions-button	Hides the captions button in the video player.	17.49.37
hide-player-overlay-filter	Hide the suggested actions bar inside the player.	17.49.37
hide-shorts-button	Hides the shorts button in the navigation bar.	17.49.37
hide-shorts-component	Hides other Shorts components.	17.49.37
hide-startup-shorts-player	Disables playing YouTube Shorts when launching YouTube.	17.49.37
hide-stories	Hides YouTube Stories shelf on the feed.	17.49.37
hide-suggested-actions	Hide the suggested actions bar inside the player.	17.49.37
hide-time-and-seekbar	Hides progress bar and time counter on videos.	17.49.37
hide-video-ads	Removes ads in the video player.	17.49.37
layout-switch	Tricks the dpi to use some tablet/phone layouts.	17.49.37
materialyou	Enables MaterialYou theme for Android 12+	17.49.37
microg-support	Allows YouTube ReVanced to run without root and under a different package name with Vanced MicroG.	17.49.37
optimize-resource	Removes duplicate resources and adds missing translation files from YouTube.	17.49.37
overlay-buttons	Add overlay buttons for ReVanced Extended.	17.49.37
remove-player-button-background	Removes the background from the video player buttons.	17.49.37
return-youtube-dislike	Shows the dislike count of videos using the Return YouTube Dislike API.	17.49.37
settings	Applies mandatory patches to implement ReVanced settings into the application.	17.49.37
sponsorblock	Integrate SponsorBlock.	17.49.37
swipe-controls	Adds volume and brightness swipe controls.	17.49.37
theme	Applies a custom theme (default: amoled).	17.49.37
translations	Add Crowdin Translations	17.49.37

📦 com.google.android.apps.youtube.music

💊 Patch	📜 Description	🏹 Target Version
background-play	Enables playing music in the background.	all
client-spoof-music	Spoofs the YouTube Music client.	all
custom-branding-music-red	Changes the YouTube Music launcher icon to your choice (defaults to ReVanced Red).	all
custom-branding-music-revancify	Changes the YouTube Music launcher icon to your choice (Revancify).	all
enable-black-navbar	Sets the navigation bar color to black.	all
enable-color-match-player	Matches the fullscreen player color with the minimized one.	all
enable-force-minimized-player	Permanently keep player minimized even if another track is played.	all
enable-force-shuffle	Enable force shuffle even if another track is played.	all
enable-opus-codec	Enable opus codec when playing audio.	all
enable-tablet-mode	Enable landscape mode on phone.	all
enable-zen-mode	Adds a grey tint to the video player to reduce eye strain.	all
exclusive-audio-playback	Enables the option to play music without video.	all
hide-compact-header	Hides the music category bar at the top of the homepage.	all
hide-get-premium	Removes all "Get Premium" evidences from the avatar menu.	all
hide-music-ads	Removes ads in the music player.	all
hide-music-cast-button	Hides the cast button in the video player and header	all
hide-taste-builder	Removes the "Tell us which artists you like" card from the home screen.	all
hide-upgrade-button	Removes the upgrade tab from the pivot bar.	all
minimized-playback-music	Enables minimized playback on Kids music.	all
music-microg-support	Allows YouTube Music ReVanced to run without root and under a different package name.	all
music-settings	Adds settings for ReVanced to YouTube Music.	all
optimize-resource-music	Remove unnecessary resources.	all
translations-music	Add Crowdin Translations for YouTube Music	all

📝 JSON Format

This section explains the JSON format for the patches.json file.

The file contains an array of objects, each object representing a patch. The object contains the following properties:

key	description
name	The name of the patch.
description	The description of the patch.
version	The version of the patch.
excluded	Whether the patch is excluded by default. If true, the patch must never be included by default.
options	An array of options for this patch.
options.key	The key of the option.
options.title	The title of the option.
options.description	The description of the option.
options.required	Whether the option is required.
options.choices?	An array of choices of the option. This may be null if this option has no choices. The element type of this array may be any type. It can be a String, Int or something else.
dependencies	An array of dependencies, which are patch names.
compatiblePackages	An array of packages compatible with this patch.
compatiblePackages.name	The name of the package.
compatiblePackages.versions	An array of versions of the package compatible with this patch. If empty, all versions are seemingly compatible.

Example:

[
  {
    "name": "remember-video-quality",
    "description": "Adds the ability to remember the video quality you chose in the video quality flyout.",
    "version": "0.0.1",
    "excluded": false,
    "options": [],
    "dependencies": [
      "integrations",
      "video-id-hook"
    ],
    "compatiblePackages": [
      {
        "name": "com.google.android.youtube",
        "versions": [
          "17.49.37"
        ]
      }
    ]
  }
]