Usually, the process of installing a Cydia tweak or theme is painless. You tap on the Install button, confirm your action, and wait for a few seconds or minutes and then Respring your iPhone or iPad. Well done! You can now see the changes take place on your iOS device.
But once in awhile, things don’t go as well as it should be. Sometimes, when I install a tweak that isn’t compatible with my iPhone or just don’t act well with other tweaks, the package will break my device. In some cases, my screen will just be blank.
If you ever experience this issue, there are a few ways to fix it. Here are your options.
- Restore the device from iTunes
- Restart your iPhone or iPad (hoping that it will turn back on)
- Use file manager such as iFunbox to remove the .deb package
I prefer using the last method, which is removing the problematic tweaks .deb files. If you decide to use iTunes as a solution, please keep in mind that it will also update your device to the latest iOS version. Which means you will lose your Jailbreak and Cydia.
As you can see, not all solutions are perfect. iFunbox or other file managers might not allow you to remove your .DEB files either. Worst case scenarios, give the method below a try. If you’ve accidentally installed a jailbreak tweak that isn’t compatible or breaks your iOS device, here is how to fix the problem.
We will be using your stock Mac’s application called Terminal or an SSH client if you use a different operating system such as Windows. The benefits of using the SSH method are absolutely worth it.
- It doesn’t require manual access to Cydia
- No need for iFunbox or iTools if you’re not familiar with them.
Secure Socket Shell
Or known as SSH. You might hear it for the first time. But it’s very easy to use. I often use the SSH method when a Cydia tweak caused the app to be completely frozen, and safe-mode isn’t working.
This is critical because nothing else will help besides upgrading to the latest firmware. This usually means no more Jailbreak (until someone releases a utility for it). If you want to keep your Jailbreak and fix the bug at the same time, using SSH is the ultimate solution.
Before you get started, the following items are required.
- Download Putty (for Windows) or use the default Terminal on your Mac
- Read this post to learn how to SSH into your device
- Watch the following video, and it will list out a number of commands to type in
To sum it all up, the computer will do almost everything for you. Listen to the commands (apt-get update, for example) and type it into Putty software or Terminal.
I hope this help and comment below if you need any further assistant.
Note: This also works if you want to install Cydia tweaks from a computer as well, not just removing them.
If Cydia is not working on your Yalu jailbroken device, try this:
I just got off a support ticket with someone who installed a tweak called Revelation. It turned out this package only supports iOS 8 and below while his iPhone is already running iOS 10.1.1. Moral of the story is, never install outdated tweaks as it can put your device at risk. More specifically, Cydia will stop working, and you will see boot loop occur on your iPhone.
To fix this issue, we’re going to enter No substrate mode on your iOS device.
- Reboot your iPhone to non-jailbroken mode
- Launch the Yalu app
- Tap Go and immediately hold down the volume up button along with the power button
- Don’t release until you see the lock screen
As soon as you entered No substrate mode, Cydia should be able to work this time. Open it and uninstall any tweaks that you think might cause the problem. After that, re-jailbreak by deleting the Yalu app and sideload it using Cydia Impactor.
This method is recommended for any jailbroken device, especially the one that used Yalu to jailbreak iOS 10.0.1 – 10.2.
If Cydia is causing more problems than expected, you can also remove it using tweaks like Cydia Eraser or OSXRestore. We already detailed those instructions on the other guide.