Skip to content

Releases: Lineage-BBKey2/distribution

LOS22_Key2_ZKrab-v1.21a

Choose a tag to compare

@zapaca zapaca released this 11 Oct 23:55
3e8c780

I consider this kernel 4.19 ROM to be no longer in beta due to lack of reported issues compared to the kernel 4.4 ROM.

Changes:

  • Oct. 2026 Android platform security patch
  • FM radio app:
    • Remove unnecessary permissions (NOTE: saved preferences and stations will be lost after updating)
    • Optional location detection for resetting location-specific station information for new scans after moving more than 100 miles
    • Remove log spam during Bluetooth playing
  • Add infrastructure for WiFi calling (not proven to work yet - please report if you have success)
  • "sym" key brings up virtual symbols page on default AOSP keyboard (LatinIME)
  • Change default settings with clean ROM install:
    • Disable showing virtual keyboard when typing
    • Reduce display size (3/7 in Settings/Display/Display size and text) to better match stock BB Android 8.1
    • Change keyboard and navigation button backlight timeouts to 10 seconds to match stock BB Android 8.1
  • Display sizes 1/7, 2/7, 3/7 rounded up (294->300, 336->340, 378->380; avoids old values falling just below some application layout thresholds)
  • Give Settings/System/BlackBerry settings top position and new icon
  • Fix far-end voice echo during VOIP calls
  • Fix intermittent green-tinted photos taken with flash in dark conditions
  • Defensive changes to try to prevent rare Synaptics touchscreen failure (including in recovery)

Known Issues:

  • None compared to kernel 4.4 (v1.13a). If you notice anything, please report it!

Notes:

  • If you are using adoptable/internal SD storage on kernel 4.4 ROM (v1.10a-v1.13a): Before updating to v1.21a, migrate/backup all apps/files from the SD card, format the SD card as normal/portable storage, then repeat formatting as adoptable/internal storage after updating to v1.21a
  • Default ZRAM compression changed to LZ4 in kernel, but if you had previously forced a compression algorithm with persist.vendor.key2.zram.compressor, that manual override will persist. It is recommended to switch to LZ4 - see last section below.

Update Instructions:

  • You cannot update to this ROM if you are running a Krab-v1.20+ or Krab-2.0+ build unless you wipe userdata
  • If you are running a ZKrab Key2 ROM from v1.9a-v1.13a: Download "lineage-22.2-20261010-UNOFFICIAL-zkrab-v1.21a-athena.zip" to your Key2 and perform local update through Settings/System/System updates/3-dot menu/Local update - Userdata wipe NOT needed!
    • You can return to v1.13a (kernel 4.4) with the same method if you experience issues with this build (again no userdata wipe needed)
  • If you are already running v1.20b or higher: Perform an OTA update on your Key2 through Settings/System/System updates (the OTA update is downloaded from the first link below)
  • If you are currently running stock Blackberry Android 8.1 or an older LineageOS version, download "LOS22_Key2_ZKrab-v1.21a.zip" to your PC and follow this guide for install instructions: https://daphnis-past-midnight.nekoweb.org/wiki/key2.html

Choose ZRAM Compression Algorithm

  • To switch to lz4 compression (other options are lzo and zstd, but lz4 is recommended):
    adb root
    adb shell setprop persist.vendor.key2.zram.compressor lz4
    adb reboot
    (after reboot confirm change with:)
    adb root
    adb shell cat /sys/block/zram0/comp_algorithm

LOS22_Key2_ZKrab-v1.13a

Choose a tag to compare

@zapaca zapaca released this 11 Oct 23:47
b0f14cb

