---
name: "awesome-client"
section: "1"
platform: "linux"
package: "awesome"
version: "4.3-7"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/awesome-client"
---

# awesome-client(1)

awesome window manager remote execution

## 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)](/awesome/1.md) [awesomerc(5)](/awesomerc/5.md)

## AUTHORS

Julien Danjou  \<julien@danjou.info\>

## WWW

 \<https://awesomewm.org\>