NAME

       awesome-client - awesome window manager remote execution

SYNOPSIS

       awesome-client [-h|--help] [command [command...]]

DESCRIPTION

       awesome-client is a remote command line interface to awesome. It communicates with awesome
       via D-Bus, allowing remote execution of Lua code.

USAGE

       awesome-client reads commands passed on the command line or from standard input and sends
       them via D-Bus to awesome. If rlwrap is installed, it will be used to provide a readline
       command line interface.

       The awful.remote module has to be loaded if you want this command to work.

EXAMPLES

           $ awesome-client 'return 1+1, "Hello, world"\
              double 2
              string "Hello, world"

           # The following does not return anything on the command line,
           # but will show a notification.
           $ awesome-client '
           > naughty = require("naughty")
           > naughty.notify({
           > title="CLI Notification",
           > text="This is a notification sent from the command line!"})
           > '

           # Entering read-eval-print-loop mode
           # This mode will send every line to awesome, exactly the same as passing
           # multiple commands on the command line.
           $ awesome-client
           awesome# return 1+1
              double 2
           awesome# return 1+1, "Hello, world"
              double 2
              string "Hello, world"
           awesome#

SEE ALSO

       awesome(1) awesomerc(5)

AUTHORS

       Julien Danjou julien@danjou.info

WWW

       https://awesomewm.org

                                            2024-04-01                          AWESOME-CLIENT(1)