[Android Software Development] UltraM8:
Ainur FAQ

What happened to pandora, atlant, and nero?

The best of each have been combined into one: SAURON. These are now all deprecated and will no longer be supported.

Are there any pre-requisites?

Yes, busybox is required. Starting with Sauron MK I.III.I, [MENTION=4544860]osm0sis[/MENTION]' busybox is bundled with Sauron so you no longer have to worry about it.

What other audio mods are supported alongside ainur audio mods?

Only audio mods using [MENTION=5357345]ahrion[/MENTION]'s audio modification library (aml). Others may not work, cause weird issues, and/or completely break everything.

Is there any particular order in flashing these audio mods and other aml audio mods?

Not anymore. This was fixed in Sauron MK I.IV

Will these mods survive dirty flashes/OTA updates:

If your rom has addon.d support, yes, so a dirty flash will not remove them. See the Uninstallation section below for proper removal

Supported Root Methods and Corresponding Location of Scripts:

Magisk 12 or newer - /magisk/ainur_modname

Systemless SuperSu - /su/su.d

System SuperSu - /system/su.d

Rootless - /etc/init.d *Note that your rom must have init.d support for these scripts to run. With Sauron MK I.IV.II, init.d support will be automatically added if it is not already present.

What if my root method is not supported?

You can try to use init.d override. Create an empty file on the root of your sdcard called 'ainur_initdoverride'. Then flash the installer and it'll install scripts for init.d. Make sure this file is present during the uninstallation too.

What if I use magisk but want it installed to system so my device boots faster?

Use magisk override. Create an empty file on the root of your sdcard called 'ainur_magiskoverride'. Then flash the installer and it'll install the files to system instead of magisk img. Scripts are still installed to magisk img though for magisksu compatibility (won't affect boot time much at all). Make sure this file is present during the uninstallation too.

Things To Do Before First Installation:

MAKE A BACKUP

If using magisk version < 13, create an empty file on the root of your sdcard/internal storage called 'ainur_propcompatibility'

Remove any other audio mods (Clean flash may be necessary here)

If using magisk, read the Troubleshooting Section for Magisk here: https://xdaforums.com/apps/magisk/official-magisk-v7-universal-systemless-t3473445 and check that your phone is compatible with magisk: https://github.com/topjohnwu/Magisk/issues. If there's a device support issue open for your phone, then it's probably not supported yet

Installation:

Follow the previous section

CREATE ANY AINUR OVERRIDE/COMPATIBILITY FILES ON SDCARD AS NEEDED ABOVE (KEEP THESE FOR UNINSTALL TOO)

Flash the following in order: Rom, root method, ainur module

If using magisk, disable busybox in magisk manager

Magisk Troubleshooting:

If you're spontaneously losing root/weird magisk stuff happening:

Did you disable busybox in magisk manager? If yes, try the following

Go to battery optimization settings and disable battery optimization for magisk manager

Disable magisk hide

If you're seeing weird stuff in twrp involving data partition or see 'Error 2' when installing anything involving magisk

Boot into twrp

Go to Advanced -> terminal

Type:

e2fsck -f data/magisk.img

Say yes to prompts to repair errors

**Note that in some rare instances, the magisk img is too corrupt to be recovered. In these cases, you'll need to uninstall/reinstall magisk

Uninstallation:

Flash the corresponding uninstaller

OR Clean flash rom

Note: If you're on a rom that doesn't support addon.d (like stock), a dirty flash will work too.

Safety Net:

Safety net will only pass if rootless or using magisk. Here are the steps to pass safety net with magisk:

Open magisk manager

Go to settings

Enable magisk hide and reboot

Still note that Safetynet is a losing battle. See here: https://xdaforums.com/showpost.php?p=68424605&postcount=2

UPDATE: Google has made some kind of update to safetynet so it will no longer pass with magiskhide. This is being working on in v13 betas.

Ainur Module Updating:

Flash the uninstaller for the version of the module currently installed

Flash installer for new version of ainur mod