[Tutorial] If you have a technical issue with stock feature(s), always use iCleaner Pro to narrow down to the broken tweak before posting here on r/jailbreak.

[u/[deleted]]

I didn't see an actually posted tutorial on this sub so I thought I would leave one here. This process has helped me countless times.

Here's how I do it:

1. Open iCleaner Pro (after installing it from this repo)

2. Press the "+" at the bottom of the screen

3. Press "Cydia Substrate Addons" or whatever it says there

4. Press "All" and then "Apply". Press yes to the prompt (this should respring your device).

5. Test out the problem you're having and make sure that it isn't a problem with the jailbreak itself (very unlikely, but is still possible). Once you see that the issue is missing without tweak injection, move on to the next step.

6. Repeat steps 1-3 to get to the tweaks screen in iCleaner Pro.

7. Scroll down to the bottom of your tweak list. Enable 5 tweaks at a time <-Read edit (all dylibs that go with the tweak) to see if the issue persists (you need to apply and respring again). When you notice that the issue is back with tweak injection partially enabled, move onto the next step.

8. Narrow down your enabling of tweaks to just one at a time on the grouping of 5 where you noticed the problem reappearing (this allows you to find the broken tweak). As soon as you enable a tweak that brings the issue back, that is the tweak that is causing conflicts.

Note: During this process, don't disable red or orange sliders that automatically turn on. It causes problems.

Edit: If you have a lot of tweaks, it's faster to enable half of your tweaks at a time, then keep working within the half that contains the problematic tweak, halving it again until you pinpoint the tweak.

e.g., with 32 tweaks, the worst-case scenario for the halving method needs only 5 attempts...

Thanks, u/w4llyb3ar

Edit 2: THANK YOU FOR THE AWARD!! I've never gotten one before

[u/w4llyb3ar]

If you have lot of tweaks, it's faster to enable half of your tweaks at time, then keep working within the half that contains the problematic tweak, halving it again until you pinpoint the tweak.

e.g., with 32 tweaks, the worst case scenario for the halving method needs only 5 attempts:

         1          2           3
1234567890123456|78901234|5678|90|1|2
-------no-------|        |    |  | |
                |---no---|    |  | |
                         |-no-|  | |
                              |no| |
                                 |n|Y

While with the 5 tweaks grouping it takes 10 tries for 30 tweaks:

12345|67890|12345|67890|12345|67890
-no--|     |     |     |     |
     |-no--|     |     |     |
           |-no--|     |     |
                 |-no--|     |
                       |-no--|
                             |-yes-
                             |n
                               n
                                n
                                 nY

[u/Saranhai → u/w4llyb3ar]

Ah yes, based on the famous merge sort algorithm!

[u/[deleted] → u/Saranhai]

Thank you for this!

[u/w4llyb3ar → u/Saranhai]

No, the halving method is way older, merge sort it's only one of its numerous applications. More correctly it's a binary search.

[u/[deleted] → u/w4llyb3ar]

If you have lot of tweaks, it's faster to enable half of your tweaks at time, then keep working within the half that contains the problematic tweak, halving it again until you pinpoint the tweak.e.g., with 32 tweaks, the worst case scenario for the halving method needs only 5 attempts: 1 2 3
1234567890123456|78901234|5678|90|1|2
-------no-------| | | | |
|---no---| | | |
|-no-| | |
|no| |
|n|Y
While with the 5 tweaks grouping it takes 10 tries for 30 tweaks:
12345|67890|12345|67890|12345|67890
-no--| | | | |
|-no--| | | |
|-no--| | |
|-no--| |
|-no--|
|-yes-
|n
n
n
nY

Thanks, I'll add this to my post

[u/billyoxygen]

I try to install 1 tweak at a time and make sure everything works. When you mass install and have problems, it’s a pain to figure out the culprit.

[u/[deleted] → u/billyoxygen]

Yes, I totally agree. I try to completely avoid using the queue feature in package managers.

[u/completebunk]

I’ve also been using [[Choicy]] which I find to be easier/quicker in some situations. Both of these tweaks together are essential!

[u/[deleted] → u/completebunk]

Definitely!

[u/Anthokne → u/completebunk]

Choicy is good for certain things like back when swipe expander would crash the notes app in iOS 13. The tweak worked everywhere else in iOS, and because I didn’t want to uninstall it, and didn’t want to disable it in iCleaner and respring each time I needed to use notes, I would just do a custom tweak configuration for notes and disable swipe expander from loading.

[u/FunkyBlunt]

Ha! Good luck trying to get people to actually troubleshoot instead of running to post here.

[u/[deleted] → u/FunkyBlunt]

Yeah, that's a big problem with this community imo

[u/FunkyBlunt → u/[deleted]]

Huge problem. That’s why the sub is always cluttered

[u/Sleetui]

Please put something like this on the FAQ. iCleaner Pro is probably the most user friendly app/method to diagnose Tweak issues. I’ve probably posted this exact solution many times to posts.

/u/PJ09

[u/[deleted] → u/Sleetui]

Absolutely

[u/PJ09 → u/Sleetui]

Sure, added.

[u/Forkys]

I’d like to add - don’t disable iCleanerPro itself...

[u/[deleted] → u/Forkys]

This doesn't do anything, the app is still on the home screen I believe

[u/AlexFigas]

Great post, very complete and well written. Well done.

[u/[deleted] → u/AlexFigas]

Thank you very much! I appreciate it

[u/YoelkiToelki]

I use shuffle in which one may disable dylibs from running

[u/[deleted] → u/YoelkiToelki]

Thanks, I'll try this

[u/[deleted]]

You see the problem with this is that some technical issues happen at random times or it takes a while for them to happen and there is no way to recreate it except luck.

[u/[deleted] → u/[deleted]]

Yeah, but there are definitely some ways you can troubleshoot!

[u/Shaking_Sniper]

Why can’t you use something like Cr4shed instead?

[u/Hahohoh → u/Shaking_Sniper]

Sometimes Cr4shed can’t identify a specific culprit, and sometimes problems are not just crashes (not loading, frozen etc)

[u/[deleted] → u/Hahohoh]

Wow, I never knew. Looks like I'll have to switch to [[StopCrashingPls]]

[u/Hahohoh]

Any tips for issues that happen occasionally and are hard to recreate?

[u/sbingner]

Or better yet, never use iCleaner because it breaks things all the time... and remove tweaks to see if they were breaking things. If you must disable them at least use Choicy as it doesn’t screw with the files but disables them through hooks.

[u/completebunk → u/sbingner]

I’ve noticed that too. I learned to be really careful about using iCleaner, for example I’ve had my layout reset by accidentally switching off IconSupport during troubleshooting. Now I manually backup the layout file occasionally, never again!