revanced-patches-ex/README.md

## 🧩 ReVanced Patches

ReVanced Extended Patches.

## 📋 List of patches in this repository

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

| 💊 Patch | 📜 Description | 🏹 Target Version |
|:--------:|:--------------:|:-----------------:|
| `Add splash animation` | Adds splash animation, which was removed in YT v18.19.36+. This patch cannot be used with 'custom-branding-icon' patch | 18.22.37 ~ 18.33.40 |
| `Alternative thumbnails` | Adds an option to replace video thumbnails with still image captures of the video. | 18.22.37 ~ 18.33.40 |
| `Append time stamps information` | Add the current video quality or playback speed in brackets next to the current time. | 18.22.37 ~ 18.33.40 |
| `Bypass ambient mode restrictions` | Bypass ambient mode restrictions in battery saver mode. | 18.22.37 ~ 18.33.40 |
| `Change homepage` | Change home page to subscription feed. | 18.22.37 ~ 18.33.40 |
| `Custom branding YouTube name` | Rename the YouTube app to the name specified in options.json. | 18.22.37 ~ 18.33.40 |
| `Custom branding icon MMT` | Changes the YouTube launcher icon to MMT. | 18.22.37 ~ 18.33.40 |
| `Custom branding icon Revancify blue` | Changes the YouTube launcher icon to Revancify Blue. | 18.22.37 ~ 18.33.40 |
| `Custom branding icon Revancify red` | Changes the YouTube launcher icon to Revancify Red. | 18.22.37 ~ 18.33.40 |
| `Custom double tap length` | Add 'double-tap to seek' value. | 18.22.37 ~ 18.33.40 |
| `Custom package name` | Specifies the package name for YouTube and YT Music in the MicroG build. | all |
| `Custom playback speed` | Adds more playback speed options. | 18.22.37 ~ 18.33.40 |
| `Custom seekbar color` | Change seekbar color in video player and video thumbnails. | 18.22.37 ~ 18.33.40 |
| `Custom speed overlay` | Customize 'Play at 2x speed' while holding down. | 18.22.37 ~ 18.33.40 |
| `Default playback speed` | Adds ability to set default playback speed settings. | 18.22.37 ~ 18.33.40 |
| `Default video quality` | Adds ability to set default video quality settings. | 18.22.37 ~ 18.33.40 |
| `Disable QUIC protocol` | Disable CronetEngine's QUIC protocol. | 18.22.37 ~ 18.33.40 |
| `Disable Shorts on startup` | Disables playing YouTube Shorts when launching YouTube. | 18.22.37 ~ 18.33.40 |
| `Disable auto captions` | Disables forced auto captions. | 18.22.37 ~ 18.33.40 |
| `Disable haptic feedback` | Disable haptic feedback when swiping. | 18.22.37 ~ 18.33.40 |
| `Disable hdr video` | Disable HDR video. | 18.22.37 ~ 18.33.40 |
| `Disable landscape mode` | Disable landscape mode when entering fullscreen. | 18.22.37 ~ 18.33.40 |
| `Disable pip notification` | Disable pip notification when you first launch pip mode. | 18.22.37 ~ 18.33.40 |
| `Enable compact controls overlay` | Enables compact control overlay. | 18.22.37 ~ 18.33.40 |
| `Enable debug logging` | Adds debugging options. | 18.22.37 ~ 18.33.40 |
| `Enable external browser` | Open url outside the app in an external browser. | 18.22.37 ~ 18.33.40 |
| `Enable minimized playback` | Enables minimized and background playback. | 18.22.37 ~ 18.33.40 |
| `Enable new comment popup panels` | Enables a new type of comment popup panel in the shorts player. | 18.22.37 ~ 18.33.40 |
| `Enable new splash animation` | Enables a new type of splash animation. | 18.22.37 ~ 18.33.40 |
| `Enable new thumbnail preview` | Enables a new type of thumbnail preview. | 18.22.37 ~ 18.33.40 |
| `Enable old quality layout` | Enables the original quality flyout menu. | 18.22.37 ~ 18.33.40 |
| `Enable open links directly` | Skips over redirection URLs to external links. | 18.22.37 ~ 18.33.40 |
| `Enable seekbar tapping` | Enables tap-to-seek on the seekbar of the video player. | 18.22.37 ~ 18.33.40 |
| `Enable tablet mini player` | Enables the tablet mini player layout. | 18.22.37 ~ 18.33.40 |
| `Enable tablet navigation bar` | Enables the tablet navigation bar. | 18.22.37 ~ 18.33.40 |
| `Enable wide search bar` | Replaces the search icon with a wide search bar. This will hide the YouTube logo when active. | 18.22.37 ~ 18.33.40 |
| `Force OPUS codec` | Forces the OPUS codec for audios. | 18.22.37 ~ 18.33.40 |
| `Force VP9 codec` | Forces the VP9 codec for videos. | 18.22.37 ~ 18.33.40 |
| `Force hide player button background` | Force hides the background from the video player buttons. | 18.22.37 ~ 18.33.40 |
| `Force premium heading` | Forces premium heading on the homepage. | 18.22.37 ~ 18.33.40 |
| `Header switch` | Add switch to change header. | 18.22.37 ~ 18.33.40 |
| `Hide account menu` | Hide account menu elements. | 18.22.37 ~ 18.33.40 |
| `Hide auto player popup panels` | Hide automatic popup panels (playlist or live chat) on video player. | 18.22.37 ~ 18.33.40 |
| `Hide autoplay button` | Hides the autoplay button in the video player. | 18.22.37 ~ 18.33.40 |
| `Hide autoplay preview` | Hides the autoplay preview container in the fullscreen. | 18.22.37 ~ 18.33.40 |
| `Hide button container` | Adds the options to hide action buttons under a video. | 18.22.37 ~ 18.33.40 |
| `Hide captions button` | Hides the captions button in the video player. | 18.22.37 ~ 18.33.40 |
| `Hide cast button` | Hides the cast button in the video player. | 18.22.37 ~ 18.33.40 |
| `Hide category bar` | Hides the category bar in feeds. | 18.22.37 ~ 18.33.40 |
| `Hide channel avatar section` | Hides the channel avatar section of the subscription feed. | 18.22.37 ~ 18.33.40 |
| `Hide channel watermark` | Hides creator's watermarks on videos. | 18.22.37 ~ 18.33.40 |
| `Hide collapse button` | Hides the collapse button in the video player. | 18.22.37 ~ 18.33.40 |
| `Hide comment component` | Hides components related to comments. | 18.22.37 ~ 18.33.40 |
| `Hide crowdfunding box` | Hides the crowdfunding box between the player and video description. | 18.22.37 ~ 18.33.40 |
| `Hide description components` | Hides description components. | 18.22.37 ~ 18.33.40 |
| `Hide double tap overlay filter` | Hides the double tap dark filter layer. | 18.22.37 ~ 18.33.40 |
| `Hide end screen cards` | Hides the suggested video cards at the end of a video in fullscreen. | 18.22.37 ~ 18.33.40 |
| `Hide end screen overlay` | Hide end screen overlay on swipe controls. | 18.22.37 ~ 18.33.40 |
| `Hide feed flyout panel` | Hides feed flyout panel components. | 18.22.37 ~ 18.33.40 |
| `Hide filmstrip overlay` | Hide filmstrip overlay on swipe controls. | 18.22.37 ~ 18.33.40 |
| `Hide floating microphone` | Hides the floating microphone button which appears in search. | 18.22.37 ~ 18.33.40 |
| `Hide fullscreen panels` | Hides video description and comments panel in fullscreen view. | 18.22.37 ~ 18.33.40 |
| `Hide general ads` | Hides general ads. | 18.22.37 ~ 18.33.40 |
| `Hide handle` | Hides the handle in the account switcher. | 18.22.37 ~ 18.33.40 |
| `Hide info cards` | Hides info-cards in videos. | 18.22.37 ~ 18.33.40 |
| `Hide latest videos button` | Hides latest videos button in home feed. | 18.22.37 ~ 18.33.40 |
| `Hide layout components` | Hides general layout components. | 18.22.37 ~ 18.33.40 |
| `Hide load more button` | Hides the button under videos that loads similar videos. | 18.22.37 ~ 18.33.40 |
| `Hide mix playlists` | Hides mix playlists in feed. | 18.22.37 ~ 18.33.40 |
| `Hide music button` | Hides the YouTube Music button in the video player. | 18.22.37 ~ 18.33.40 |
| `Hide navigation buttons` | Adds options to hide or change navigation buttons. | 18.22.37 ~ 18.33.40 |
| `Hide navigation label` | Hide navigation bar labels. | 18.22.37 ~ 18.33.40 |
| `Hide player button background` | Hide player button background. | 18.22.37 ~ 18.33.40 |
| `Hide player flyout panel` | Hides player flyout panel components. | 18.22.37 ~ 18.33.40 |
| `Hide player overlay filter` | Hides the dark filter layer from the player's background. | 18.22.37 ~ 18.33.40 |
| `Hide previous next button` | Hides the previous and next button in the player controller. | 18.22.37 ~ 18.33.40 |
| `Hide quick actions` | Adds the options to hide quick actions components in the fullscreen. | 18.22.37 ~ 18.33.40 |
| `Hide seek message` | Hides the 'Slide left or right to seek' message container. | 18.22.37 ~ 18.33.40 |
| `Hide seekbar` | Hides the seekbar in video player and video thumbnails. | 18.22.37 ~ 18.33.40 |
| `Hide shorts components` | Hides other Shorts components. | 18.22.37 ~ 18.33.40 |
| `Hide snack bar` | Hides the snack bar action popup. | 18.22.37 ~ 18.33.40 |
| `Hide suggested actions` | Hide the suggested actions bar inside the player. | 18.22.37 ~ 18.33.40 |
| `Hide suggested video overlay` | Hide the suggested video overlay to play next. | 18.22.37 ~ 18.33.40 |
| `Hide suggestions shelf` | Hides the suggestions shelf. | 18.22.37 ~ 18.33.40 |
| `Hide time stamp` | Hides timestamp in video player. | 18.22.37 ~ 18.33.40 |
| `Hide tooltip content` | Hides the tooltip box that appears on first install. | 18.22.37 ~ 18.33.40 |
| `Hide trending searches` | Hide trending searches in the search bar. | 18.22.37 ~ 18.33.40 |
| `Hide video ads` | Hides ads in the video player. | 18.22.37 ~ 18.33.40 |
| `Language switch` | Add language switch toggle. | 18.22.37 ~ 18.33.40 |
| `Layout switch` | Tricks the dpi to use some tablet/phone layouts. | 18.22.37 ~ 18.33.40 |
| `MaterialYou` | Enables MaterialYou theme for Android 12+ | 18.22.37 ~ 18.33.40 |
| `MicroG support` | Allows ReVanced Extended to run without root and under a different package name with MicroG. | 18.22.37 ~ 18.33.40 |
| `Overlay buttons` | Add overlay buttons to the player. | 18.22.37 ~ 18.33.40 |
| `Return YouTube Dislike` | Shows the dislike count of videos using the Return YouTube Dislike API. | 18.22.37 ~ 18.33.40 |
| `Settings` | Applies mandatory patches to implement ReVanced Extended settings into the application. | 18.22.37 ~ 18.33.40 |
| `SponsorBlock` | Integrates SponsorBlock which allows skipping video segments such as sponsored content. | 18.22.37 ~ 18.33.40 |
| `Spoof app version` | Spoof the YouTube client version. | 18.22.37 ~ 18.33.40 |
| `Spoof player parameters` | Spoofs player parameters to prevent playback issues. | 18.22.37 ~ 18.33.40 |
| `Swipe controls` | Adds volume and brightness swipe controls. | 18.22.37 ~ 18.33.40 |
| `Theme` | Change the app's theme to the values specified in options.json. | 18.22.37 ~ 18.33.40 |
| `Translations` | Add Crowdin translations for YouTube. | 18.22.37 ~ 18.33.40 |
</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 on some components. | 6.15.52 ~ 6.22.51 |
| `Background play` | Enables playing music in the background. | 6.15.52 ~ 6.22.51 |
| `Bitrate default value` | Set the audio quality to "Always High" when you first install the app. | 6.15.52 ~ 6.22.51 |
| `Certificate spoof` | Spoofs the YouTube Music certificate for Android Auto. | 6.15.52 ~ 6.22.51 |
| `Custom branding Music name` | Rename the YouTube Music app to the name specified in options.json. | 6.15.52 ~ 6.22.51 |
| `Custom branding icon MMT` | Changes the YouTube Music launcher icon to MMT. | 6.15.52 ~ 6.22.51 |
| `Custom branding icon Revancify blue` | Changes the YouTube Music launcher icon to Revancify Blue. | 6.15.52 ~ 6.22.51 |
| `Custom branding icon Revancify red` | Changes the YouTube Music launcher icon to Revancify Red. | 6.15.52 ~ 6.22.51 |
| `Custom package name` | Specifies the package name for YouTube and YT Music in the MicroG build. | all |
| `Custom playback speed` | Adds more playback speed options. | 6.15.52 ~ 6.22.51 |
| `Disable auto captions` | Disables forced auto captions. | 6.15.52 ~ 6.22.51 |
| `Enable black navigation bar` | Sets the navigation bar color to black. | 6.15.52 ~ 6.22.51 |
| `Enable color match player` | Matches the color of the mini player and the fullscreen player. | 6.15.52 ~ 6.22.51 |
| `Enable compact dialog` | Enable compact dialog on phone. | 6.15.52 ~ 6.22.51 |
| `Enable custom filter` | Enables custom filter to hide layout components. | 6.15.52 ~ 6.22.51 |
| `Enable debug logging` | Adds debugging options. | 6.15.52 ~ 6.22.51 |
| `Enable force minimized player` | Keep player permanently minimized even if another track is played. | 6.15.52 ~ 6.22.51 |
| `Enable landscape mode` | Enables entry into landscape mode by screen rotation on the phone. | 6.15.52 ~ 6.22.51 |
| `Enable minimized playback` | Enables minimized playback on Kids music. | 6.15.52 ~ 6.22.51 |
| `Enable new layout` | Enable new player layouts. | 6.15.52 ~ 6.22.51 |
| `Enable old style library shelf` | Return the library shelf to old style. | 6.15.52 ~ 6.22.51 |
| `Enable old style miniplayer` | Return the miniplayers to old style. | 6.15.52 ~ 6.22.51 |
| `Enable opus codec` | Enable opus codec when playing audio. | 6.15.52 ~ 6.22.51 |
| `Enable playback speed` | Add playback speed button to the flyout panel. | 6.15.52 ~ 6.22.51 |
| `Enable sleep timer` | Add sleep timer to flyout menu. | 6.15.52 ~ 6.22.51 |
| `Enable zen mode` | Adds a grey tint to the video player to reduce eye strain. | 6.15.52 ~ 6.22.51 |
| `Exclusive audio playback` | Enables the option to play music without video. | 6.15.52 ~ 6.22.51 |
| `Hide account menu` | Hide account menu elements. | 6.15.52 ~ 6.22.51 |
| `Hide action bar label` | Hide labels in action bar. | 6.15.52 ~ 6.22.51 |
| `Hide button shelf` | Hides the button shelf from homepage and explorer. | 6.15.52 ~ 6.22.51 |
| `Hide carousel shelf` | Hides the carousel shelf from homepage and explorer. | 6.15.52 ~ 6.22.51 |
| `Hide cast button` | Hides the cast button. | 6.15.52 ~ 6.22.51 |
| `Hide category bar` | Hides the music category bar at the top of the homepage. | 6.15.52 ~ 6.22.51 |
| `Hide channel guidelines` | Hides channel guidelines at the top of comments. | 6.15.52 ~ 6.22.51 |
| `Hide emoji picker` | Hides emoji picker at the comments box. | 6.15.52 ~ 6.22.51 |
| `Hide flyout panel` | Hides flyout panel components. | 6.15.52 ~ 6.22.51 |
| `Hide get premium` | Hides "Get Premium" label from the account menu or settings. | 6.15.52 ~ 6.22.51 |
| `Hide handle` | Hides the handle in the account switcher. | 6.15.52 ~ 6.22.51 |
| `Hide music ads` | Hides ads before playing a music. | 6.15.52 ~ 6.22.51 |
| `Hide navigation bar component` | Hides navigation bar components. | 6.15.52 ~ 6.22.51 |
| `Hide new playlist button` | Hides the "New playlist" button in the library. | 6.15.52 ~ 6.22.51 |
| `Hide playlist card` | Hides the playlist card from homepage. | 6.15.52 ~ 6.22.51 |
| `Hide radio button` | Hides start radio button. | 6.15.52 ~ 6.22.51 |
| `Hide taste builder` | Hides the "Tell us which artists you like" card from homepage. | 6.15.52 ~ 6.22.51 |
| `Hide terms container` | Hides terms of service container at the account menu. | 6.15.52 ~ 6.22.51 |
| `Hide tooltip content` | Hides the tooltip box that appears on first install. | 6.15.52 ~ 6.22.51 |
| `Hook download button` | Replaces the offline download button with an external download button. | 6.15.52 ~ 6.22.51 |
| `MicroG support` | Allows ReVanced Extended Music to run without root and under a different package name with MicroG. | 6.15.52 ~ 6.22.51 |
| `Remember playback speed` | Save the playback speed value whenever you change the playback speed. | 6.15.52 ~ 6.22.51 |
| `Remember repeat state` | Remembers the state of the repeat. | 6.15.52 ~ 6.22.51 |
| `Remember shuffle state` | Remembers the state of the shuffle. | 6.15.52 ~ 6.22.51 |
| `Remember video quality` | Save the video quality value whenever you change the video quality. | 6.15.52 ~ 6.22.51 |
| `Replace cast button` | Replace the cast button in the player with the open music button. | 6.15.52 ~ 6.22.51 |
| `Replace dismiss queue` | Replace dismiss queue menu to watch on YouTube. | 6.15.52 ~ 6.22.51 |
| `Return YouTube Dislike` | Shows the dislike count of videos using the Return YouTube Dislike API. | 6.15.52 ~ 6.22.51 |
| `Settings` | Adds settings for ReVanced Extended to YouTube Music. | 6.15.52 ~ 6.22.51 |
| `SponsorBlock` | Integrates SponsorBlock which allows skipping video segments such as sponsored content. | 6.15.52 ~ 6.22.51 |
| `Spoof app version` | Spoof the YouTube Music client version. | 6.15.52 ~ 6.22.51 |
| `Start page` | Set the default start page. | 6.15.52 ~ 6.22.51 |
| `Translations` | Add Crowdin translations for YouTube Music. | 6.15.52 ~ 6.22.51 |
</details>

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

