Quick start
- Use iOS or iPadOS 27 or newer. For spam filtering, use iPhone 15 Pro, iPhone 15 Pro Max, iPhone Air, any iPhone 16 model, or later, or an iPad mini (A17 Pro), or an iPad Air or iPad Pro with M1 or later, and enable Apple Intelligence.
- Open Karui and follow the in-app setup wizard. It guides you through enabling the necessary permissions, configuring a Focus mode, and adding and configuring the standard Karui Shortcut.
- Open the standard Karui Shortcut if you need to add it again.
Important notifications produce a Karui notification. Neutral and spam notifications stay quiet.
Troubleshooting
No Karui notification appears
- In Karui, open Settings → Help & Troubleshooting and tap Check My Shortcut. Karui sends a test notification and tells you whether your Shortcut ran.
- If the check fails, the Shortcut’s automation may be off: it can start out off when you add the Shortcut. In the Shortcuts app, open the Karui Shortcut, tap Edit, tap the arrow after its list of apps, and turn on Automation. Leave Notify off (on older iOS versions, choose Run Immediately), and make sure Karui and the apps you use are in the list of apps.
- If you aren’t sure if you have the Shortcut configured correctly, delete it and add it again from this link.
- In iOS Settings > Notifications > Karui, make sure Karui notifications are enabled.
- In iOS Settings > Focus > the Focus you use, make sure Karui is allowed.
- Remember that neutral or spam notifications intentionally stay quiet. You can review them in Karui’s History, or adjust Karui Settings to be less restrictive.
Calls from VIPs don’t ring
- While a Focus is on, calls only ring from people the Focus allows. Otherwise the call is silent and you only see a missed call afterward.
- In iOS Settings > Focus > the Focus you use > People, set Allow Calls From to Favorites. Then add your VIPs as Favorites in the Phone app or the Contacts app.
- Don’t add your VIPs to the Focus’s list of people. That lets their messages through too, so you’d see each one twice: once from the app and once from Karui.
- Turn on Allow Repeated Calls there too, so a second call from the same person within three minutes rings.
- Karui only learns about a call once it’s missed. With Wake Me, a second missed call from someone you chose can ring an alarm, or turn on Missed calls ring immediately to ring on the first.
- Wake Me relies on the Karui Shortcut and iOS, and can miss a message or call. Don’t make it the only way people can reach you in an emergency.
A notification says it was decided by rules
- While Karui runs in the background for your Shortcut, iOS gives it only a small share of the on-device model. After several notifications in a row, Karui may sort some with simple rules for a while. It rechecks them the next time you open Karui, or right away if Private Cloud Sorting is on. Technical details.
I still see spam notifications
- Make sure the app producing the spam notifications is silenced in your Focus mode.
- In iOS Settings > Focus > the Focus you use > Apps, turn off Time Sensitive Notifications. When it’s on, apps get through your Focus by marking notifications time sensitive, and you may see some notifications twice.
- Try adding more VIP contacts in Karui Settings.
- Adjust the Urgent, Neutral, and Spam terms in Karui Settings.
- Give Karui access to your calendar. Your calendar events stay private and do not leave your device.
Requirements and limitations
- Requires iOS or iPadOS 27 or newer. Spam filtering and deadline reminders also need Apple Intelligence: supported models are iPhone 15 Pro, iPhone 15 Pro Max, iPhone Air, all iPhone 16 models, or later, and iPad mini (A17 Pro), and iPad Air and iPad Pro with M1 or later. Viewing unsent messages works without it. For the best experience, use iPhone 17 Pro, iPhone 17 Pro Max, iPhone Air, or later, which support Apple’s more capable on-device model.
- You must add the default Karui Shortcut during Karui setup. If you use apps beyond the standard ones, add those apps to the Shortcut.
- Tapping a replacement notification opens the source app, not the exact message. In Messages and WhatsApp, it opens the conversation when Karui has the sender’s number. With Karui for Mac running, it opens the exact email in Spark or message in Slack. Otherwise, when you need to jump to a notification’s exact destination, open the original notification.
- Karui can misclassify a notification. Review Notification Center and Karui’s History when something may have been missed.