The Brunch Configuration Menu can be accessed directly from Grub using the "ChromeOS (settings)" boot option or while logged into a TTY using the sudo edit-brunch-config command.

• To access TTY2, press Ctrl + Alt + F2 and login as chronos.

Once you've entered the Brunch Configuration Menu you will be greeted by several pages of options.

• Use the arrow keys to move the cursor up or down.
• Use the spacebar to select an option.
  • An empty set [ ] means the option is not selected.
  • A filled set [x] means the option has been selected.
• When you're ready to continue, press the Enter key.
  • You won't be able to go back, but this menu can be opened again later.
  • You do not need to select something from every page.

The first two pages of the Brunch Configuration Menu are for selecting Framework Options. These options act as patches and can be used to add more features or support to your installation, you can select multiple with the Spacebar, or use the Enter key to continue. Continue scrolling for details about what each option does.

Some device specific options can be enabled through brunch configuration menu:

• "enable_updates": allow native ChromeOS updates (use at your own risk: ChromeOS will be updated but not the Brunch framework/kernel which might render your ChromeOS install unstable or even unbootable),
• "pwa": use this option to enable the brunch PWA:
  • You can install the original one from https://sebanc.github.io/brunch-pwa/ or the ITESaurabh version available at: https://itesaurabh.github.io/brunch-pwa,
• "android_init_fix": alternative init to support devices on which the android container fails to start with the standard init,
• "mount_internal_drives": allows automatic mounting of HDD partitions in ChromeOS:
  • Android media server will scan those drives which will cause high CPU usage until it has finished, it might take hours depending on your data,
  • Partition label will be used if it exists,
• "chromebook_audio": enable audio on EOL chromebook devices using the brunch recommended recovery image,
• "native_chromebook_image": enable it to use brunch on a non-EOL chromebook using its official recovery image, make sure to also select the chromebook kernel version used by your device in ChromeOS,
• "broadcom_wl": enable this option if you need the broadcom_wl module,
• "iwlwifi_backport": enable this option if your intel wireless card is not supported natively in the kernel,
• "rtl8188eu": enable this option if you have a rtl8188eu wireless card/adapter,
• "rtl8188fu": enable this option if you have a rtl8188fu wireless card/adapter,
• "rtl8192eu": enable this option if you have a rtl8192eu wireless card/adapter,
• "rtl8723bu": enable this option if you have a rtl8723bu wireless card/adapter,
• "rtl8723de": enable this option if you have a rtl8723de wireless card/adapter,
• "rtl8723du": enable this option if you have a rtl8723du wireless card/adapter,
• "rtl8812au": enable this option if you have a rtl8812au wireless card/adapter,
• "rtl8814au": enable this option if you have a rtl8814au wireless card/adapter,
• "rtl8821ce": enable this option if you have a rtl8821ce wireless card/adapter,
• "rtl8821cu": enable this option if you have a rtl8821cu wireless card/adapter,
• "rtl88x2bu": enable this option if you have a rtl88x2bu wireless card/adapter,
• "rtbth": enable this option if you have a RT3290/RT3298LE bluetooth device,
• "ipts_touchscreen": enable support for ipts touchscreen (SP4/5/6/7,SB1/2),
• "ithc_touchscreen": enable support for ithc touchscreen (SP7+,SB3 and above),
• "goodix": improve goodix touchscreens support,
• "invert_camera_order": use this option if your camera order is inverted,
• "no_camera_config": if your camera does not work you can try this option which disables the camera config,
• "oled_display": enable this option if you have an oled display (use with kernel 5.10),
• "acpi_power_button": try this option if long pressing the power button does not display the power menu,
• "alt_touchpad_config": try this option if you have touchpad issues,
• "alt_touchpad_config2": another option to try if you have touchpad issues,
• "internal_mic_fix": fix for internal mic on some devices,
• "internal_mic_fix2": alternative fix for internal mic on some devices,
• "sysfs_tablet_mode": allow to control tablet mode from sysfs:
  • echo 1 | sudo tee /sys/bus/platform/devices/tablet_mode_switch.0/tablet_mode to activate it or use 0 to disable it,