Changes:

  • Oct. 2026 Android platform security patch
  • FM radio app:
    • Remove unnecessary permissions (NOTE: saved preferences and stations will be lost after updating)
    • Optional location detection for resetting location-specific station information for new scans after moving more than 100 miles
    • Remove log spam during Bluetooth playing
  • Keyboard PIN entry on lockscreen:
    • Fix QWERTZ/AZERTY mapping
    • Fix enter and delete keys sometimes not working
  • Settings/System/"Blackberry keyboard" renamed to "Blackberry settings", given top position and new icon, and add:
    • Legacy Blackberry apps page with Blackberry Keyboard and Blackberry Launcher install status and launching to Google Play app page
    • Host-side DT2W compatibility mode (for devices with FocalTech touch controllers only - increases DT2W reliability for some problematic units)
  • Fix downloads of dictionary/prediction databases for all languages in official Blackberry Keyboard app (ROM-side URL redirection to archive.org downloads)
  • USB-C screen mirroring: Allow audio routing to the connected display
  • "sym" key brings up virtual symbols page on default AOSP keyboard (LatinIME)
  • Change default settings with clean ROM install:
    • Disable showing virtual keyboard when typing
    • Reduce display size (3/7 in Settings/Display/Display size and text) to better match stock BB Android 8.1
    • Change keyboard and navigation button backlight timeouts to 10 seconds to match stock BB Android 8.1
  • Display sizes 1/7, 2/7, 3/7 rounded up (294->300, 336->340, 378->380; avoids old values falling just below some application layout thresholds)
  • Fix far-end voice echo during VOIP calls
  • Prevent BBF100-9 (Japanese single-SIM) devices being initialized as dual-SIM (not tested)

Update Instructions:

  • Perform an OTA update on your Key2 through Settings/System/System updates (the OTA update is downloaded from this Github Release page)
  • If you are currently running stock Blackberry Android 8.1, Krab-v1.1-v1.8, or an older LineageOS version, download "LOS22_Key2_ZKrab-v1.13a.zip" to your PC and follow this guide for install instructions: https://daphnis-past-midnight.nekoweb.org/wiki/key2.html

LOS22_Key2_ZKrab-v1.20d

Pre-release

Choose a tag to compare

@zapaca zapaca released this 27 Sep 01:17
202e45c

This is a Beta Build! There may be unexpected bugs.

Changes:

  • Fix second SIM not being recognized on some dual-SIM devices
  • Keyboard PIN entry on lockscreen:
    • Fix QWERTZ/AZERTY mapping
    • Fix enter and delete keys sometimes not working
  • Settings/System/"Blackberry keyboard" renamed to "Blackberry settings", and add:
    • Legacy Blackberry apps page with Blackberry Keyboard and Blackberry Launcher install status and launching to Google Play app page
    • Host-side DT2W compatibility mode (for devices with FocalTech touch controllers only - increases DT2W reliability for some problematic units)
  • Fix downloads of dictionary/prediction databases for all languages in official Blackberry Keyboard app (ROM-side URL redirection to archive.org downloads)
  • Preserve bootloader LCDB bias (prevents ghost navigation inputs on some FocalTech panels and color oversaturation on Synaptics panels)
  • Restore WLED current limit from kernel 4.4
  • Fix USB-C screen mirroring crash and allow audio routing to the connected display

Known Issues:

  • None compared to kernel 4.4 (v1.12a). If you notice anything, please report it!

Notes:

  • If you are using adoptable/internal SD storage on kernel 4.4 ROM (v1.10a-v1.12a): Before updating to v1.20d, migrate/backup all apps/files from the SD card, format the SD card as normal/portable storage, then repeat formatting as adoptable/internal storage after updating to v1.20d
  • Default ZRAM compression changed to LZ4 in kernel, but if you had previously forced a compression algorithm with persist.vendor.key2.zram.compressor, that manual override will persist. It is recommended to switch to LZ4 - see last section below.

