1AWESOME-CLIENT(1) AWESOME-CLIENT(1)
2
3
4
6 awesome-client - awesome window manager remote execution
7
9 awesome-client [-h|--help] [command [command...]]
10
12 awesome-client is a remote command line interface to awesome. It
13 communicates with awesome via D-Bus, allowing remote execution of Lua
14 code.
15
17 awesome-client reads commands passed on the command line or from
18 standard input and sends them via D-Bus to awesome. If rlwrap is
19 installed, it will be used to provide a readline command line
20 interface.
21
22 The awful.remote module has to be loaded if you want this command to
23 work.
24
26 $ awesome-client 'return 1+1, "Hello, world"\
27 double 2
28 string "Hello, world"
29
30 # The following does not return anything on the command line,
31 # but will show a notification.
32 $ awesome-client '
33 > naughty = require("naughty")
34 > naughty.notify({
35 > title="CLI Notification",
36 > text="This is a notification sent from the command line!"})
37 > '
38
39 # Entering read-eval-print-loop mode
40 # This mode will send every line to awesome, exactly the same as passing
41 # multiple commands on the command line.
42 $ awesome-client
43 awesome# return 1+1
44 double 2
45 awesome# return 1+1, "Hello, world"
46 double 2
47 string "Hello, world"
48 awesome#
49
51 awesome(1) awesomerc(5)
52
54 Julien Danjou julien@danjou.info
55
57 https://awesomewm.org
58
59
60
61 2023-07-19 AWESOME-CLIENT(1)