Cannot set Niagara Launcher as default

It has been reported that some manufacturers and ROMs do not allow the user to change their default launcher / home app to a third-party launcher.

HyperOS • Xiaomi

Xiaomi devices running HyperOS 2.0 and above do not allow users to set third-party launchers as default. There is a workaround, however: go to your device settings > Apps > Manage Apps > tap the 3 dots in the top right corner > Other settings > Default Apps > Launcher > Reset to default. Now, please press the home button or use the home gesture. You should be prompted which app you want to use as your default launcher. Select Niagara Launcher here.

Setting Niagara Launcher as the default launcher via adb

This should work on Android versions of all manufacturers.

For that, you need to use adb, the official Android debugging tool from Google. It has to be installed on your PC, for which the folks at Lineage OS (a custom Android distribution) made an excellent guide.

After installing adb and connecting your device to your computer, simply run the following command to set Niagara Launcher as your default home screen:

adb shell pm set-home-activity bitpit.launcher