Skip to content

Keyboard, Mouse, Trackpad

Hyprland lets you configure all your inputs in great detail. You can change the keyboard repeat to be supersonically fast or make the trackpad use natural scrolling. You change all of it in ~/.config/hypr/input.lua, which you can also reach via Setup > Input in the OmarOS menu (Super + Space). Anything you set there replaces OmarOS's defaults.

Here's an example:

hl.config({
  input = {
    -- Use multiple keyboard layouts and switch between them with Alt + Shift
    kb_layout = "us,ara,dk",
    kb_options = "omaros:shift_caps_compose,grp:alt_shift_toggle",

    -- Change speed of keyboard repeat
    repeat_rate = 40,
    repeat_delay = 600,

    -- Increase sensitivity for mouse/trackpad (default: 0)
    sensitivity = 0.35,

    touchpad = {
      -- Use natural (inverse) scrolling
      natural_scroll = true,

      -- Use two-finger clicks for right-click instead of lower-right corner
      clickfinger_behavior = true,

      -- Control the speed of your scrolling
      scroll_factor = 0.3,
    },
  },
})

-- Scroll faster in the terminal
o.window("(Alacritty|kitty|foot)", { scroll_touchpad = 1.5 })

You can see all the input options on the Hyprland wiki for inputs.

CapsLock works as a normal Caps Lock, and Shift + CapsLock is the compose key for quick emojis and other completions. If you'd rather have the compose key elsewhere, replace omaros:shift_caps_compose in kb_options. For example, this moves the compose key to Right Alt:

hl.config({
  input = {
    kb_options = "compose:ralt",
  },
})

Trackpad gestures

You can also turn on touchpad gestures, like swiping with three fingers to change workspaces:

hl.gesture({ fingers = 3, direction = "horizontal", action = "workspace" })

On Dell XPS laptops with a haptic touchpad, you can also set the click strength to low, mid, or high under Trigger > Hardware > Touchpad Haptics.

Typing in Chinese, Japanese, and other languages

Select Japanese, Korean, Chinese (Simplified, Pinyin), Taiwan (Zhuyin), or Hong Kong (Cangjie) when the installer asks for your keyboard. OmarOS configures the keyboard and matching input engine automatically, including during offline first-boot setup. Japanese uses Mozc, Korean uses standard two-set Hangul, Simplified Chinese uses Pinyin, Taiwan uses Chewing's standard Zhuyin arrangement, and Hong Kong uses Cangjie with Hong Kong character forms. Japanese (US keyboard) provides Mozc with a US keyboard layout. Hangul, Zhuyin, and Cangjie keys stay in their standard positions even when you type Latin letters with Dvorak, Colemak, or AZERTY. If you added Hangul or Chewing before this, deselect and reselect it under Setup > Typing > Input Methods to move its keys there; OmarOS leaves an engine you already type with alone.

Typing starts in Latin mode. Press Super + I to cycle through configured input methods, and Super + Shift + I to cycle back. Tap Shift on its own to step out of an input method like Pinyin into Latin letters, and tap it again to go back, the way Sogou, Microsoft Pinyin, and macOS work; Shift plus a letter still types a capital. On Japanese keyboards, 全角/半角 toggles input, 変換 turns it on, and 無変換 turns it off. With Korean, 한/영 switches Hangul and 한자 converts to Hanja, whether your keyboard has dedicated keys or sends Right Alt and Right Ctrl for them, as many laptops do, so Right Alt and Right Ctrl are not plain modifiers there; dictation push-to-talk stays on F9. Ctrl + Space stays available for Tmux and Herdr; Shift + CapsLock stays the compose key.

The keyboard indicator appears on the right of the bar when you have multiple keyboard layouts or input methods. Click it to switch input languages; Japanese displays あ for hiragana. For Japanese character choices, switch to Japanese, type a word such as nihongo, then press Space twice. Press Enter to accept your choice. If you also have multiple keyboard layouts, right-click the indicator to cycle those.

Use Setup > Typing > Keyboard Layouts to select layouts such as English and French, from the same choices offered during installation. Use Setup > Typing > Input Methods to select which composition engines are active. Both pickers open inside the OmarOS menu with your current selections checked. Click or press Enter to toggle a choice; each change applies immediately. Deselecting an input method removes it from the cycle without uninstalling it; the keyboard remains available.

Run omaros setup keyboard or omaros setup input to open the same pickers. To append one language from the command line, use omaros setup input mozc, hangul, pinyin, chewing, or cangjie5. Quick, Boshiamy, and Array come in the same package as Cangjie and appear in the Input Methods picker. Your custom switching keys are preserved. For alternative engine layouts or keys, install fcitx5-configtool with omaros pkg add fcitx5-configtool and launch it from a terminal. Selecting an input language does not change the desktop language. Choosing Japanese, Korean, or Chinese under Setup > Language adds its input method when you have none yet.

Use Super + I to cycle through input methods or keyboard layouts, and Super + Shift + I to go back the other way, so with three configured you can move between two neighbours. The input indicator appears on the right of the bar only when more than one input method or layout is configured. This desktop binding works alongside your existing Fcitx switching keys; you can override it in ~/.config/hypr/bindings.lua. Input engines and the compose sequences use the Fcitx5 service already running in every session.

Use ALT as SUPER

On some keyboards, it's not convenient to use the primary meta key (Windows/cmd key) as SUPER. You can change this to be ALT instead using this change:

hl.config({
  input = {
    kb_options = "omaros:shift_caps_compose,altwin:swap_alt_win",
  },
})