QuickSwitch

Use QuickSwitch on rooted devices for better Recents integration.

QuickSwitch is a Magisk module that allows third-party launchers, like Lawnchair, to function as the system's Quickstep (Recents) provider.

It can improve gesture navigation, home animations, and Recents behavior.

Important: QuickSwitch requires root access on your device to function.

If your device is not rooted, this guide does not apply.

How QuickSwitch works

QuickSwitch uses several components together:

• Magisk Module

  • This is the core component installed through your root solution.

  • It lets third-party launchers take over Recents.

• QuickSwitch App

  • This optional app gives you a simple UI for selecting the Recents provider.

  • It has its own Android version limits.

• Lawnchair Quickstep support

  • Lawnchair includes support for Recents, gestures, and system animations when QuickSwitch is active.

Supported versions and devices

QuickSwitch support depends on your Android version and ROM.

Prerequisites

• A rooted Android device (with Magisk, APatch, KernelSU, or a similar solution) installed and working.

• Lawnchair installed on your device.

• Magisk, KernelSU, or APatch installed.

• The QuickSwitch Magisk Module downloaded from the official QuickSwitch releases page.

  • If you are using APatch or KernelSU, download this QuickSwitch fork instead.

Set up QuickSwitch

1

Install the Magisk module

1. Open the Magisk app (or equivalent root solution manager).

2. Go to the Modules section.

3. Tap Install from storage (or similar option).

4. Browse to and select the QuickSwitch .zip file you downloaded.

5. Allow the module to install.

6. Reboot your device when prompted.

2

Set Lawnchair as the default launcher

To set Lawnchair as your default launcher, follow the steps listed in Install and setup.

3

Choose Lawnchair as the Recents provider

Choose one of the methods below based on your Android version and root solution.

Method A: Via the app

If you are running Android 13 and below, and use Magisk:

1. Open the QuickSwitch app (look for it in your app drawer).

2. In the app, choose Lawnchair from the list of available launchers.

3. The app will prompt you to reboot your device. Confirm and reboot.

Method B: Via a terminal command

If you are running Android 14, using KernelSU or APatch, or if the app does not work, follow these steps:

1. Open a terminal emulator app on your device (e.g., Termux, or the terminal built into your root solution manager).

2. Launch a root shell (e.g., via su).

3. Execute the following command:

   /data/adb/modules/quickswitch/quickswitch --ch=app.lawnchair

   • The above works for the GitHub version.

   • For the Nightly and Play Store versions, use app.lawnchair.nightly and app.lawnchair.play, respectively.

   • If you are using a different package name, adjust app.lawnchair to match the respective package name.

4. Reboot your device to apply the changes.

After rebooting, Lawnchair should be handling system gestures and the Recents screen.

Troubleshooting QuickSwitch

QuickSwitch app not working on Android 14 or newer

The QuickSwitch app itself does not support Android 14 or above.

You must use the terminal command method (Method B above) to turn on Lawnchair as the Recents provider.

After activating QuickSwitch, Lawnchair crashes immediately, I get a black screen, or the system fails to boot reliably

This usually means QuickSwitch is not compatible with your current system setup.

• Your immediate priority is to turn off the QuickSwitch module from your root solution's recovery mode, then reboot your device.

• Once your system is stable, make sure you are using the latest version listed in Choosing a version.

• If the issue persists, follow Crashes and mention QuickSwitch in your report.

After activation, I get a message saying Incompatible system integration

This message appears when Lawnchair's Quickstep support cannot integrate with your system, even with QuickSwitch.

• Switch back to your system Quickstep provider.

• Make sure you are using the latest version listed in Choosing a version.

• If no update fixes it, your device may not be fully compatible.

• Check the Lawnchair issue tracker for similar reports.

I'm experiencing other issues with the QuickSwitch magisk module

If the QuickSwitch module itself is failing, report it on the QuickSwitch issue tracker.