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 |
|:--------:|:--------------:|:-----------------:|
| `bypass-ambient-mode-restrictions` | Bypass ambient mode restrictions in battery saver mode. | 18.17.43 |
| `change-homepage` | Change home page to subscription feed. | 18.17.43 |
| `custom-branding-icon-afn-blue` | Changes the YouTube launcher icon to Afn Blue. | 18.17.43 |
| `custom-branding-icon-afn-red` | Changes the YouTube launcher icon to Afn Red. | 18.17.43 |
| `custom-branding-icon-mmt` | Changes the YouTube launcher icon to MMT. | 18.17.43 |
| `custom-branding-icon-revancify-blue` | Changes the YouTube launcher icon to Revancify Blue. | 18.17.43 |
| `custom-branding-icon-revancify-red` | Changes the YouTube launcher icon to Revancify Red. | 18.17.43 |
| `custom-branding-name` | Changes the YouTube launcher name to your choice (defaults to ReVanced Extended). | 18.17.43 |
| `custom-double-tap-length` | Add 'double-tap to seek' value. | 18.17.43 |
| `custom-package-name` | Specifies the package name for YouTube and YT Music in the MicroG build. | all |
| `custom-seekbar-color` | Change seekbar color and progressbar color. | 18.17.43 |
| `custom-video-speed` | Adds more video speed options. | 18.17.43 |
| `default-video-quality` | Adds ability to set default video quality settings. | 18.17.43 |
| `default-video-speed` | Adds ability to set default video speed settings. | 18.17.43 |
| `disable-haptic-feedback` | Disable haptic feedback when swiping. | 18.17.43 |
| `disable-hdr-video` | Disable HDR video. | 18.17.43 |
| `disable-landscape-mode` | Disable landscape mode when entering fullscreen. | 18.17.43 |
| `disable-quic-protocol` | Disable CronetEngine's QUIC protocol. | 18.17.43 |
| `disable-startup-shorts-player` | Disables playing YouTube Shorts when launching YouTube. | 18.17.43 |
| `enable-external-browser` | Open url outside the app in an external browser. | 18.17.43 |
| `enable-minimized-playback` | Enables minimized and background playback. | 18.17.43 |
| `enable-old-quality-layout` | Enables the original quality flyout menu. | 18.17.43 |
| `enable-open-links-directly` | Skips over redirection URLs to external links. | 18.17.43 |
| `enable-seekbar-tapping` | Enables tap-to-seek on the seekbar of the video player. | 18.17.43 |
| `enable-tablet-miniplayer` | Enables the tablet mini player layout. | 18.17.43 |
| `enable-tablet-navigation-bar` | Enables the tablet navigation bar. | 18.17.43 |
| `enable-timestamps-speed` | Add the current video speed in brackets next to the current time. | 18.17.43 |
| `enable-wide-searchbar` | Replaces the search icon with a wide search bar. This will hide the YouTube logo when active. | 18.17.43 |
| `force-hide-player-button-background` | Force removes the background from the video player buttons. | 18.17.43 |
| `force-premium-heading` | Forces premium heading on the home screen. | 18.17.43 |
| `force-vp9-codec` | Forces the VP9 codec for videos. | 18.17.43 |
| `header-switch` | Add switch to change header. | 18.17.43 |
| `hide-account-menu` | Hide account menu elements. | 18.17.43 |
| `hide-auto-captions` | Hide captions from being automatically enabled. | 18.17.43 |
| `hide-auto-player-popup-panels` | Hide automatic popup panels (playlist or live chat) on video player. | 18.17.43 |
| `hide-autoplay-button` | Hides the autoplay button in the video player. | 18.17.43 |
| `hide-autoplay-preview` | Hides the autoplay preview container in the fullscreen. | 18.17.43 |
| `hide-breaking-news-shelf` | Hides the breaking news shelf on the homepage tab. | 18.17.43 |
| `hide-button-container` | Adds the options to hide action buttons under a video. | 18.17.43 |
| `hide-captions-button` | Hides the captions button in the video player. | 18.17.43 |
| `hide-cast-button` | Hides the cast button in the video player. | 18.17.43 |
| `hide-category-bar` | Hide the category bar at the top of the feed and at the top of related videos. | 18.17.43 |
| `hide-channel-avatar-section` | Hides the channel avatar section of the subscription feed. | 18.17.43 |
| `hide-channel-watermark` | Hides creator's watermarks on videos. | 18.17.43 |
| `hide-collapse-button` | Hides the collapse button in the video player. | 18.17.43 |
| `hide-comment-component` | Adds options to hide comment component under a video. | 18.17.43 |
| `hide-crowdfunding-box` | Hides the crowdfunding box between the player and video description. | 18.17.43 |
| `hide-double-tap-overlay-filter` | Remove the double tap dark filter layer. | 18.17.43 |
| `hide-email-address` | Hides the email address(handle) in the account switcher. | 18.17.43 |
| `hide-endscreen-cards` | Hides the suggested video cards at the end of a video in fullscreen. | 18.17.43 |
| `hide-endscreen-overlay` | Hide endscreen overlay on swipe controls. | 18.17.43 |
| `hide-filmstrip-overlay` | Hide flimstrip overlay on swipe controls. | 18.17.43 |
| `hide-floating-microphone` | Hide the floating microphone button above the keyboard. | 18.17.43 |
| `hide-flyout-panel` | Adds options to hide player settings flyout panel. | 18.17.43 |
| `hide-fullscreen-panels` | Hides video description and comments panel in fullscreen view. | 18.17.43 |
| `hide-general-ads` | Removes general ads. | 18.17.43 |
| `hide-info-cards` | Hides info-cards in videos. | 18.17.43 |
| `hide-live-chat-button` | Hides the live chat button in the video player (for old layout). | 18.17.43 |
| `hide-load-more-button` | Hides the button under videos that loads similar videos. | 18.17.43 |
| `hide-mix-playlists` | Removes mix playlists from home feed and video player. | 18.17.43 |
| `hide-music-button` | Hides the YouTube Music button in the video player. | 18.17.43 |
| `hide-navigation-buttons` | Adds options to hide or change navigation buttons. | 18.17.43 |
| `hide-navigation-label` | Hide navigation bar labels. | 18.17.43 |
| `hide-pip-notification` | Disable pip notification when you first launch pip mode. | 18.17.43 |
| `hide-player-button-background` | Hide player button background. | 18.17.43 |
| `hide-player-overlay-filter` | Remove the dark filter layer from the player's background. | 18.17.43 |
| `hide-previous-next-button` | Hides the previous and next button in the player controller. | 18.17.43 |
| `hide-quick-actions` | Adds the options to hide quick actions components in the fullscreen. | 18.17.43 |
| `hide-search-terms` | Hide trending searches and search history in the search bar. | 18.17.43 |
| `hide-seek-message` | Hides the 'Slide left or right to seek' message container. | 18.17.43 |
| `hide-seekbar` | Hides the seekbar and progressbar. | 18.17.43 |
| `hide-shorts-component` | Hides other Shorts components. | 18.17.43 |
| `hide-shorts-navbar` | Hide navigation bar when playing shorts. | 18.17.43 |
| `hide-snack-bar` | Hides the snack bar action popup. | 18.17.43 |
| `hide-stories` | Hides YouTube Stories shelf on the feed. | 18.17.43 |
| `hide-suggested-actions` | Hide the suggested actions bar inside the player. | 18.17.43 |
| `hide-time-stamp` | Hides timestamp in video player. | 18.17.43 |
| `hide-tooltip-content` | Hides the tooltip box that appears on first install. | 18.17.43 |
| `hide-video-ads` | Removes ads in the video player. | 18.17.43 |
| `layout-switch` | Tricks the dpi to use some tablet/phone layouts. | 18.17.43 |
| `materialyou` | Enables MaterialYou theme for Android 12+ | 18.17.43 |
| `microg-support` | Allows ReVanced to run without root and under a different package name with MicroG. | 18.17.43 |
| `optimize-resource` | Removes duplicate resources from YouTube. | 18.17.43 |
| `overlay-buttons` | Add overlay buttons to the player such as copy video link, auto-repeat, download and speed control. | 18.17.43 |
| `protobuf-spoof` | Spoofs the protobuf to prevent playback issues. | 18.17.43 |
| `return-youtube-dislike` | Shows the dislike count of videos using the Return YouTube Dislike API. | 18.17.43 |
| `settings` | Applies mandatory patches to implement ReVanced settings into the application. | 18.17.43 |
| `sponsorblock` | Integrates SponsorBlock which allows skipping video segments such as sponsored content. | 18.17.43 |
| `spoof-app-version` | Tricks YouTube into thinking, you are running an older version of the app. One of the side effects also includes restoring the old UI. | 18.17.43 |
| `swipe-controls` | Adds volume and brightness swipe controls. | 18.17.43 |
| `theme` | Applies a custom theme (default: amoled). | 18.17.43 |
| `translations` | Add Crowdin translations for YouTube. | 18.17.43 |
</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 |
|:--------:|:--------------:|:-----------------:|
| `amoled` | Applies pure black theme in flyout panels. | all |
| `background-play` | Enables playing music in the background. | all |
| `bitrate-default-value` | Set the audio quality to 'Always High' when you first install the app. | all |
| `certificate-spoof` | Spoofs the YouTube Music certificate for Android Auto. | all |
| `custom-branding-music-afn-blue` | Changes the YouTube Music launcher icon to Afn Blue. | all |
| `custom-branding-music-afn-red` | Changes the YouTube Music launcher icon to Afn Red. | all |
| `custom-branding-music-mmt` | Changes the YouTube Music launcher icon to MMT. | all |
| `custom-branding-music-name` | Changes the Music launcher name to your choice (defaults to YTM Extended, ReVanced Music Extended). | all |
| `custom-branding-music-revancify-blue` | Changes the YouTube Music launcher icon to Revancify Blue. | all |
| `custom-branding-music-revancify-red` | Changes the YouTube Music launcher icon to Revancify Red. | all |
| `custom-package-name` | Specifies the package name for YouTube and YT Music in the MicroG build. | 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-compact-dialog` | Enable compact dialog on phone. | 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-landscape-mode` | Enables entry into landscape mode by screen rotation on the phone. | all |
| `enable-opus-codec` | Enable opus codec when playing audio. | 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-button-shelf` | Hides the button shelf from homepage and explorer. | all |
| `hide-carousel-shelf` | Hides the carousel shelf from homepage and explorer. | all |
| `hide-category-bar` | 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-new-playlist-button` | Hide the New Playlist button in the Library tab. | 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` | Remove upgrade tab from pivot bar, hide upgrade banner from homepage. | all |
| `minimized-playback-music` | Enables minimized playback on Kids music. | all |
| `music-microg-support` | Allows ReVanced Music to run without root and under a different package name with MicroG. | all |
| `music-settings` | Adds settings for ReVanced to YouTube Music. | all |
| `optimize-resource-music` | Remove unnecessary resources. | all |
| `remember-video-quality` | Save the video quality value whenever you change the video quality. | all |
| `share-button-hook` | Replace share button with external download button or sleep timer dialog. | all |
| `spoof-app-version` | Spoof the YouTube Music client version. | all |
| `translations-music` | Add Crowdin translations for YouTube Music. | all |
</details>

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

| 💊 Patch | 📜 Description | 🏹 Target Version |
|:--------:|:--------------:|:-----------------:|
| `custom-branding-microg-name` | Changes the MicroG launcher name to your choice (defaults to MicroG). | all |
| `custom-branding-microg-revancify-blue` | Changes the MicroG launcher icon to Revancify Blue. | all |
| `custom-branding-microg-revancify-red` | Changes the MicroG launcher icon to Revancify Red. | all |
| `hide-icon-from-launcher` | Hide MicroG icon from launcher. | 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.12.35",
          "18.13.38",
          "18.14.41",
          "18.15.40",
          "18.16.39",
          "18.17.43"
        ]
      }
    ]
  }
]
```