awesome-client(1)

awesome-client1

Awesome window manager remote execution

Usage

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

Overview

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#

WWW

<https://awesomewm.org>

Releases

10 releases since Debian 5.0 (Lenny); the text changed 9 times.

  1. 5.0
  2. 6.0
  3. 7
  4. 8
  5. 9
  6. 10
  7. 11
  8. 12
  9. 13
  10. Arch

Authors

Julien Danjou <[email protected]>

From awesome 4.3-7 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.