feat: Add desktop GUI #42

prateek-who · 2026-02-06T11:45:05Z

The GUI update with most of the stuff. Some stuff might be broken, will keep fixing them as they appear. Also, please check the build.gradle.kts file once just to make sure I didn't mess up anything that the team might have added there.

Tired of using the old CLI? Not sure where to get what files to get the CLI running? Too busy to read the documentation? Worry not ladies and gentlemen, we present to you the Morphe GUI!

We got shiny new look coat of paint to suit your needs with more coming on the way!

Select the patch you want to use, including stable and dev patches!

See all the patches that will be applied even before they are applied! Are you a power user and want to make small tweak to the final command? With one click copy, your command will be all yours to experiment with! Also, see the morphe team's most deselected patches and decide if you want to listen to them :)

See the patch getting applied in real time just like how it does on the mobile patcher!

Directly install the app to your phone over ADB if you are plugged in to your computer and not worry about transferring the app and installting it again!

And in case you happen to be in a hurry want the entire process to be done ASAP, we got your back there too!

Visit your nearest morphe github to grab your CLI's GUI

src/main/composeResources/drawable/youtube_music.svg

prateek-who · 2026-02-08T17:45:33Z

Maybe we relocate the 'Code Preview' and the 'Suggested Deselected Patches' sections to the TopBar in the Patch Selection Screen? It's kinda looks ugly and cramped right now I feel. Will try to figure something out for this soon.

LisoUseInAIKyrios · 2026-02-08T18:11:42Z

If code preview you mean the CLI command, then yes it can be at the top of the screen. It can be show if "expert mode" is enabled. The simplified mode setting can be inverted to "expert mode" and it's default off, to match Android Manager app.

Suggested deselected patches can be removed entirely. Patches already declare if they are default included, and we don't want hard coded patch preferences or anything else.

Ideally the only hard coded thing we should use, is a package name to app name lookup, so a human readable app name is shown and not the ugly package name. Eventually this will change so it's not needed, but for now it's ok.

LisoUseInAIKyrios · 2026-02-08T18:13:04Z

The simple mode progress UI stub can be removed too since it's not easy to use with CLI text usage.

prateek-who · 2026-02-09T03:32:18Z

If code preview you mean the CLI command, then yes it can be at the top of the screen. It can be show if "expert mode" is enabled. The simplified mode setting can be inverted to "expert mode" and it's default off, to match Android Manager app.

Suggested deselected patches can be removed entirely. Patches already declare if they are default included, and we don't want hard coded patch preferences or anything else.

Ideally the only hard coded thing we should use, is a package name to app name lookup, so a human readable app name is shown and not the ugly package name. Eventually this will change so it's not needed, but for now it's ok.

Got it. I'll remove the suggested patches thingy entirely. Will integrate it into the patch card iteslf just like how mobile manager does it.

prateek-who · 2026-02-09T03:34:43Z

The simple mode progress UI stub can be removed too since it's not easy to use with CLI text usage.

Do I do what the normal mode does and show the progress bar just spinning but no actual number?

prateek-who · 2026-02-09T03:40:00Z

Ok, it just says 'patching' now with a circular spinning icon, no progress or numbers and shows the latest text of the CLI in there like this:

prateek-who · 2026-02-09T09:19:59Z

Was looking at adding this #26 . Saw your comment https://github.com/MorpheApp/morphe-patches/issues/336 on keeping them separate for the manager and the CLI. So, we add a flag that keeps only our needed lib and deletes other libs right? Or we could make this a GUI only option too and the Expert Mode gets the option to do this now since we are able to track the user device's architecture if they are connected over ADB (or give them an option to choose).
What do you think?

LisoUseInAIKyrios · 2026-02-09T09:25:49Z

Rip-libs can be a cli argument. Can be something like --riplibs (architectures to keep, separated by commas)

--riplibs arm64-v8a,x86 strips all except for armv8 and x86.

I think this should be do-able by deleting subdirectories before apktool recompiles the app. Or remove before zipping the files into the final apk, or possibly even remove from the apk after it's created. Deleting before APKTool would be preferred if possible, but whatever is simplest may be the best.

prateek-who · 2026-02-09T13:05:02Z

If a patch is not recommended the patches.mpp file sets "use" to false right? For youtube, only 2 out of the 61 patches have this field set to false,so naturally the gui auto selects the rest 59 and unselects those 2 and then lets the user decide what they want to do. However on the mobile patcher seems to deselect many more patches and shows only 54/61 selected. How is it doing that?

LisoUseInAIKyrios · 2026-02-09T13:22:44Z

The Android Manager still auto selects all patches with use == true, so it includes 59 patches like CLI does.