Update Instructions:

  • You cannot update to this ROM if you are running a Krab-v1.20+ or Krab-2.0+ build unless you wipe userdata
  • If you are running a ZKrab Key2 ROM from v1.9a-v1.12a: Download "lineage-22.2-20260926-UNOFFICIAL-zkrab-v1.20d-athena.zip" to your Key2 and perform local update through Settings/System/System updates/3-dot menu/Local update - Userdata wipe NOT needed!
    • You can return to v1.12a (kernel 4.4) with the same method if you experience issues with this build (again no userdata wipe needed)
  • If you are already running v1.20b+: Perform an OTA update on your Key2 through Settings/System/System updates (the OTA update is downloaded from the first link below)
  • If you are currently running stock Blackberry Android 8.1 or an older LineageOS version, download "LOS22_Key2_ZKrab-v1.20d.zip" to your PC and follow this guide for install instructions: https://daphnis-past-midnight.nekoweb.org/wiki/key2.html

Choose ZRAM Compression Algorithm

  • To switch to lz4 compression (other options are lzo and zstd, but lz4 is recommended):
    adb root
    adb shell setprop persist.vendor.key2.zram.compressor lz4
    adb reboot
    (after reboot confirm change with:)
    adb root
    adb shell cat /sys/block/zram0/comp_algorithm

LOS22_Key2_ZKrab-v1.20c

Pre-release

Choose a tag to compare

@zapaca zapaca released this 15 Sep 22:16
202e45c

This is a Beta Build! There may be unexpected bugs.

Changes:

  • Fix BB Hub Inbox notification actions missing, BB Notes crash (was affected by flawed fix of BB Keyboard personalized suggestions permission in last release)
  • Haptic feedback: Restore kernel 4.4 fingerprint vibration strength and device-specific tuning
  • Settings/System/Buttons: Add Search button (i.e. Assistant/Convenience Key), remove Menu button (not on Key2)
  • Fix network access being lost on each reboot for apps stored on SD card when using adoptable storage
  • Fix front-facing camera showing live image when camera access is blocked
  • Sept. 2026 Android platform security patch

Notes:

  • If you are using adoptable/internal SD storage on kernel 4.4 ROM (v1.10a-v1.12a): Before updating to v1.20c, migrate/backup all apps/files from the SD card, format the SD card as normal/portable storage, then repeat formatting as adoptable/internal storage after updating to v1.20c
  • Default ZRAM compression changed to LZ4 in kernel, but if you had previously forced a compression algorithm with persist.vendor.key2.zram.compressor, that manual override will persist. It is recommended to switch to LZ4 - see last section below.

Known Issues:

  • Some users experience ghost Recents input spamming on kernel 4.19 - under investigation
  • Double tap to wake (DT2W) is working intermittently at least for FocalTech/Livata panels - under investigation
  • USB-C screen mirroring crashes LOS

Update Instructions:

  • You cannot update to this ROM if you are running a Krab-v1.20+ or Krab-2.0+ build unless you wipe userdata
  • If you are running a ZKrab Key2 ROM from v1.9a-v1.12a: Download "lineage-22.2-20260915-UNOFFICIAL-zkrab-v1.20c-athena.zip" to your Key2 and perform local update through Settings/System/System updates/3-dot menu/Local update - Userdata wipe NOT needed!
    • You can return to v1.12a (kernel 4.4) with the same method if you experience issues with this build (again no userdata wipe needed)
  • If you are already running v1.20b: Perform an OTA update on your Key2 through Settings/System/System updates (the OTA update is downloaded from the first link below)
  • If you are currently running stock Blackberry Android 8.1 or an older LineageOS version, download "LOS22_Key2_ZKrab-v1.20c.zip" to your PC and follow this guide for install instructions: https://daphnis-past-midnight.nekoweb.org/wiki/key2.html

Choose ZRAM Compression Algorithm

  • To switch to lz4 compression (other options are lzo and zstd, but lz4 is recommended):
    adb root
    adb shell setprop persist.vendor.key2.zram.compressor lz4
    adb reboot
    (after reboot confirm change with:)
    adb root
    adb shell cat /sys/block/zram0/comp_algorithm

LOS22_Key2_ZKrab-v1.12a

Choose a tag to compare

@zapaca zapaca released this 15 Sep 21:56
0d80459

