Chrultrabook DocsChrultrabook Docs
Documentation
Questions?
Documentation
Questions?
  • FAQ
  • Firmware
    • Finding System Info
    • Supported Devices
    • Known Issues
    • Developer Mode
      • Recovery Mode
    • Disabling Write Protect
      • Using a SuzyQable
      • Unplugging the Battery
    • Types of Firmware
    • Flashing Firmware
    • Updating Firmware
    • Compiling Custom Firmware
    • Flashing Manually
  • Installing an OS
    • Known Issues
    • Installing Windows
    • Installing Linux
      • Partitioning Instructions for Dual Booting
      • Notes for non-standard distros
        • Audio
          • alsa-ucm2 for Chromebooks
          • Audio setup modprobes
        • Keyboard mapping
          • libinput configuration
          • keyd keymap
    • Installing MacOS
      • Custom macOS firmware
      • Fixing Hibernation
    • Post Install
    • Using ectool
  • Debugging
    • Reporting Bugs
  • Unbricking
    • Unbricking with a ch341a USB Programmer
    • Unbricking with a Suzy-Q Cable
    • Unbricking with a Flipper Zero
  • Reverting to chromeOS
    • Flashing Stock Firmware
    • Making a Recovery USB
    • Booting the Recovery USB
  • Contributing

Notes for non-standard Linux distributions

Warning

Advanced users only!
This page is not meant for troubleshooting

Caution

We will not help you if you get stuck while using an unsupported distribution!

This page contains informations useful to get non-standard or niche Distros to work.

Audio

alsa-ucm2 for Chromebooks

You need custon alsa-ucm2 configs that arent available upstream

You can get them here

If your distro isnt FHS-compliant, you can specify the ucm location via an enviromental variable

export ALSA_CONFIG_UCM2 = "/share/alsa/ucm2";

Audio setup modprobes

You can find the right modprobe configs by browsing the audio script

Keyboard mapping

libinput configuration

Put this in /etc/libinput/local-overrides.quirks: (Source)

[keyd virtual keyboard]
MatchName=keyd virtual keyboard
AttrKeyboardIntegration=internal
ModelTabletModeNoSuspend=1

keyd keymap

Install keyd (Github)

A configuration file can be accuired with cros-keyboard-map. Some special cases have configs in the configs folder. For all other devices use cros-keyboard-map.py.

Last Updated:
Prev
Partitioning Instructions for Dual Booting