devOS Wiki

Configuration Guide

Configuration

devOS includes a preconfigured environment designed to reduce manual setup. This page explains how each component is configured and how to customize it.

Trackpad

devOS configures the Apple trackpad for multi-touch gestures using libinput with custom acceleration curves.

Gestures

  • Two-finger scroll: Natural scrolling direction
  • Three-finger swipe: Workspace switching
  • Four-finger swipe: Application overview (via xfdashboard)
  • Pinch to zoom: Available in supported applications

Fine-tuning

Check ~/.config/libinput/local-overrides.quirks for gesture configurations.

Terminal

The default terminal uses Alacritty with GPU-accelerated rendering.

Edit ~/.config/alacritty/alacritty.yml to modify fonts, colors, or key bindings.

Zsh

Zsh is configured with Powerlevel10k for visual feedback on git status, command duration, and exit codes.

Run p10k configure to customize the prompt. Edit ~/.zshrc for additional aliases and plugins.

tmux

tmux is preconfigured with Vim-style navigation (Prefix + h/j/k/l).

Configuration is available in ~/.tmux.conf.

External Displays

Displays are auto-detected via xrandr. Use xrandr --output HDMI-1 --auto to enable.

Clamshell Mode

When an external display is connected and the lid is closed, devOS automatically transitions to clamshell mode. The internal display is disabled, the external display becomes primary, and the system remains awake.

This works via an ACPI handler combined with systemd-logind configured to ignore lid closure when an external display is active.