Changes:

  • Change "Keyboard touchpad" QS tile to "Keyboard scrolling" with new icon, change its function to enable/disable keyboard scrolling (instead of enable/disable touchpad) - allows disabling keyboard scrolling while keeping touchpad functionality for keyboard gestures and backlight activation
  • Long pressing "Keyboard scrolling" QS tile launches Settings/System/Blackberry keyboard
  • Settings/System/Blackberry keyboard: Add "Enable keyboard touchpad" toggle, add "Light on keyboard touch" options (with "only light on press" enabled) to keyboard/button backlight settings
  • FIXED: UI element highlighting and yellow borders in some apps when touching keyboard touchpad
  • Decrease ZRAM from 3 GB to 2.5 GB
  • Change speed key function to CTRL key
  • Fix permission blocking when enabling "Personalized suggestions" in official Blackberry Keyboard app (Re-install Blackberry Keyboard may be required)
  • Restore some missing NFC configurations from stock BB Android (fixes NFC functionality in some cases)
  • Settings/System/Buttons: Add Search button (i.e. Assistant/Convenience Key), remove Menu button (not on Key2)
  • Fix front-facing camera showing live image when camera access is blocked
  • Capacitive keyboard gestures in official Blackberry Keyboard app are now working
  • Sept. 2026 Android platform security patch

Update Instructions:

  • Perform an OTA update on your Key2 through Settings/System/System updates (the OTA update is downloaded from this Github Release page)
  • You cannot update to this ROM if you are running a Krab-v1.20*/v1.21*/v2.0* build unless you wipe userdata
  • If you are currently running stock Blackberry Android 8.1, Krab-v1.1-v1.8, or an older LineageOS version, download "LOS22_Key2_ZKrab-v1.12a.zip" to your PC and follow this guide for install instructions: https://daphnis-past-midnight.nekoweb.org/wiki/key2.html

LOS22_Key2_ZKrab-v1.20b

Pre-release

Choose a tag to compare

@zapaca zapaca released this 07 Sep 15:41
0d80459

This is a Beta Build! There may be unexpected bugs.

Changes:

  • Update kernel from 4.4 to 4.19 with kernel adaptions and performance tunings (results in generally faster and smoother performance than kernel 4.4 ROMs)
  • Update to more modern graphics stack (ASUS 4.19-kernel) and plumbing (Gralloc4/Mapper 4.0)
  • Change speed key function to CTRL key
  • Fix permission blocking when enabling "Personalized suggestions" in official Blackberry Keyboard app (Re-install Blackberry Keyboard may be required)
  • Restore some missing NFC configurations from stock BB Android (fixes NFC functionality in some cases)
  • Change "Keyboard touchpad" QS tile to "Keyboard scrolling" with new icon, change its function to enable/disable keyboard scrolling (instead of enable/disable touchpad) - allows disabling keyboard scrolling while keeping touchpad functionality for keyboard gestures and backlight activation
  • Long pressing "Keyboard scrolling" QS tile launches Settings/System/Blackberry keyboard
  • Settings/System/Blackberry keyboard: Add "Enable keyboard touchpad" toggle, add "Light on keyboard touch" options (with "only light on press" enabled) to keyboard/button backlight settings
  • FIXED: UI element highlighting and yellow borders in some apps when touching keyboard
  • Decrease ZRAM from 3 GB to 2.5 GB
  • Add separate OTA update URL for 4.19 kernel ROMs (kernel 4.4 ROMs will not receive OTA update to kernel 4.19 ROMs yet)

Notes:

  • If you are using adoptable/internal SD storage on kernel 4.4 ROM (v1.10a-v1.11a): Before updating to v1.20b+, migrate/backup all apps/files from the SD card, format the SD card as normal/portable storage, then repeat formatting as adoptable/internal storage after updating to v1.20b+
  • Default ZRAM compression changed to LZ4 in kernel, but if you had previously forced a compression algorithm with persist.vendor.key2.zram.compressor, that manual override will persist. It is recommended to switch to LZ4 - see last section below.

