Install guide

Five steps, about five minutes. You need Android 17, root and LSPosed with libxposed API 102 already working on your phone.

1. Download and install the APK

   Get the latest .apk from the GitHub release page and open it on your phone. Android asks you to allow installs from that app (your browser or file manager) the first time.

2. Enable the module in LSPosed

   Open the LSPosed manager, go to Modules, turn on Cucuto and set its scope to System Framework only. Do not add WhatsApp to the scope: Cucuto never hooks the WhatsApp app.

3. Reboot

   The module loads into the Android system at boot, so a full reboot is needed after enabling it or changing its scope.

4. Check the status card

   Open Cucuto. The status card at the top checks that the module is active, the LSPosed scope is right, WhatsApp is installed and at least one pack is imported. Each failing check tells you how to fix it.

5. Import a pack and assign characters

   Import a .soundpack.zip file, then pick a chat and tap a character. Keep WhatsApp’s own notification tone and vibration turned on: Cucuto replaces them per contact.

Troubleshooting

• The module shows as inactive. Check that the scope is System Framework and that you rebooted after enabling it.
• A contact plays the normal WhatsApp tone. That is the safe fallback: the contact has no character yet, the chat is muted, or the module is off. The decision log in the app’s settings shows why for each recent notification.
• Still stuck? Open an issue on GitHub with your Android build and the decision log.

Download APK