But it will remember the last selected patches if using expert mode. Maybe you already patched using expert mode and excluded some patches?

prateek-who · 2026-02-09T13:26:54Z

The Android Manager still auto selects all patches with use == true, so it includes 59 patches like CLI does.

But it will remember the last selected patches if using expert mode. Maybe you already patched using expert mode and excluded some patches?

Ah, that's probably it.

prateek-who · 2026-02-09T13:31:16Z

Rip-libs can be a cli argument. Can be something like --riplibs (architectures to keep, separated by commas)

--riplibs arm64-v8a,x86 strips all except for armv8 and x86.

I think this should be do-able by deleting subdirectories before apktool recompiles the app. Or remove before zipping the files into the final apk, or possibly even remove from the apk after it's created. Deleting before APKTool would be preferred if possible, but whatever is simplest may be the best.

Added --riplibs like you said here. Right as it re-aligns the apk and before the signing it, it rips the libs that the user doesn't want. Right now it does it only for youtube. Will test and add reddit too since reddit says universal too. Size seems to be dropping by 50% for youtube.

LisoUseInAIKyrios · 2026-02-09T13:39:07Z

Please make a separate PR with riplibs. Can merge that now.

prateek-who · 2026-02-09T14:37:34Z

Add the CLI changes to the new PR, this PR has those changes and the GUI changes that riplibs needs. I am hoping I did it right here too? Those files won't cause nay conflicts in the future when this merges with dev branch right?

LisoUseInAIKyrios · 2026-02-09T15:07:46Z

Correct there shouldn't be problems after riplibs PR is merged.

Added a device indicator on the top which allows to see if a device is connected or not. Other minor UI and logic fixes.

No more hardcoded disabled patches, directly read from the patches files Made a bunch of UI improvements for the patch screen. Simplified mode loading now shows a circular icon instead of making up progress numbers.

User can remove libs if they do not need it

We can now generate a single cross platform jar file. Fixed an issue where cache wasn't clearing on windows

No more code duplication. The patching logic is present in a central engine that both the cli and the gui can call to make it run however they want.

LisoUseInAIKyrios · 2026-02-11T08:08:57Z

I had to rebase and force push to resolve conflicts.

Reset your local repo to origin. Or delete your local branch and checkout your gui-update again.

prateek-who · 2026-02-11T08:30:04Z

Yup, done.

LisoUseInAIKyrios · 2026-02-11T11:30:41Z

src/main/kotlin/app/morphe/gui/ui/screens/home/HomeScreen.kt

