swaymsg(1)                  General Commands Manual                 swaymsg(1)

<?><?><?> (NAME)
       swaymsg - <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> sway <?><?> <?><?><?><?> <?><?><?><?>
       IPC.

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       swaymsg [options...] [message]

<?><?><?><?><?><?><?><?> (OPTIONS)
       -h, --help
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>.

       -m, --monitor
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> IPC <?><?> <?><?><?> subscribe <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?> swaymsg <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?>.

       -p, --pretty
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?> tty. <?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

       -q, --quiet
           <?><?><?><?><?> <?><?><?><?> IPC <?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> sway.

       -r, --raw
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> JSON
           <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> tty.

       -s, --socket <path>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?>. <?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?> swaymsg <?><?> sway <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> (<?><?> <?><?><?><?><?>
           <?><?><?><?><?> $SWAYSOCK <?> <?><?><?> $I3SOCK <?><?><?>).

       -t, --type <type>
           <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> IPC. <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       -v, --version
           <?><?><?> <?><?><?><?> (<?><?><?><?><?><?> swaymsg) <?>
           <?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?><?><?><?> IPC (IPC MESSAGE TYPES)
       <command>
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> sway
           <?><?><?> (<?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> sway <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>). <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?>.

           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> sway(5) <?><?><?><?><?><?>
           <?><?><?><?>.

           <?><?><?><?><?> swaymsg <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?> <?> <?><?><?><?>
           (<?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>) <?><?>
           <?><?> <?><?><?><?><?><?><?><?><?> JSON (--raw)
           <?><?><?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> JSON
           <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?> sway-ipc(7) <?><?><?><?><?><?>
           <?><?><?><?>. <?><?><?><?> JSON <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?> (pretty) <?><?><?><?>.

           <?><?><?><?>:
           o   <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?>: <?><?> <?><?><?> <?><?><?><?> swaymsg <?>
               <?><?><?> <?><?><?><?> <?><?><?><?> sway. <?><?><?> <?><?>
               <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?> <?><?><?> (single-quotes) <?><?><?><?>
               <?><?><?><?>. <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
               swaymsg 'output "Foobar Display" enable' <?><?><?><?><?><?>
               swaymsg output "Foobar Display" enable <?><?><?><?><?><?><?>
               <?><?><?><?>. <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
               <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
               <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
               <?><?><?><?><?><?><?> <?><?><?>.
           o   <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?><?><?>
               (-) <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
               <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> (--) <?><?><?>
               <?><?><?><?> <?><?> <?><?> swaymsg <?><?><?><?><?> <?><?><?>
               <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?>
               <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
               <?><?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?> swaymsg --
               mark --add test <?><?><?><?><?><?> swaymsg mark --add test
               <?><?><?><?><?><?><?> <?><?><?><?>.

       get_workspaces
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       get_inputs
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

       get_outputs
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

       get_tree
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> JSON <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?>.

       get_seats
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> seat<?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

       get_marks
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> JSON <?><?> <?><?><?><?><?><?><?><?> (marks) <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?>.

       get_bar_config
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> JSON <?><?> <?><?><?><?> swaybar <?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       get_version
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> sway <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

       get_binding_modes
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> JSON <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> (binding modes)
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?>.

       get_binding_state
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> JSON <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> (binding state) <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?>.

       get_config
           <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?><?> include <?><?> <?><?><?>
           <?><?><?><?><?><?><?>.

       send_tick
           <?><?> <?><?><?><?><?><?> tick <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.

       subscribe
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> JSON <?><?><?><?><?> <?><?><?>. <?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> JSON <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?>. <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> sway-ipc(7) <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?><?><?> (RETURN CODES)
       0
           <?><?><?><?><?><?>

       1
           <?><?><?><?><?><?> swaymsg <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> ipc <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> sway

       2
           <?><?><?><?> <?><?><?> <?><?> <?><?><?> sway <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?>)

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       sway(5) sway-bar(5) sway-input(5) sway-output(5) sway-ipc(7)

                                  2026-06-23                        swaymsg(1)