Known Issues:

  • Haptic vibration weaker than kernel 4.4 ROMs
  • BB Hub Inbox missing notification actions, BB Notes crash, possibly other BB Hub app issues - will be fixed on v1.20c
  • Some users experience ghost Recents input spamming on kernel 4.19 - under investigation

Update Instructions:

  • You cannot update to this ROM if you are running a Krab-v1.20+ or Krab-2.0+ build unless you wipe userdata
  • If you are running ZKrab Key2 ROM from v1.9a-v1.11a: Download "lineage-22.2-20260907-UNOFFICIAL-zkrab-v1.20b-athena.zip" to your Key2 and perform local update through Settings/System/System updates/3-dot menu/Local update - Userdata wipe NOT needed!
    • You can return to v1.11a (kernel 4.4) with the same method if you experience issues with this build (again no userdata wipe needed)
  • If you are currently running stock Blackberry Android 8.1 or an older LineageOS version, download "LOS22_Key2_ZKrab-v1.9a.zip" to your PC and follow this guide for install instructions: https://daphnis-past-midnight.nekoweb.org/wiki/key2.html

Choose ZRAM Compression Algorithm

  • To switch to lz4 compression (other options are lzo and zstd, but lz4 is recommended):
    adb root
    adb shell setprop persist.vendor.key2.zram.compressor lz4
    adb reboot
    (after reboot confirm change with:)
    adb root
    adb shell cat /sys/block/zram0/comp_algorithm

LOS22_Key2_ZKrab-v1.11a

Choose a tag to compare

@zapaca zapaca released this 28 Aug 15:10
d849c5b

