## File: README.md     # 💊 Morphe > Want to watch ads? Us neither. Morphe is an Android app that patches YouTube, YouTube Music, and Reddit - stripping ads and giving you back control over your experience. No root required. ## ✨ Why Morphe? Modern apps are full of ads and dark patterns designed to grab your attention. Morphe patches them at the bytecode level - modifying the app directly on your device, without any of your data leaving it. The result is a cleaner version of the app you already know, exactly the way you want it. ## 📲 Download **[→ Download at morphe.software](https://morphe.software)** The website will guide you to the latest release for your device. No account needed. ## 🚀 How it works 1. **Install Morphe** from [morphe.software](https://morphe.software). 2. **Pick an app** - YouTube, YouTube Music, or Reddit are supported out of the box. 3. **Choose your mode:** - **Simple mode** - designed for a one-tap experience. Just tap Patch and Morphe handles the rest with sensible defaults. No configuration needed. - **Expert mode** - gives you full control. Choose exactly which of the 100+ patches to apply, configure per-patch options (colors, toggles, and more), and fine-tune everything before patching. 4. **Provide the APK** - Morphe guides you through obtaining the original app file via step-by-step dialogs. The patching itself happens entirely on your device. 5. **Install and enjoy** - once patching is complete, install the result like any normal APK. Everything happens locally. Morphe never uploads your APKs or personal data anywhere. ## 📖 Guides Step-by-step walkthroughs with screenshots, covering patching in both modes, installers, updates, patch sources, backups, and customization: **[→ Morphe guides](docs/README.md)** ## 🔧 Features **Patching** - Simple mode for one-tap patching with curated defaults - Expert mode for full patch selection, per-patch configuration, and experimental version support - Expert mode also shows an expanded patching screen with real-time logs and live RAM usage monitoring during patching - 100+ patches for YouTube, YouTube Music, and Reddit - Support for split APKs - Optional "Optimize for device architecture" mode - skips split APK modules for unsupported CPU architectures, locales, and screen densities during merge, and strips native libraries for unsupported architectures from plain APKs after patching - Sends a notification the moment patching finishes, so you don't have to keep the app open - Optional completion sound, with a distinct tone for success and failure - Optional auto-install with Shizuku right after patching completes - Batch patching - select several apps and patch them in one queue, with every question asked up front so the run never stops to wait for you - Optional automatic re-patching in the background when a patch source releases changes for your apps, with silent progress and result notifications **Patch options** *(Simple mode: available in the Advanced tab; Expert mode: available on the patch selection screen)* - Custom app display name, launcher icon, and header logo per app, with built-in creators that generate every density variant for you - App theme colors (background color presets) - Hide Shorts app shortcut and widget (YouTube) - And more, depending on installed patch bundles **Patch sources** - Add any compatible patch bundle via GitHub URL or deep link - Per-source pre-release toggle to get early patch access - Automatic background update notifications (even when the app is closed) - Sort your app list and patch sources however you like (name, install date, and more) **Installer** - Standard Android installer - Root installer with Magisk module support (mount-based, no data loss on update) - Play Store installer variants, so Google Play recognizes itself as the install source (with a warning about the trade-off - Play Store may then offer updates that would overwrite your patched build) - Any third-party installer apps detected on the system are also available as an option - Prompt-on-install option to choose per session - On rooted devices, Morphe asks whether you want a Root Mount install or a Standard install before patching starts, and adjusts the applied patches to match your choice **Appearance** - System / Light / Dark / Material You themes - Pure Black mode for OLED screens - Accent color selection - Animated backgrounds - pick one you like, or let Morphe shuffle them for you on each launch, daily, or every three days - App icon selection **Home screen** - Friendly time-of-day greeting when you open the app - Rearrange your app list into the order that suits you - Group your apps by patch source or your own categories - Hide apps you never patch, and bring them back whenever you like - Home cards for apps patched with universal patches, not just app-specific ones - Multi-select and bulk actions for cleaning up saved APKs and patch selections, and for patching several apps in one queue - Launcher shortcuts for re-patching outdated apps, checking for updates, and jumping straight into patching a recently patched app - Floating scroll-to-top button when your lists get long - A short guided tour after your first patch, so you know where everything lives **Advanced** - Import/export your Morphe settings as JSON, with a Replace or Merge choice on import - Import/export your signing keystore - Manage saved original APKs and patched APKs - Manage saved patch selections per app - GitHub Personal Access Token support for higher API rate limits - Process runtime - run patching in a separate process for better stability, with configurable memory limit - Bytecode processing mode - controls how bytecode is processed during patching, affecting patching speed, memory usage, and output APK size - Built-in file picker as an alternative to the system one, with an option to show hidden files - Optional external trigger, so automation apps can queue a batch through an intent, gated by a per-app confirmation - Export debug logs for troubleshooting ## ❓ New to GitHub? If you ended up here but aren't sure what to do next - no worries. Here's the short version: 1. Go to the **[Releases page](https://github.com/MorpheApp/morphe-manager/releases/latest)**. 2. Under **Assets**, tap the file ending in `.apk` to download it. 3. Open the downloaded file on your Android device and tap **Install**. 4. If Android asks you to allow installs from unknown sources, follow the prompt to enable it - this is required for any app not from the Play Store. That's it. Once Morphe is installed, everything else happens inside the app - the **[guides](docs/README.md)** above walk you through the first patch. For FAQs and troubleshooting, visit **[morphe.software](https://morphe.software)** or join the community on **[Reddit](https://www.reddit.com/r/MorpheApp)**. ## 📙 Contributing Thank you for considering contributing to Morphe. You can find the contribution guidelines [here](CONTRIBUTING.md). ## ❗ About Morphe is built on the foundation of [ReVanced Manager](https://github.com/ReVanced/revanced-manager) and [URV](https://github.com/Jman-Github/Universal-ReVanced-Manager). All changes made by Morphe are documented in the Git history. ## 📜 License Morphe is licensed under the [GNU General Public License v3.0](LICENSE), with additional conditions under GPLv3 Section 7: - **Name & Branding Restrictions (7c & 7e):** Derivative works must use their own distinct branding. The **"Morphe"** name, logos, and trademarks may not be used for the branding or title of derivative works (e.g., names like *"Morphe Plus"*, *"Morphe Expanded"*, or *"Morphe UserXYZ"* are strictly prohibited). See the [LICENSE](LICENSE) file for the full GPLv3 terms and the [NOTICE](NOTICE) file for full conditions of GPLv3 Section 7. --- ## File: docs/README.md # Morphe guides Step-by-step guides for using Morphe. If you are new here, start with the first one. ## 🩹 Patching - **[Patching an app in Simple mode](patching-simple-mode.md)** - your first patch, from picking an app to installing the result. No configuration needed. - **[The home screen and managing apps](home-screen.md)** - sorting, grouping, hiding, and bulk actions on your app list. - **[Patching an app in Expert mode](patching-expert-mode.md)** - choosing individual patches, configuring their options, and reading the patcher log. - **[Choosing how patched apps are installed](installers.md)** - the system installer, Shizuku, root mount, and the Play Store install source. - **[Updating a patched app](updating-patched-apps.md)** - what the Update badge means, and how to repatch without losing app data. - **[Patching several apps at once](batch-patching.md)** - queueing a batch, and letting Morphe re-patch on a schedule. - **[Managing patch sources](patch-sources.md)** - adding remote and local sources, and what the toggles on a source card do. - **[How patching works and how to tune it](patching-process.md)** - the steps of a run, the process runtime and memory limit, and what to do when patching fails. ## 🎨 Customization - **[Creating a custom app icon](custom-app-icon.md)** - a custom launcher icon and app name for the patched app, in both Simple and Expert mode. - **[Creating a custom header logo](custom-header-logo.md)** - replacing the logo at the top of the patched app, for the light and dark theme. ## 🧰 Maintenance - **[Backing up Morphe and your keystore](backup-and-keystore.md)** - why the keystore matters, and how to move everything to another device. - **[Storage and saved data](storage-and-saved-data.md)** - what Morphe keeps on your device, what is safe to clear, and how saved patch selections work. - **[Using the built-in file picker](file-picker.md)** - Morphe's own file browser, for when the system picker gets in the way. - **[Using an APK download helper](apk-download-helper.md)** - letting another app fetch original APKs, and what Morphe checks before patching them.