revanced-patches-ex/README.md

## 🧩 Patches

The official Patch bundle provided by ReVanced and the community.

> Looking for the JSON variant of this? [Click here](patches.json).

### [📦 `com.google.android.youtube`](https://play.google.com/store/apps/details?id=com.google.android.youtube)
<details>

| 💊 Patch | 📜 Description | 🏹 Target Version |
|:--------:|:--------------:|:-----------------:|
| `client-spoof` | Spoofs the YouTube client to prevent playback issues. | 18.11.36 |
| `custom-branding-icon-afn-blue` | Changes the YouTube launcher icon (Afn / Blue). | 18.11.36 |
| `custom-branding-icon-afn-red` | Changes the YouTube launcher icon (Afn / Red). | 18.11.36 |
| `custom-branding-icon-mmt` | Changes the YouTube launcher icon (MMT). | 18.11.36 |
| `custom-branding-icon-revancify` | Changes the YouTube launcher icon (Revancify). | 18.11.36 |
| `custom-branding-name` | Changes the YouTube launcher name to your choice (defaults to ReVanced Extended). | 18.11.36 |
| `custom-seekbar-color` | Change seekbar color in dark mode. | 18.11.36 |
| `custom-video-speed` | Adds more video speed options. | 18.11.36 |
| `default-video-quality` | Adds ability to set default video quality settings. | 18.11.36 |
| `default-video-speed` | Adds ability to set default video speed settings. | 18.11.36 |
| `disable-haptic-feedback` | Disable haptic feedback when swiping. | 18.11.36 |
| `disable-quic-protocol` | Disable CronetEngine's QUIC protocol. | 18.11.36 |
| `enable-external-browser` | Open url outside the app in an external browser. | 18.11.36 |
| `enable-minimized-playback` | Enables minimized and background playback. | 18.11.36 |
| `enable-old-layout` | Spoof the YouTube client version to use the old layout. | 18.11.36 |
| `enable-old-quality-layout` | Enables the original quality flyout menu. | 18.11.36 |
| `enable-open-links-directly` | Skips over redirection URLs to external links. | 18.11.36 |
| `enable-seekbar-tapping` | Enables tap-to-seek on the seekbar of the video player. | 18.11.36 |
| `enable-tablet-miniplayer` | Enables the tablet mini player layout. | 18.11.36 |
| `enable-timestamps-speed` | Add the current video speed in brackets next to the current time. | 18.11.36 |
| `enable-wide-searchbar` | Replaces the search icon with a wide search bar. This will hide the YouTube logo when active. | 18.11.36 |
| `force-premium-heading` | Forces premium heading on the home screen. | 18.11.36 |
| `force-vp9-codec` | Forces the VP9 codec for videos. | 18.11.36 |
| `header-switch` | Add switch to change header. | 18.11.36 |
| `hide-account-menu` | Hide account menu elements. | 18.11.36 |
| `hide-auto-captions` | Hide captions from being automatically enabled. | 18.11.36 |
| `hide-auto-player-popup-panels` | Hide automatic popup panels (playlist or live chat) on video player. | 18.11.36 |
| `hide-autoplay-button` | Hides the autoplay button in the video player. | 18.11.36 |
| `hide-autoplay-preview` | Hides the autoplay preview container in the fullscreen. | 18.11.36 |
| `hide-button-container` | Adds the options to hide action buttons under a video. | 18.11.36 |
| `hide-captions-button` | Hides the captions button in the video player. | 18.11.36 |
| `hide-cast-button` | Hides the cast button in the video player. | 18.11.36 |
| `hide-channel-watermark` | Hides creator's watermarks on videos. | 18.11.36 |
| `hide-collapse-button` | Hides the collapse button in the video player. | 18.11.36 |
| `hide-comment-component` | Adds options to hide comment component under a video. | 18.11.36 |
| `hide-create-button` | Hides the create button in the navigation bar. | 18.11.36 |
| `hide-crowdfunding-box` | Hides the crowdfunding box between the player and video description. | 18.11.36 |
| `hide-email-address` | Hides the email address in the account switcher. | 18.11.36 |
| `hide-endscreen-cards` | Hides the suggested video cards at the end of a video in fullscreen. | 18.11.36 |
| `hide-endscreen-overlay` | Hide endscreen overlay on swipe controls. | 18.11.36 |
| `hide-filmstrip-overlay` | Hide flimstrip overlay on swipe controls. | 18.11.36 |
| `hide-floating-microphone` | Hide the floating microphone button above the keyboard. | 18.11.36 |
| `hide-flyout-panel` | Adds options to hide player settings flyout panel. | 18.11.36 |
| `hide-fullscreen-buttoncontainer` | Hides the button containers in fullscreen. | 18.11.36 |
| `hide-fullscreen-panels` | Hides video description and comments panel in fullscreen view. | 18.11.36 |
| `hide-general-ads` | Removes general ads. | 18.11.36 |
| `hide-info-cards` | Hides info-cards in videos. | 18.11.36 |
| `hide-live-chat-button` | Hides the live chat button in the video player. | 18.11.36 |
| `hide-mix-playlists` | Removes mix playlists from home feed and video player. | 18.11.36 |
| `hide-music-button` | Hides the YouTube Music button in the video player. | 18.11.36 |
| `hide-next-prev-button` | Hides the next prev button in the player controller. | 18.11.36 |
| `hide-pip-notification` | Disable pip notification when you first launch pip mode. | 18.11.36 |
| `hide-player-button-background` | Hide player button background. | 18.11.36 |
| `hide-player-overlay-filter` | Remove the dark filter layer from the player's background. | 18.11.36 |
| `hide-seekbar` | Hides the seekbar. | 18.11.36 |
| `hide-shorts-button` | Hides the shorts button in the navigation bar. | 18.11.36 |
| `hide-shorts-component` | Hides other Shorts components. | 18.11.36 |
| `hide-shorts-pivot-bar` | Hides the pivotbar when playing shorts. | 18.11.36 |
| `hide-snackbar` | Hides the snackbar action popup. | 18.11.36 |
| `hide-startup-shorts-player` | Disables playing YouTube Shorts when launching YouTube. | 18.11.36 |
| `hide-stories` | Hides YouTube Stories shelf on the feed. | 18.11.36 |
| `hide-suggested-actions` | Hide the suggested actions bar inside the player. | 18.11.36 |
| `hide-time-stamp` | Hides the time counter above the seekbar. | 18.11.36 |
| `hide-tooltip-content` | Hides the tooltip box that appears on first install. | 18.11.36 |
| `hide-video-ads` | Removes ads in the video player. | 18.11.36 |
| `layout-switch` | Tricks the dpi to use some tablet/phone layouts. | 18.11.36 |
| `lift-vertical-video-restriction` | Lift 4K resolution restrictions on vertical video. | 18.11.36 |
| `materialyou` | Enables MaterialYou theme for Android 12+ | 18.11.36 |
| `microg-support` | Allows YouTube ReVanced to run without root and under a different package name with Vanced MicroG. | 18.11.36 |
| `optimize-resource` | Removes duplicate resources from YouTube. | 18.11.36 |
| `overlay-buttons` | Add overlay buttons for ReVanced Extended. | 18.11.36 |
| `patch-options` | Create an options.toml file. | all |
| `protobuf-spoof` | Spoofs the protobuf to prevent playback issues. | 18.11.36 |
| `return-youtube-dislike` | Shows the dislike count of videos using the Return YouTube Dislike API. | 18.11.36 |
| `settings` | Applies mandatory patches to implement ReVanced settings into the application. | 18.11.36 |
| `sponsorblock` | Integrates SponsorBlock which allows skipping video segments such as sponsored content. | 18.11.36 |
| `swipe-controls` | Adds volume and brightness swipe controls. | 18.11.36 |
| `switch-create-notification` | Switching the create button and notification button. | 18.11.36 |
| `theme` | Applies a custom theme (default: amoled). | 18.11.36 |
| `translations` | Add Crowdin translations for YouTube. | 18.11.36 |
</details>

### [📦 `com.google.android.apps.youtube.music`](https://play.google.com/store/apps/details?id=com.google.android.apps.youtube.music)
<details>

| 💊 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-afn-blue` | Changes the YouTube Music launcher icon (Afn / Blue). | all |
| `custom-branding-music-afn-red` | Changes the YouTube Music launcher icon (Afn / Red). | all |
| `custom-branding-music-mmt` | Changes the YouTube Music launcher icon to your choice (MMT). | all |
| `custom-branding-music-revancify` | Changes the YouTube Music launcher icon to your choice (Revancify). | all |
| `disable-auto-captions` | Disable forced captions from automatically enabling in video player. | 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-playlist-card` | Hides the playlist card from homepage. | 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 |
| `patch-options` | Create an options.toml file. | all |
| `translations-music` | Add Crowdin translations for YouTube Music. | all |
</details>



## 📝 JSON Format

This section explains the JSON format for the [patches.json](patches.json) file.

Example:

```json
[
  {
    "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": [
          "18.06.41",
          "18.07.35",
          "18.08.39",
          "18.09.39",
          "18.10.37",
          "18.11.36"
        ]
      }
    ]
  }
]
```