Przejdź do treści

CLI OmarOS

OmarOS zwykle steruje się przez skróty oraz menu OmarOS (Super + Space). Ale możesz też sterować nim przez CLI omaros. Jest to szczególnie pomocne, gdy pracujesz z agentem AI nad dostosowywaniem lub konfiguracją.

CLI ma dostęp do wszystkich wewnętrznych narzędzi używanych zarówno z menu, jak i w inny sposób. Wszystko, co jest dostępne, zobaczysz, uruchamiając omaros w terminalu.

Wygląda to mniej więcej tak:

~ ❯ omaros
OmarOS command center

Usage:
  omaros <command> [args...]
  omaros commands [--all] [--json] [--check]
  omaros <group> --help
  omaros <group> <command> --help

Common commands:
  omaros update              Update OmarOS and system packages
  omaros theme list          List available themes
  omaros theme set <name>    Apply a theme
  omaros font list           List available fonts
  omaros screenshot          Take a screenshot
  omaros debug               Print debugging information

Groups:
  audio          Audio input and output controls
  bar            OmarOS shell bar layout and settings
  battery        Battery status helpers
  bluetooth      Bluetooth device controls
  branch         OmarOS git branch management
  branding       About and screensaver branding
  brightness     Display and keyboard brightness
  capture        Screenshots and screen recording
  channel        OmarOS release channel management
  clipboard      Clipboard helpers
  cmd            Command and shortcut helpers
  config         System configuration helpers
  debug          Diagnostics and support logs
  ...

A do każdej grupy możesz wejść głębiej:

~ ❯ omaros capture
Capture commands — Screenshots and screen recording:
  omaros capture qr                                                                                                                                                                                                       Decode a QR code from a screenshot region
  omaros capture screenrecording [--fullscreen] [--with-desktop-audio] [--with-microphone-audio] [--with-webcam] [--webcam-device=<device>] [--webcam-size=<small|medium|large>] [--resolution=<size>] [--stop-recording]  Start or stop screen recording
  omaros capture screenrecording with webcam                                                                                                                                                                              Pick a webcam and start a screen recording with it
  omaros capture screenshot [smart|region|windows|fullscreen|scroll] [copy|save]                                                                                                                                          Take a screenshot
  omaros capture text                                                                                                                                                                                                     Extract text from a screenshot region with OCR
  omaros capture webcam resize <smaller|larger|reset|small|medium|large>                                                                                                                                                  Resize the active webcam recording overlay

Każde polecenie przyjmuje też --help, niezależnie od tego, czy zapytasz całą grupę (omaros capture --help), czy pojedyncze polecenie (omaros capture screenshot --help).

Otwieranie menu z terminala

Menu OmarOS jest też skryptowalne, co jest przydatne do własnych przypisań klawiszy. omaros menu otwiera je u nasady, a możesz wskoczyć wprost do dowolnego punktu drzewa, nazywając go: omaros menu summon style.theme idzie od razu do wyboru motywu, omaros menu toggle system otwiera menu systemowe i zamyka je ponownie, jeśli jest już otwarte, a omaros menu close je chowa.