| 💊 Patch | 📜 Description | 🏹 Target Version |
|:--------:|:--------------:|:-----------------:|
| `Disable screenshot popup` | Disables the popup that shows up when taking a screenshot. | all |
| `Hide ads` | Hides ads from the Reddit. | all |
| `Hide navigation buttons` | Hide buttons at navigation bar. | all |
| `Hide place button` | Hide r/place button in toolbar. | all |
| `Open links directly` | Skips over redirection URLs to external links. | all |
| `Open links externally` | Open links outside of the app directly in your browser. | all |
| `Premium icon` | Unlocks premium icons. | all |
| `Sanitize sharing links` | Removes (tracking) query parameters from the URLs when sharing links. | all |
| `Settings` | Adds ReVanced settings to Reddit. | all |
</details>



## 📝 JSON Format

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

Example:

```json
[
  {
    "name": "Default video quality",
    "description": "Adds ability to set default video quality settings.",
    "compatiblePackages":[
      {
        "name":"com.google.android.youtube",
        "versions":[
          "18.22.37",
          "18.23.36",
          "18.24.37",
          "18.25.40",
          "18.27.36",
          "18.29.38",
          "18.30.37",
          "18.31.40",
          "18.32.39",
          "18.33.40"
        ]
      }
    ],
    "use":true,
    "requiresIntegrations":false,
    "options": []
  },
  {
    "name": "Remember video quality",
    "description": "Save the video quality value whenever you change the video quality.",
    "compatiblePackages": [
      {
        "name": "com.google.android.apps.youtube.music",
        "versions": [
          "6.15.52",
          "6.20.51",
          "6.21.51",
          "6.22.51"
        ]
      }
    ],
    "use":true,
    "requiresIntegrations":false,
    "options": []
  }
]
```