4uses
A desktop to spare, for whatever you're making.
Testing is where omabox started. Any job that needs a screen and shouldn't touch yours fits in a box too: these are a few we use it for.
● RECopen the panelscene 2
Film what you made
A demo of your app, plugin or feature, filmed in a box while you keep working. Your marks become captions; clicks and keys are drawn in.
$ omabox record start -o demo.mp4
$ omabox record mark "scene 2"
$ omabox record stop --show-input --captions
Aa1xAa3840x2160 · 2x
Shots at 2x, or 4K
A box is whatever size and scale you ask for, whatever your monitor is. Crisp shots and videos for a README, a store page or a talk.
$ omabox up --size 3840x2160,scale=2
$ omabox shot --window app
12:00 · alwaysa stock Omarchy
your bar and theme left out
A clean setup, not yours
A stock bar and theme, a clock that never moves, nothing on screen but what you show. Keep a terminal out of the shot: its prompt still has your user and host names.
$ omabox up --clean --stock-bar --theme tokyo-night
portraitscale 1.6
Monitors you don't have
Portrait, scaled, side by side or below. Plug and unplug them while the box runs, and see what your shell does.
$ omabox up --monitor 1080x1920 --monitor 2560x1440,scale=1.6,below
Look at a web page, off your screen
Your agent opens a site in the box's browser, pages down and reads the shots. No browser window lands on your desktop.
$ omabox run -d --wait -- chromium --app=URL
$ omabox keys Page_Down
a monitor gone and back, over and over
until something falls over
Find the crash first
Unplug a monitor again and again until your shell or plugin falls over, then read the backtrace. Your session never notices.
$ omabox output drop --cycles 50
$ omabox gdb --shell