Changes:

  • Add new FM Radio app (based on https://github.com/iusmac/RevampedFMRadio):
    • Improved UI/UX, “Material You” colours, dark/light theme support, media player notification
    • Allows routing audio to Bluetooth
    • Allows playing without wired headphones as antenna (only works if station reception is strong enough)
  • Old Qualcomm FM Radio app kept and renamed to “FM Radio Legacy”
  • Settings/System/Blackberry keyboard: Add independent keyboard and button backlight timeouts and “only light on press” toggles, fixed timeout bugs, removed “Always on” from timeout selection
  • App switcher screen: Remove unnecessary padding for on-screen nav buttons when using hardware nav buttons
  • Status bar: Smaller right-side padding and symmetrical left-side padding
  • Wifi: Enable WPA3-SAE authentication (thanks to iMasterProX for the contribution and testing)

Update Instructions:

  • Perform an OTA update on your Key2 through Settings/System/System updates (the OTA update is downloaded from this Github Release page)
  • You cannot update to this ROM if you are running a Krab-v1.20*/v1.21*/v2.0* build unless you wipe userdata
  • If you are currently running stock Blackberry Android 8.1, Krab-v1.1-v1.8, or an older LineageOS version, download "LOS22_Key2_ZKrab-v1.11a.zip" to your PC and follow this guide for install instructions: https://daphnis-past-midnight.nekoweb.org/wiki/key2.html

LOS22_Key2_ZKrab-v1.10a

Choose a tag to compare

@zapaca zapaca released this 04 Aug 19:25
d849c5b

Changes:

  • Enable FM radio and add Qualcomm FM Radio app
  • Enable formatting external storage (SD card) as adoptable storage (Settings/Storage/[SD card]/Format/Format another way) - Not recommended unless you absolutely need more app storage space!
  • Disable AAC codec for known problematic Bluetooth devices, add problematic BMW Bluetooth OUI prefix to disable-AAC list
  • Increase screen brightness threshold for adaptive keyboard backlight shutoff (from ~70% to ~80% on screen brightness slider)
  • Decrease adaptive backlight floor for navigation buttons (from 0.1-1.0 to 0.01-1.0 screen brightness mapping)
  • FIXED: Phone earpiece and voice assistant/"Hey Google" intermittently not working when the latter is enabled
  • FIXED: Yellow flashlight/torch (now white like on stock BB Android 8.1)
  • Revert kernel charging configuration back to stock BB Android 8.1
  • August 2026 Android platform security patch

Update Instructions:

  • Perform an OTA update on your Key2 through Settings/System/System updates (the OTA update is downloaded from this Github Release page)
  • You cannot update to this ROM if you are running a Krab-v1.20+ or Krab-2.0+ build unless you wipe userdata
  • If you are currently running stock Blackberry Android 8.1, Krab-v1.1-v1.8, or an older LineageOS version, download "LOS22_Key2_ZKrab-v1.10a.zip" to your PC and follow this guide for install instructions: https://daphnis-past-midnight.neocities.org/wiki

LOS22_Key2_ZKrab-v1.9a

Choose a tag to compare

@zapaca zapaca released this 24 Jul 16:05
89e8f96

Overview

  • LineageOS-22.2
  • Kernel: 4.4.302
  • Device target: Blackberry KEY2 (athena)

Changes (compared to Krab-v1.8a):

  • Set updater URL to Github Lineage-BBKey2/distribution repository for future OTA updates
  • July 2026 Android platform security patch
  • Enable installing unmodified Blackberry Keyboard app from an apk or from: https://play.google.com/store/apps/details?id=com.blackberry.keyboard (thanks to wumbomumbo for contribution)
  • Update brand, device, manufacturer, model names to blackberry, bbf100, Blackberry, KEY2 (matches closer to stock firmware, allows unpaid use of BlackBerry Hub+ apps, avoids model showing as "BlackBerry Blackberry KEY2" in some cases) (thanks to wumbomumbo for contribution)
  • More gradual control of media, call, ring, notification volumes (double previous number of volume increments) (thanks to wumbomumbo for contribution)
  • Add extra frame buffer to reduce UI animation stutter (increased input latency might be noticed) (thanks to wumbomumbo for contribution)
  • Bluetooth A2DP hardware offload enabled (actual functionality not confirmed) (thanks to wumbomumbo for contribution)
  • IME Switcher: Make Alt+Enter the default (if updating from Krab-v1.8a you will need to correct your preference in Settings/System/Blackberry keyboard)
  • Unlock device by entering PIN with physical keyboard (no ALT key needed, no swiping up to reveal PIN entry page needed, can disable in Blackberry Keyboard Settings) (thanks to nozerorma for the idea in key2-tweaks app)
  • Enable/disable adaptive keyboard and navigation button backlight in Blackberry Keyboard Settings
  • Currency key on QWERTZ and AZERTY keyboards now produces Euro symbol
  • Default ZRAM size increase from 1 GB to 3 GB
  • Default ZRAM swappiness decrease from 100 to 60
  • Enable lz4 ZRAM compression in kernel config (default compression algorithm is still lzo)
  • Introduce method to choose ZRAM compression algorithm with adb root commands (see "Choose ZRAM Compression Algorithm" section below)

Update Instructions:

  • You cannot update to this ROM if you are running a Krab-v1.20+ or Krab-2.0+ build unless you wipe userdata
  • If you are currently running Krab-v1.8a on your Key2, you can update to this ROM without wiping userdata by following these instructions:
    • 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.img
      • fastboot flash boot /path/to/recovery.img
      • fastboot reboot
    • Select 'Apply update' -> 'Apply update from adb'
    • adb sideload /path/to/lineage-22.2-20260724-UNOFFICIAL-zkrab-v1.9a-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.
    • Select 'Reboot system'
  • If you are currently running stock Blackberry Android 8.1 or an older LineageOS version, download "LOS22_Key2_ZKrab-v1.9a.zip" to your PC and follow this guide for install instructions: https://daphnis-past-midnight.neocities.org/wiki

Choose ZRAM Compression Algorithm

  • For example, to switch to lz4 compression:
    adb root
    adb shell setprop persist.vendor.key2.zram.compressor lz4
    adb reboot
    (after reboot confirm change with:)
    adb root
    adb shell cat /sys/block/zram0/comp_algorithm
  • lz4 compression was not extensively tested - users need to test benefits or downsides compared to default lzo