BlackBerry Key2
NOTE: The tutorial is meant for the blackberry key2(le) but will work for other android devices.
You have ADB and fastboot installed
Your device is running LineageOS, if it's not see the article below
The APatch app is installed from either github or F-Droid.
Get the boot.img from the rom you currently have installed and copy it to your devices's internal storage
Open the APatch app and select the left most icon in the top bar
Press 'Select a boot image to patch' and point it to your boot.img file
Enter a password into the SuperKey box
NOTE: Make sure to write it down somewhere as you will need it later
Move the outputted .img file to you computer.
Power off your phone.
Once you phone is fully powered off hold the power and volume down buttons until the bootloader is shown.
Connect your phone to your computer
Run the following commands:
fastboot flash boot /path/to/apatch_patched_{random_text}.imgfastboot rebootOnce the device finishes booting open the APatch app
Enter your SuperKey you set earlier into the superkey box then select 'Install Android Patch'
Download Integrity-Box from here, you need '{version}-Integrity-Box-{DD}-{MM}-{YYYY}.zip'.
Download NeoZygisk from here, you need 'NeoZygisk-{version}-release.zip'.
Download TEESimulator from here, you need 'TEESimulator-{version}-Release.zip'.
Download Zygisk-Assistant from here, you need 'Zygisk-Assistant-{version}-{commitID}-release.zip'.
Open APatch and enter the APModule tab. (second from the right)
Press the floating button, it will open a file browser, open one of the downloaded zip files.
Once the restart button appears press the back key. DO NOT PRESS RESTART.
If you get a /data/adb/apd: inaccessible or not found error reboot you phone then try again
Repeat the previous to instructions until you have installed all 4 downloaded zip files.
Reboot device and once it finishes open the APModule tab again
On the card for .Integrity Box tap the 'Action' button
(Optional): Configure Integrity Box, you can open it's configuration utility by pressing the 'Open' button on it's card in APModule
If you need to hide all system modifications from an app go into APatch's superuser(center) tab and tap on the app's name then enable the 'Exclude modifications' toggle.
You may need to disable the Zygisk Assistant module for google wallet tap to pay to work properly.
NOTE: If you have any questions or issues you can ask in the BlackBerry Android hideout discord server, the invite is https://discord.gg/BuJURQD6Qb
A BlackBerry key2, the key2le is not currently supported.
A Windows or linux computer
You have the android platform tools installed, if you don't you can get them for windows here and on linux it's packaged as android-tools on most distros and as android-sdk-platform-tools on debian linux and it derivatives.
(Windows): You have the BlackBerry USB drivers installed
NOTE: If you don't know the path of a file you can drag it from your filemanager into a terminal window
Remove your lockscreen password and google account from your device
If the option to set your screen lock to swipe is grayed out factory reset your phone from settings AFTER removing your google account.
If you do not remember your password follow theses instructions from the device setup.
Download the ACQ160 Autoloader.
Power off your device then boot into the bootloader by holding volume down and the power button.
You will need to flash the firmware twice, to do so extract the downloaded 7z file and run the included 'flashall.bat' file, once the phone boots up to the setup reboot to the bootloader again.
Repeat the previous step once.
NOTE: A linux version of the flashall.bat script is available here.
If you get an error: cannot load message you can ignore it.
Power off your device then boot into the bootloader again.
Download the windows unlock tool from here and extract the zip file, if you don't already have it installed you may need to install the microslop VC++ redists.
Open the unlock tool.
Press the scan in the upper right corner, once your devices is found press the 'Unlock BootLoader' button
NOTE: The progress bar will stay at 75% even once the bootloader unlock finishes
If the unlock was successful, on the phone MODE: will change from PRODUCT to FACTORY
Power off you device
Download kibo from Bochenek's github page and extract the zip file you downloaded.
Mark the kibo binary included with the zip file as executable.
From a terminal run ./kibo unlock
If the unlock was successful, on the phone MODE: will change from PRODUCT to FACTORY
Power off you device
Alpha and beta builds are *NOT* ready for daily use and are for TESTING PURPOSES ONLY.
Download the lastest version of the build you'd like to use
NOTE: If you intend to use as your main phone or are not sure which you want use standard android 15
The package for gapps(Google Services) is not included with the rom download, if you want them you will need to download it seperately.
The recommended gapps package for android 15 is MindTheGapps 15, and MindTheGapps 16 for android 16.
Once your rom download finishes extract it's .zip file, and enter the directory it extracted to.
Boot into the bootloader by holding volume down and the power button.
Run the following commands:
fastboot -wfastboot flash recovery /path/to/recovery.imgfastboot flash boot /path/to/recovery.imgfastboot rebootNOTE: You navigate the recovery by using the volume keys to move the cursor and the power button the select.
Once the LineageOS recovery appears select 'Apply update' -> 'Apply update from adb'
NOTE: If your flashing android 16 you need to cancel out of the apply update menu then go back in for it to work
Run adb sideload /path/to/lineage-{lineageVersion}-{date}-UNOFFICIAL-krab-{version}-athena.zip
If you have any additional zips you want to flash(ie: gapps, magisk) go into 'Apply update' -> 'Apply update from adb' and run adb sideload /path/to/package.zip, once the signature verification failed messages appears select yes.
If you get a not enough space on system partion error when flashing gapps go into 'Factory reset/Format data' and format the system partition, then re-flash lineageOS and gapps.
Select the 'Reboot system'
NOTE: The first boot can take up to 10-15 minutes
(Optional) Once you have finished the setup set the IME switcher shortcut to Alt + Enter in Settings -> System -> BlackBerry keyboard. Doing this makes the SYM key work properly instead of opening the keyboard switcher.
You have ADB and fastboot installed
You are running a build released *AFTER* March 04 2026. If your on a build older then this date or one posted on XDA you will need to follow the flashing LineageOS section of the install guide above, doing so will wipe your device.
NOTE: If you need to downgrade you can do so with the recovery update method.
NOTE: Updating this way does not keep root. You must use the recovery update method if your going to change version
Download the latest rom build for your version
NOTE: If the file is larger then the MEGA mobile site allows enable the show desktop site option in your browser's settings
Extract the zip file you downloaded.
Go to Settings -> System -> System Update.
Tap the 3 dots in the top corner and select Local update.
Select the zip file following lineage-{lineageVersion}-{date}-UNOFFICIAL-krab-{version}-athena.zip naming format.
NOTE: Alpha and beta builds are *NOT* ready for daily usage do not update to one unless you want to test it.
Download the latest rom build for your version
NOTE: If you are switching to a different version with a different kernel or downgrading to an older android version you need to wipe your data.
Once your rom download finishes extract it's .zip file, and enter the directory it extracted to.
NOTE: If you want google services on android 16 you need to use MindTheGapps 16.
If your phone is rooted patch the boot.img file included with the new build.
Power off you device then hold volume down and power until the bootloader menu is shown
Run the following commands:
fastboot flash recovery /path/to/recovery.imgfastboot flash boot /path/to/recovery.imgfastboot rebootIf your switching to a different version select 'Factory Reset' -> 'Format data / factory reset'
Select 'Apply update' -> 'Apply update from adb'
NOTE: If your flashing android 16 you need to cancel out of the apply update menu then go back in for it to work
Run adb sideload /path/to/lineage-{lineageVersion}-{date}-UNOFFICIAL-krab-{version}-athena.zip
If you have google services installed go into 'Apply update' -> 'Apply update from adb' and run adb sideload /path/to/gapps.zip once the signature verification failed messages appears select yes.
If your rooted select 'Advanced' then 'Reboot to bootloader', once the bootloader appears flash your modified boot.img file and boot up the system.
If it's not rooted select 'Reboot system'
Boot into recovery
NOTE: The easiest way to get into recovery is by using the 'Advanced restart' option in settings
Once the recovery menu appears select Advanced -> Enable ADB
From a computer run adb shell wipe-frp
Power off your device or reboot it using the option in the recovery menu
Android 16 Alpha
FIXED: BT-sound lags upon device unlock (every time after going into deep-sleep for the first time);
FIXED: Nav-buttons backlight turn-off on good-light conditions;
Fixed: Convenience key;
Fixed: Wi-Fi disabled upon device sleep;
Fixed: Low-latency pin entering on unlocking;
Fixed: Slow LCD enabling after sleep;
Fixed: Device hang on blackberry screen upon reboot (sometimes);
Low performance and lags after wake from sleep;
TRY-FIX: Gcam88 camera hangs-up device under load;
TRY-FIX: BT-sound lags under cpu pressure;
Haptics/Vibro more precise (but not as accurate as needed);
Performance and memory tunings;
Fixed. K12KB: Back-button not work in text inputs;
Voip better;
ired head-set sound fixed;
Fixed: Virtual nav-buttons settings toggle;
TRY-FIX: Gcam88 preview freeze on some boots;
Fixed: Keyboard-press was waking device;
Led breathing and setting fixed;
Keyboard backlight timeouts controlled both with nav-btns;
Swappiness 60->100 (better swap->zram usage);
Low-light adaptive brightness flickering fixed;
NFC better;
USB-OTG and MMC-flashes, including exFAT, NTFS;
Recovery activated restore "choose from disk";
USB mode changes via preferences unlocked;
Camera fixed (was broken by selinux);
Fingerprint better;
GPS better;
Darkening GUI-colors on Synaptics LCD temporary hacky fix;
VOIP better;
Laggy wakeups/Deep sleep better;
Shed/CPU freq scaling better tnx @Wumbomumbo;
Keyboard-backlight from LOS22-krab-v1.8 tnx @Sadako
recovery adb sideload fixed;
Unlocking performance issue fixed;
Selinux: enforced
Android 16 and kernel 4.19
Android 15
Mobile-hotspot fixed;
Wired-headset on VOIP fixed;
Battery and performance tunings;
Todo: Good solution for Synaptics LCD colors/saturation
Todo: Suppress "Serial console enabled" warning
May security patches
VOIP fixed
Fixed: Haptic logcat errors
Todo: Good solution for Synaptics LCD colors/saturation
Todo: Suppress "Serial console enabled" warning
FIXED: BT-sound lags upon device unlock (every time after going into deep-sleep for the first time)
Todo: Good solution for Synaptics LCD colors/saturation
Todo: Suppress "Serial console enabled" warning
Update to linux kernel 4.19 from 4.4
Significant battery life improvements;
Gcam stability improvements;
Todo: Good solution for Synaptics LCD colors/saturation
Keyboard-blacklight Sadako's algo implemented,
Car-bt: music - voice-call glitches try-fix
5Ghz hotspot,
Camera black preview sometimes
April 01 security patches,
qwertz/azerty fix re-applied,
Lokker app v1.2a updated performance,
K12KB app v3.1c updated performance,
GPS/xtra fixes,
Wi-Fi micro enhancements (NOT WPA3)
March 01 security patches,
Camera stability - less crashes,
qwertz/azerty fixed - retail kl/kcm behavior,
Keyboard settings -> show virtual keyboard toggle,
Lokker app v1.1 updated,
Widevine L3 OK, L1 Widevide disabled (will not work)
NFC fixes,
Battery drains on heavy renderings,
QWERTZ, AZERTY fixes
Voip fix (tested on Telegram),
Svindleds speakers in-call changes fix,
Touchpad-pagings sensivity -10%, inertion +10%,
App-links domains verification auto-approve (for microg)
Bugfix capacitive nav-buttons toggling,
Keyboard and nav-btns backlight adaptive levels,
Custom-keyboard preferences rearranged,
Keyboard touch paging mode sensivity decreased
Selinux enforcing,
Encryption,
Dt2w, button fixes on syna and focal,
Volume curve fixes,
RCS HAL crash fix,
Bluetooth mac address loader,
Touch keypad now usable,
Keyboard working on all apps,
Wifi hotspot fixes,
Init fixes,
Lineage KeyDisabler support,
USB init fix,
USB tethering fix
Pastiera: A foss keyboard app built for android phones with hardware keyboards. It's the default on Bochenek's rom builds. Make sure to use the latest nightly build, the stable has issues with the ALT and SYM keys.
K12KB: The keyboard app made by Krab-ubica, comes pre-installed with his rom builds. Currently requires enableing 'Allow on-screen keyboard' in Settings -> System -> BlackBerry keyboard to work properly
Krab-ubica's BlackBerry Keyboard: A modified version of the blackberry keyboard with working keyboard gestures. Chloejp has made a version with all language packs available here & one with only vietnamese available here.
Hazem's BlackBerry Keyboard: A heavily modified version of the blackberry keyboard with material you colors, working keyboard gestures, newer emojis and a ton of various fixes, it's language packs are available here.
Krab-ubica's BlackBerry Launcher: The default launcher from android 8.1 with performance improvements and modifications to make it work on LOS. The default 8.1 wallpaper set is also available on this archive.org page.
Torchlight Launcher (PAID): A clone of blackberry OS 7 as an android launcher
KISS: A blazingly fast launcher focused on search
Kvaesitso: A seach-focused launcher, currently needs the enable-blurs magisk module for blur effects to work on the key2.
Lawnchair: An open-source clone of google's pixel launcher
BigKaka 8.8 mod: A build of Gcam modified by krab-ubica to work with key2's hardware. If your using a rom build with the 4.19 kernel use this version instead.
Hail: Freeze certain apps to stop them from running in the background
Shelter/Insular/Island: Add apps to a work profile to isolate them from other apps, stop them from auto starting or install multiable versions to once.
KeyMapper: Remap any button and set custom key binds easily
Aliucord: A light-weight discord client based on a version from before it was a wrapper for the mobile website
NOTE: This does not work without root and is completely unneeded on versions other then standard android 15
Enable 'USB debugging' and 'Rooted debugging' in developer options
Run adb root
If you want 2gb of swap run this command
adb shell "mkdir -p /data/adb/service.d && echo '#!/system/bin/sh echo 3 > /proc/sys/vm/drop_caches swapoff /dev/block/zram0 echo 1 > /sys/block/zram0/reset echo 2147483648 > /sys/block/zram0/disksize mkswap /dev/block/zram0 swapon /dev/block/zram0' > /data/adb/service.d/99_delayed_zram.sh && chmod 755 /data/adb/service.d/99_delayed_zram.sh"
If you want 4gb of swap run this command
adb shell "mkdir -p /data/adb/service.d && echo '#!/system/bin/sh echo 3 > /proc/sys/vm/drop_caches swapoff /dev/block/zram0 echo 1 > /sys/block/zram0/reset echo 4294967296 > /sys/block/zram0/disksize mkswap /dev/block/zram0 swapon /dev/block/zram0' > /data/adb/service.d/99_delayed_zram.sh && chmod 755 /data/adb/service.d/99_delayed_zram.sh"
NOTE: If you have an indian region device you will need to flash the ABN088 Auto Loader after you have relocked the bootloader
Download the ACQ160 Autoloader and extract the 7z file it downloads as.
Enable 'Advanced restart' in Settings -> System -> Buttons -> Power menu
Hold the power button until the power menu show then select Restart -> Recovery
Once the recovery menu appears select Advanced -> Enable ADB
From a computer run adb shell wipe-frp
Power off your device then hold volume down and power until the bootloader menu is show.
Run the flashall.bat script from the ACQ160 autoloader.
NOTE: A linux version of the flashall.bat script is available here.
If you want to relock the bootloader or have an india model follow the locking the bootloader section for your operating system.
Download the windows unlock tool from here and extract the zip file, if you don't already have it installed you may need to install the microslop VC++ redists.
Open the unlock tool.
Press the scan in the upper right corner, once your devices is found press the 'Relock BootLoader' button.
NOTE: The progress bar may stay at 75% even once the bootloader relock finishes.
If the relock was successful, on the phone MODE: will change from FACTORY to PRODUCT.
Download kibo from Bochenek's github page and extract the zip file you downloaded.
Mark the kibo binary included with the zip file as executable.
From a terminal run ./kibo lock
If the relock was successful, on the phone MODE: will change from FACTORY to PRODUCT.
Download the modded boot file from here.
Open a terminal where you downloaded the file and run fastboot flash boot acq160-mfi-boot.img.
NOTE: If your are want to root patch the acq-160-mfi-boot.img boot file not the one from ACQ160 itself.
NOTE: This section is on how to fix a rare bug, you will most likely not experience it when reverting.
If you relocked the bootloader unlock it again as shown in the install guide.
Download the LineageOS recovery from here.
Run the following commands:
fastboot flash boot /path/to/recovery.imgfastboot rebootOnce the recovery menu appears select 'Advanced' -> 'Enable ADB'
Download the persist partition patch from here then extract the downloaded 7z file.
Open a terminal where you extracted the file persist to, then run the following commands:
adb push persist /tmp/adb shell dd if=/tmp/persist of=/dev/block/by-name/persistadb reboot bootloaderThen redo guide from the start.