+
+        // Important notice about APK handling
+        Text(
+            text = "Download the exact version from APKMirror and drop it here directly. Do not rename or modify the file.",


It looks like this works if the APK has been renamed. This text could be updated.

text = "Download the exact version from APKMirror and drop it here directly."

It just says this now. Maybe it could say something else?

The Do not rename or modify the file. Could be removed.

Download the exact version from APKMirror and drop it here directly is good.

LisoUseInAIKyrios · 2026-02-11T11:50:07Z

src/main/kotlin/app/morphe/gui/ui/screens/patches/PatchSelectionScreen.kt

+                modifier = Modifier.size(18.dp)
+            )
+            Text(
+                text = "$count patch${if (count > 1) "es are" else " is"} unselected by default as they may cause issues or are not recommended by the patches team.",


I don't think this "patches unselected" text is needed.

The patch selections screen only shows in expert mode, and it can be left to users to pick.

It seems the expert mode cannot deselect patches? I only see universal patches as an option to include. I cannot find a way to exclude Reddit patches during the patching UI flow.

The patch selections screen only shows in expert mode, and it can be left to users to pick.

It just shows an info card just in case the users are curious about the default unselected patches. That can be removed if you want, no issues.

It seems the expert mode cannot deselect patches? I only see universal patches as an option to include. I cannot find a way to exclude Reddit patches during the patching UI flow.

Ahh, this is problem when you rename the apk. Will fix this now by asking the gui to read the package name from file's manifest instead.

src/main/kotlin/app/morphe/gui/ui/screens/result/ResultScreen.kt

LisoUseInAIKyrios · 2026-02-11T11:54:02Z

src/main/kotlin/app/morphe/gui/data/constants/AppConstants.kt

+    object YouTube {
+        const val DISPLAY_NAME = "YouTube"
+        const val PACKAGE_NAME = "com.google.android.youtube"
+        const val SUGGESTED_VERSION = "20.40.45"


The suggested version can be parsed from the patches mpp file so it's not hard coded.

If needed can add a method PatchEngine or somewhere else if needed.

It gets the info from the patches file itself. This is more of a fallback. But will change it to instead say app version not found if it fails.

src/main/kotlin/app/morphe/gui/data/constants/AppConstants.kt

src/main/kotlin/app/morphe/gui/data/repository/PatchRepository.kt

LisoUseInAIKyrios · 2026-02-11T12:02:58Z

build.gradle.kts

+    // -------------------------------------------------------------------------
+    // Shadow JAR — the only distribution artifact
+    // -------------------------------------------------------------------------
    shadowJar {


Optional, but ideally we try to add Proguard to this to strip out unused code/libraries, because with the GUI CLI grows from ~55MB to ~170MB

The main problem with the size is coming from having skiko libs for all the OS. But will add ProGuard tomorrow

src/main/kotlin/app/morphe/gui/util/PatchService.kt

src/main/kotlin/app/morphe/gui/ui/components/SettingsDialog.kt

LisoUseInAIKyrios · 2026-02-11T12:07:35Z

src/main/kotlin/app/morphe/gui/ui/components/SettingsDialog.kt

+                    Spacer(modifier = Modifier.width(8.dp))
+                    Text(
+                        when {
+                            !allowCacheClear -> "Clear Cache (disabled during patching)"


It's optional, but we could extract all of these strings into string resource files. So if we later want to localize the GUI we can.

String files can be json or java property files. I think property files are better because they are easier to integrate into Crowdin and are friendlier to edit by hand.

Another option is using Kotlin localized strings with xml files.

We could do this now, later, or never.

Will add this a bit later. Seems like something that would really improve QoL

Minor fixes for various stuff

LisoUseInAIKyrios · 2026-02-11T20:49:39Z

src/main/kotlin/app/morphe/gui/ui/screens/home/components/ApkInfoCard.kt

+    // Show full architecture names for clarity
+    val formatted = archs.map { arch ->
+        when (arch) {
+            "arm64-v8a" -> "arm64-v8a"
+            "armeabi-v7a" -> "armeabi-v7a"
+            "x86_64" -> "x86_64"
+            "x86" -> "x86"
+            else -> arch
+        }
+    }


Can remove this left over code

I have the App Info Card rework in the pipelines. But will remove this code for now

src/main/kotlin/app/morphe/engine/PatchEngine.kt

Parsa307 · 2026-02-12T09:56:19Z

this is an good idea, btw it won't be morphe cli anymore. there would be an method to use cli instead of gui?

LisoUseInAIKyrios · 2026-02-12T10:37:26Z

Existing terminal CLI still works exactly how it always has. The GUI is shown if the CLI jar is opened like an app (double click from file explorer).

kitadai31 · 2026-02-12T12:17:06Z

#42 (comment)
Ok, it just says 'patching' now with a circular spinning icon, no progress or numbers and shows the latest text of the CLI in there like this:

How about showing log text in a multi lines text box like RVX Builder?

Currently, there is still a lack of information on the patching screen.

Benefits of showing logs:

CLI should be more advanced than Manager
It's easier to know which patches have been applied
Progress becomes clearer (decoding, patching, compiling, etc)
When a problem occurs, you can check the error

prateek-who · 2026-02-12T12:21:12Z

It already does this in the expert mode. I had made that change only for the simplified mode

kitadai31 · 2026-02-12T12:30:34Z

Oh, I didn't know expert mode. I'm sorry.

Btw, "Rebuilding APK..." log is not shown in Quick Patch mode
This makes it appear as if the progress is stuck on the last patch while rebuilding APK (Like "Applied: Custom branding")

prateek-who · 2026-02-12T13:20:01Z

Ok, I see this issue. Will fix this. If a patch takes longer than like 5 secs, I plan to put a message that says "Hold on.... this is taking longer than usual" but you are right on rebulding part. I'll fix that part

LisoUseInAIKyrios · 2026-02-12T13:57:55Z

Do any patches take more than 5 seconds? On my somewhat newish mid grade laptop every patch runs in less than 2 seconds. Some patches are less than 1/10 of a second.

The majority of the patching time is APK processing itself (decoding, compiling, signing).

prateek-who · 2026-02-12T15:14:32Z

None do, it's just the last rebuilding that takes a bit of time. Maybe adding that message might give the user assurance that it is still running.

Better patching logging Simplified version. Added --force for unsupported versions. Added a button for --continue-on-error to allow gui users to continue patching even when if a patch throws an error.

prateek-who · 2026-02-12T18:17:41Z

Oh, I didn't know expert mode. I'm sorry.

Btw, "Rebuilding APK..." log is not shown in Quick Patch mode This makes it appear as if the progress is stuck on the last patch while rebuilding APK (Like "Applied: Custom branding")

try patching now. It should properly show the stages in the simplified version

This comment was marked as resolved.

Sign in to view

LisoUseInAIKyrios changed the title ~~feat: GUI Update~~ feat: Add desktop GUI Feb 6, 2026

This comment was marked as resolved.

Sign in to view

LisoUseInAIKyrios linked an issue Feb 6, 2026 that may be closed by this pull request

feat: Simplify the usage of CLI by improving UX #33

Open

2 tasks

This comment was marked as resolved.

Sign in to view

LisoUseInAIKyrios reviewed Feb 6, 2026

View reviewed changes

src/main/composeResources/drawable/youtube_music.svg Outdated Show resolved Hide resolved

This comment was marked as resolved.

Sign in to view

prateek-who force-pushed the gui-update branch from 9f434b7 to 089d21f Compare February 9, 2026 13:45

prateek-who added 5 commits February 11, 2026 09:05

Connected devices update

930d4b3

Added a device indicator on the top which allows to see if a device is connected or not. Other minor UI and logic fixes.

Patch Screen UI Improvements

783dd7a

No more hardcoded disabled patches, directly read from the patches files Made a bunch of UI improvements for the patch screen. Simplified mode loading now shows a circular icon instead of making up progress numbers.

--riplibs update

fdba2c6

User can remove libs if they do not need it

Minor release and windows fixes

ffa14f9

We can now generate a single cross platform jar file. Fixed an issue where cache wasn't clearing on windows

Patching Engine Fix

512f6f5

No more code duplication. The patching logic is present in a central engine that both the cli and the gui can call to make it run however they want.

LisoUseInAIKyrios force-pushed the gui-update branch from c972045 to 512f6f5 Compare February 11, 2026 08:08

LisoUseInAIKyrios reviewed Feb 11, 2026

View reviewed changes

Minor Fixes

bf224f6

Minor fixes for various stuff

LisoUseInAIKyrios reviewed Feb 11, 2026

View reviewed changes

LisoUseInAIKyrios reviewed Feb 12, 2026

View reviewed changes

src/main/kotlin/app/morphe/engine/PatchEngine.kt Show resolved Hide resolved

Use non zero Java exit code if patching fails

46a4577

This comment was marked as resolved.

Sign in to view

Minor Fixes

7640a80

Better patching logging Simplified version. Added --force for unsupported versions. Added a button for --continue-on-error to allow gui users to continue patching even when if a patch throws an error.

This comment was marked as resolved.

Sign in to view

Uh oh!

feat: Add desktop GUI #42

Are you sure you want to change the base?

feat: Add desktop GUI #42

Uh oh!

Conversation

prateek-who commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment was marked as resolved.

This comment was marked as resolved.

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

This comment was marked as resolved.

This comment was marked as resolved.

This comment was marked as resolved.

This comment was marked as resolved.

This comment was marked as resolved.

This comment was marked as resolved.

This comment was marked as resolved.

prateek-who commented Feb 8, 2026

Uh oh!

LisoUseInAIKyrios commented Feb 8, 2026

Uh oh!

LisoUseInAIKyrios commented Feb 8, 2026

Uh oh!

prateek-who commented Feb 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

prateek-who commented Feb 9, 2026

Uh oh!

prateek-who commented Feb 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

prateek-who commented Feb 9, 2026

Uh oh!

LisoUseInAIKyrios commented Feb 9, 2026

Uh oh!

prateek-who commented Feb 9, 2026

Uh oh!

LisoUseInAIKyrios commented Feb 9, 2026

Uh oh!

prateek-who commented Feb 9, 2026

Uh oh!

prateek-who commented Feb 9, 2026

Uh oh!

LisoUseInAIKyrios commented Feb 9, 2026

Uh oh!

prateek-who commented Feb 9, 2026

Uh oh!

LisoUseInAIKyrios commented Feb 9, 2026

Uh oh!

LisoUseInAIKyrios commented Feb 11, 2026

Uh oh!

prateek-who commented Feb 11, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

prateek-who Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

LisoUseInAIKyrios Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

prateek-who Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

prateek-who commented Feb 6, 2026 •

edited

Loading

prateek-who commented Feb 9, 2026 •

edited

Loading

prateek-who commented Feb 9, 2026 •

edited

Loading

prateek-who Feb 11, 2026 •

edited

Loading

LisoUseInAIKyrios Feb 11, 2026 •

edited

Loading

prateek-who Feb 11, 2026 •

edited

Loading

LisoUseInAIKyrios Feb 11, 2026 •

edited

Loading

LisoUseInAIKyrios Feb 11, 2026 •

edited

Loading

kitadai31 commented Feb 12, 2026 •

edited

Loading

prateek-who commented Feb 12, 2026 •

edited

Loading