We Make Learning & Building Easy

Bass builds are put together by using the Bass toolkit, which comes with an easy to use command line interface for customizing, configuring and compiling the OS.

Toolkit Features:

Toolkit Options & Usage:

$ . build/envsetup.sh && build-x86 --help

Usage: build-x86.sh [options]
Options:
-h, --help             Display this help dialog
-c, --clean            Clean the project
--nocleanconf          Do not clean the project configs that are changed in source
-d, --dirty            Run in dirty mode
-t, --title (title)    Set the release title
-b, --blissbuildvariant (variant)   Set the Bliss build variant
-i, --isgo             Enable isgo version
-v, --specialvariant (variant)      Set the special variant
--grubcmdline "option1=1 option2=1" Set the grub cmdline options
--production           Disable Test Build watermark and sign builds (requires release/product signature keys)
--checkproject         Check the project status

Launcher Options:
--clearhotseat         Enable clear hotseat favorites for Launcher3 Quickstep
--disablesearch        Disable device search
-s, --smartdock        Enable smartdock
--smartdockb           Enable smartdock with Bliss customizations
-k, --kiosk            Enable kiosk launcher **requires private git access**
--restrictedlauncher   Enable restricted launcher
--restrictedlauncherpro   Enable restricted launcher pro **requires private git access**
--garliclauncher       Enable garlic launcher
--gamemodelauncher     Enable game mode launcher
--crosslauncher        Enable cross launcher
--tvlauncher           Enable tv launcher
--titaniuslauncher     Enable titanius launcher
--desktoponsecondary   Enable desktop on secondary displays

Navigation Options:
-t, --tabletnav        Enable tablet navigation
--taskbarnav           Enable taskbar navigation
--gesturenav    Enable gesture navigation
--externalnav          Enable navigation on external displays
--rightmouseasback     Enable right mouse button as back

Package Options:
--noksu                Disable KernelSU
-f, --fossapps         Enable fossapps
--minfossapps          Enable minimal fossapps
--minfossmicrog        Enable minimal fossapps with microg
--usecalyxmicrog       Enable Calyx microg
--aurorastore          Enable Aurora store
-e, --supervanilla     Enable supervanilla
-m, --minimal          Enable minimal packages
-r, --removeusertools  Enable removeusertools
--viabrowser           Enable viabrowser
-w, --wiz              Enable Bliss setupwizard
--ethernetmanager      Enable EthernetManager
--powermanager         Enable power manager
--buildextra           Build extra packages
--updatefossapps       Update fossapps
--usepos               Enable TabShop pos terminal app
-p, --privateapp       Enable privateapps **requires private git access**
--ax86startmenu        Enable ax86 startmenu

Input Options:
--showkeyboard         Enable show keyboard
--perdisplayfocus      Enable per display focus (will display any IME on all displays)
--gboard               Enable Google GBoard IME
--gboardlite           Enable Google GBoard Lite IME
--perdisplayfocusime      Enable per display focus with experiment IME
--perdisplayfocuszqyime   Enable per display focus with ZQY IME

Firmware & Driver Options:
--sof                  Include SOF firmware
--silead               Include Silead firmware

Other Options:
-a, --atom             Include Intel Atom specific configurations
-l, --lockdown         Enable secure lockdown build
--adblockdown          Enable lockdown ADB defaults
-m, --manifest         Generate manifest
--alwaysonsettings     Enable always on settings
--nolarge              Disable large screen settings

Autogenerated Options:
--vapor          use vapor launcher
--sview          use screenview for mock-mirror mode applications
--pwir          use per window input rotation
--vndinput          use generated vendor input definition
--useblur          use SystemUI Blur effects

          

Below are a few combinations of the various command options put together in the form of Collections.

Bass-Desktop:

Desktop mode demo of Bass featuring SmartDock

bash build_bass.sh --clean --title "Bass" --blissbuildvariant vanilla --specialvariant "-Desktop" --ethernetmanager --minfossapps --tabletnav --clearhotseat --nolarge --supervanilla --minimal --alwaysonsettings --sof --silead --smartdock --wiz --aurorastore --usecalyxmicrog --privateapp --pwir --grubcmdline "BTLINUX_HAL=1 androidboot.force.win_as_home=1"
          

Bass-Restricted:

Restricted mode demo of Bass featuring Bliss Restricted Launcher

bash build_bass.sh --clean --title "Bass" --blissbuildvariant vanilla --specialvariant "-Restricted" --ethernetmanager --minfossapps --tabletnav --clearhotseat --nolarge --supervanilla --minimal --alwaysonsettings --sof --silead --restrictedlauncher --wiz --aurorastore --usecalyxmicrog --privateapp --pwir --grubcmdline "BTLINUX_HAL=1 androidboot.force.win_as_home=1"
          

Bass-Gammer-P:

Gaming focused demo of Bass featuring CrossLauncher

bash build_bass.sh --clean --title "Bass" --blissbuildvariant vanilla --specialvariant "-Gamer-P" --ethernetmanager --minfossapps --tabletnav --clearhotseat --nolarge --supervanilla --minimal --alwaysonsettings --sof --silead --crosslauncher --wiz --aurorastore --usecalyxmicrog --privateapp --pwir --grubcmdline "BTLINUX_HAL=1 androidboot.force.win_as_home=1"