wayvncctl(1)                General Commands Manual               wayvncctl(1)

<?><?><?> (NAME)
       wayvncctl - <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> wayvnc(1)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       wayvncctl [options] [command [--parameter value ...]]

<?><?><?><?><?><?><?><?> (OPTIONS)
       -S, --socket=<path>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> wayvnc <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?>:
           $XDG_RUNTIME_DIR/wayvncctl <?><?> /tmp/wayvncctl-$UID

       -w, --wait
           <?><?><?> wayvnc <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?>: <?><?>
           <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           wayvnc<?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>.

       -r, --reconnect
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> wayvnc
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?>: <?><?><?><?><?> <?><?><?><?> wayvnc
           <?><?><?><?> <?><?><?><?><?><?>.

       -j, --json
           <?><?><?><?><?> JSON <?><?> <?><?> stdout <?><?><?><?><?>
           <?><?><?><?><?><?>.

       -V, --version
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

       -v, --verbose
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.

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

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> wayvnc(1) <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> json-ipc <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (self-documenting) <?><?><?>:

       o   <?><?><?><?><?> wayvncctl --help <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> IPC <?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       o   <?><?><?><?><?> wayvncctl command-name --help <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?>.
       o   <?><?><?><?><?> wayvncctl event-receive --help <?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       o   <?><?><?><?><?> wayvncctl event-receive --show=event-name
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (ASYNCHRONOUS EVENTS)
       <?><?> <?><?><?><?> <?><?> wayvncctl <?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> event-receive <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>. <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> wayvncctl <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?> stdout <?><?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> wayvnc
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?> <?><?><?><?> --json<?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?>:

           $ wayvncctl --json event-receive
           {"method":"client-connected","params":{"id":"0x10ef670","address":null,"username":null,"connection_count":1}}
           {"method":"client-disconnected","params":{"id":"0x10ef670","address":null,"username":null,"connection_count":0}}

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> YAML <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>:

           $ wayvncctl event-receive

           client-connected:
             id: 0x10ef670
             address: 192.168.1.18
             connection_count: 1

           client-disconnected:
             id: 0x10ef670
             address: 192.168.1.18
             connection_count: 0


   <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       (SPECIAL LOCAL EVENT TYPES)
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> --wait <?><?> --reconnect<?> <?><?><?><?><?> wayvncctl
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> wayvnc(1) <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>:

       wayvnc-startup
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> wayvnc
           <?><?><?><?><?><?> <?><?><?> <?> <?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?> --reconnect.

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

       wayvnc-shutdown
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> wayvnc <?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           wayvnc <?><?> <?><?><?><?><?><?>.

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

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> IPC
       <?><?> <?><?><?> "output-set":

           $ wayvncctl output-set --help
           Usage: wayvncctl [options] output-set <output-name> [params]
           ...

       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>:

           $ wayvncctl output-cycle

       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> JSON:

           $ wayvncctl --json version
           {"wayvnc":"v0.5.0","neatvnc":"v0.5.1","aml":"v0.2.2"}

       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>:

           #!/bin/bash

           connection_count_now() {
               echo "Total clients: $1"
           }

           while IFS= read -r EVT; do
               case "$(jq -r '.method' <<<"$EVT")" in
                   client-*onnected)
                       count=$(jq -r '.params.connection_count' <<<"$EVT")
                       connection_count_now "$count"
                       ;;
                   wayvnc-shutdown)
                       connection_count_now 0
                       ;;
               esac
           done < <(wayvncctl --wait --reconnect --json event-receive)

<?><?><?><?> (ENVIRONMENT)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> wayvncctl
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>:

       XDG_RUNTIME_DIR
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> wayvncctl <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       wayvnc(1)

                                  2026-07-19                      wayvncctl(1)