You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- NOTE: This app requires Magisk or KernelSU for root access. Any alternative methods won't work.
33
-
```
31
+
> [!CAUTION]
32
+
>
33
+
> This app requires Magisk or KernelSU for root access. Any alternative methods won't work.
34
34
35
35
# 🛠 Requirements
36
36
@@ -42,28 +42,46 @@ Furthermore, the open-source nature of Iconify encourages community contribution
42
42
43
43
- Decryption Supported Custom Recovery (Just in case)
44
44
45
-
> KSU users must flash OverlayFS Module from [**HERE**](https://github.com/HuskyDG/magic_overlayfs/releases) before installing iconify.
46
-
>
47
-
> Remember to edit _mode.sh_ file inside the module and change these values before flashing:
48
-
>
49
-
> `OVERLAY_MODE=1`
50
-
> `DO_UNMOUNT_KSU=true`
51
-
>
52
-
> Note: If one of the above variable doesn't exist, skip that particular variable.
53
-
>
54
-
> If the customizations are still not taking effect, ensure that SystemUI has been granted root permission. After granting root access, reboot your device for the changes to take effect.
55
-
56
45
# 👨💻 Installation
57
46
58
-
1. Go to [Releases](https://github.com/Mahmud0808/Iconify/releases) section.
47
+
### Installation for Magisk Users:
48
+
49
+
1. Download and install the Iconify app.
50
+
51
+
2. Open the app, grant root permission and follow the instructions.
52
+
53
+
3. Wait for it to finish generating rom specific module.
54
+
55
+
4. Reboot the device when prompted, profit!
56
+
57
+
> [!NOTE]
58
+
>
59
+
> If some or most of the customizations are still not working for Magisk users, you might need to follow step 1 of KernelSU users' installation steps.
60
+
61
+
### Installation for KernelSU Users:
62
+
63
+
1. Flash [Magic Overlayfs](https://github.com/HuskyDG/magic_overlayfs/releases) module (to make read-only system read-write)
64
+
65
+
> [!IMPORTANT]
66
+
>
67
+
> Remember to edit _mode.sh_ file inside the module and change these values before flashing:
68
+
>
69
+
> `OVERLAY_MODE=1`
70
+
> `DO_UNMOUNT_KSU=true`
71
+
>
72
+
> Note: If one of the above variable doesn't exist, skip that particular variable.
73
+
74
+
2. Flash [ZygiskOnKernelSU](https://github.com/Dr-TSNG/ZygiskOnKernelSU/releases/latest) module (only if you want to use LSPosed features)
59
75
60
-
2. Download the `.apk` file.
76
+
3. Grant SuperSU/root permission for SystemUI from KernelSU app
61
77
62
-
3. Install and open the application.
78
+
4. Reboot your device to get the modules installed successfully
63
79
64
-
4. Follow the instructions, wait for finishing overlay building process.
80
+
5. Now follow the installation steps of magisk users and voila!
65
81
66
-
5. Reboot the device when prompted, profit.
82
+
> [!TIP]
83
+
>
84
+
> KernelSU doesn't show root prompt. You will have to manually enable root access for Iconify from KernelSU app itself.
67
85
68
86
# 🤫 Roadmap
69
87
@@ -90,7 +108,7 @@ You can help translate Iconify [on Crowdin](https://crowdin.com/project/iconify)
90
108
# 🤓 FAQ
91
109
92
110
- How does Iconify work?
93
-
- Iconify uses Android overlays that allows modifications to be applied to the user interface (UI) of the device without directly modifying the underlying system files.
111
+
- Iconify uses Android overlays and Xposed framework that allows modifications to be applied to the user interface (UI) of the device without directly modifying the underlying system files.
94
112
- Do I need a root access for Iconify to work?
95
113
- Yes, root access is required for Iconify to function properly. While Iconify does support KernelSU, it is highly recommended to use Magisk for the best compatibility.
96
114
- Why is LSPosed listed as an optional requirement?
@@ -127,25 +145,11 @@ You can help translate Iconify [on Crowdin](https://crowdin.com/project/iconify)
127
145
-[AOSPMods](https://github.com/siavash79/AOSPMods), [@siavash79](https://t.me/siavash7999) for helping me with Xposed mods.
128
146
-[@Sanely_insane](https://t.me/sanely_insane), [@Jaguar](https://t.me/Jaguar0066) for support and motivation.
129
147
-[HideNavBar](https://github.com/Magisk-Modules-Repo/HideNavBar) for the navbar tweaks.
- And everyone who [contributed](https://github.com/Mahmud0808/Iconify/graphs/contributors) and [translated](https://crowdin.com/project/iconify/members)... :)
146
149
147
150
# 📝 Disclaimer
148
151
149
-
- Please note that Iconify may not be fully compatible with all custom ROMs. It is discouraged to use on heavily modified ROMs.
150
-
- I cannot be held responsible for any potential damage or issues that may occur to your device while using Iconify.
151
-
- It is highly recommended to have a custom recovery installed on your device to revert any changes in case of unexpected problems.
152
+
> [!WARNING]
153
+
> - Please note that Iconify may not be fully compatible with all custom ROMs. It is discouraged to use on heavily modified ROMs.
154
+
> - I cannot be held responsible for any potential damage or issues that may occur to your device while using Iconify.
155
+
> - It is highly recommended to have a custom recovery installed on your device to revert any changes in case of unexpected problems.
0 commit comments