• "force_tablet_mode": same as above except tablet mode is enabled by default on boot,
• "suspend_s3": disable suspend to idle (S0ix) and use S3 suspend instead,
• "advanced_als": default ChromeOS auto-brightness is very basic:
  • This option activates more auto-brightness levels (based on the Pixel Slate implementation).

Brunch has several precompiled kernels avaliable for users, you can select one from the Brunch Configuration Menu by highlighting the kernel you want, then pressing enter. If you are unsure which to choose, 5.4 is the default kernel for Brunch. Continue scrolling for more information about each avaliable option.

WARNING: Changing kernel can prevent you from logging into your ChromeOS account, in which case a powerwash is the only solution (Ctrl + Alt + Shift + R at the login screen). Therefore, before switching to a different kernel, make sure you have a backup of all your data.

Several kernels can be enabled throught the configuration menu:

• LTS kernels (6.1, 5.15, 5.10, 5.4, 4.19): use those kernels for non-chromebook devices, 6.1 is the default.
• Chromebook kernels (6.1, 5.15, 5.10, 5.4, 4.19): For Chromebook devices, select the same kernel version used by your device in ChromeOS.

These are optional parameters that are not needed by every user. Some commonly used options are selectable, and more can be input manually. If you do not need any command line parameters, you can just press Enter to skip these sections.

The most common kernel command line parameters are listed below:

• "enforce_hyperthreading=1": improve performance by disabling a ChromeOS security feature and forcing hyperthreading everywhere (even in crositini).
• "i915.enable_fbc=0 i915.enable_psr=0": if you want to use crouton (needed with kernel 5.4).
• "psmouse.elantech_smbus=1": fix needed for some elantech touchpads.
• "psmouse.synaptics_intertouch=1": enables gestures with more than 2 fingers on some touchpad models.

Additional kernel parameters can also be added manually from the configuration menu.

Brunch has a Verbose Mode, formerly called Debug Mode. Enabling this boot option will disable any selected Brunch Bootsplash and display a log while booting. This is particularly useful for debugging and solving issues that may prevent your system from booting. To enable Verbose Mode you must enter yes at the prompt, then press enter.

Brunch Bootsplashes can be selected using the Brunch Configuration Menu, these determine the logo visible while Brunch is booting. (before the ChromeOS logo appears) These bootsplashes will not appear if you have enabled Verbose Mode above. You can select any of these options with the Enter key.

The last page of the Brunch Configuration Menu will allow you to confirm your changes. Upon hitting enter, your PC will reboot. The next time you boot into Brunch, it will be a long boot. (Just like when you first installed) This is normal. If the options you selected were not correct, or you want to change things back, you can reopen the Brunch Configuration Menu and start over.

The easiest way to update Brunch and ChromeOS is to use the [Brunch PWA][brunch-pwa-info], although it's also possible to update manually.

To manually update Brunch and ChromeOS together:

• Download the latest Brunch release
• Download the latest recovery matching your install and extract the bin.
• Open a TTY with Crtl + Alt + F2 and login as chronos.
• Run the built in command to update Brunch.
  • Replace brunch_archive.tar.gz with the file's actual filename.
  • Replace recovery.bin with the file's actual filename.

sudo chromeos-update -r ~/MyFiles/Downloads/recovery.bin -f ~/MyFiles/Downloads/brunch_archive.tar.gz

• Restart ChromeOS after the update finishes.

Brunch and ChromeOS can also be updated with BiteDasher's Script

The easiest way to update ChromeOS is to enable the enable_updates framework option, then update directly from the Settings page.

To enable the framework option:

• Open a TTY with Crtl + Alt + F2 and login as chronos.
• Enter sudo edit-brunch-config to open the Brunch Configuration Menu described above.
• Select enable_updates with the spacebar, then continue through the menu with the enter key.
• When finished, the Brunch Configuration Menu will prompt to restart ChromeOS.
• Update from the standard ChromeOS settings page after rebooting.

The easiest way to update Brunch is to use the [Brunch PWA][brunch-pwa-info], although it's also possible to update manually.

To manually update Brunch:

• Download the latest Brunch release
• Open a TTY with Crtl + Alt + F2 and login as chronos.
• Run the built in command to update Brunch.
  • Replace brunch_archive.tar.gz with the file's actual filename.

sudo chromeos-update -f ~/MyFiles/Downloads/brunch_archive.tar.gz

• Restart ChromeOS after the update finishes.