The devicewing command

devicewing ships inside the app at /Applications/Devicewing.app/Contents/SharedSupport/devicewing and opens the app if it is not running. To type just devicewing, link it onto your path:

ln -s /Applications/Devicewing.app/Contents/SharedSupport/devicewing /usr/local/bin/devicewing

Devices and the Board

devicewing status
devicewing devices                      # the devices Devicewing shows
devicewing simulators                   # their simulators
devicewing use ipad-mini                # switch device; or a simulator UDID or name
devicewing board on                     # or off
devicewing board devices iphone-18-pro ipad-mini iphone-duo
devicewing board lead ipad-mini
devicewing board sync on                # or off
devicewing board size true              # true size, or fit
devicewing board preset Angled          # save-preset Mine, delete-preset Mine
devicewing board capture ~/Desktop/compare

Turn and fold

devicewing pose book                    # flat | closed | book | laptop | tent
devicewing fold 90                      # 0 closed .. 180 open flat
devicewing rotate --y 30 --relative
devicewing rotate --z 90 --device ipad-mini
devicewing pose book --device iphone-duo
devicewing view --finish star-white --zoom 1.3
devicewing view --background '#2b2d5b,#c2577a'
devicewing view --theme dark --keep-on-top on --tool turn

--background takes theme, transparent, a swatch name such as ocean or amber, #rrggbb, a top and bottom colour #rrggbb,#rrggbb, or an image’s path.

Screen and input

devicewing capture screen.png           # the screen in use, upright, 1 px per point
devicewing describe                     # accessibility elements, in the same points
devicewing tap-element General          # by label, value or identifier
devicewing tap 120 340
devicewing swipe 300 600 300 200 --duration 0.4
devicewing pinch 300 400 100 300        # two fingers, 100 to 300 points apart
devicewing type 'hello world'           # --paste for exact text
devicewing key a command                # also return, delete, tab, escape, arrows
devicewing pasteboard 'some text'       # without text, reads it
devicewing button home                  # home | lock | side | top | action | siri | app_switcher | volume_up | volume_down
devicewing wait element About           # --gone for the opposite
devicewing wait idle

Apps and the simulator

devicewing install MyApp.app            # prints its bundle ID
devicewing launch com.example.MyApp --relaunch -- -SomeFlag YES
devicewing logs com.example.MyApp --seconds 30
devicewing terminate com.example.MyApp
devicewing apps                         # --all adds Apple's
devicewing uninstall com.example.MyApp
devicewing open https://example.com
devicewing appearance dark
devicewing statusbar --time 9:41 --battery-level 100   # statusbar clear removes it
devicewing location 37.33 -122.01       # location clear
devicewing permission grant photos com.example.MyApp
devicewing push com.example.MyApp '{"aps":{"alert":"Hello"}}'

Capture and record

devicewing screenshot shot.png          # the 3D view; --width/--height, or --fit
devicewing options --size wide --shadow on --caption 'Hello' --movie-format gif
devicewing shots poses                  # screens | both
devicewing move spin                    # sway | open | close; --preview plays without recording
devicewing record start ~/Movies/demo.mov --width 1920 --height 1080
devicewing record stop
devicewing record-screen start          # record-screen stop

devicewing options alone prints every capture option.