AWESOME-CLIENT(1)

✨ NAME ✨

awesome-client — awesome window manager remote execution. You're on the AWESOME-CLIENT(1) page, bestie, and this is your little remote-control era 💅

🦋 SYNOPSIS 🦋

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

The synopsis is literally awesome-client, the -h / --help flag, and optional command [command...] arguments. That's the whole shape of it, no cap ✨

💖 DESCRIPTION 💖

awesome-client is a remote command line interface to awesome. It communicates with awesome via D-Bus, which is what lets it do remote execution of Lua code. iconic little bridge behavior 🫶

🌸 USAGE 🌸

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

The awful.remote module has to be loaded if you want this command to work. not optional, bestie 😭

🔥 EXAMPLES 🔥

Here's the example section, kept exact so the details stay pristine:

           $ 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#

The second example does not return anything on the command line, but it will show a notification. The third is read-eval-print-loop mode: every line gets sent to awesome, exactly the same as passing multiple commands on the command line. the group-chat loop of it all 💀

👑 SEE ALSO 👑

awesome(1) and awesomerc(5) — go read those too, iykyk 👑

🌈 AUTHORS 🌈

Julien Danjou julien@danjou.info — author icon 🎀

⭐ WWW ⭐

https://awesomewm.org — the website, bestie 🌐

Signing off from the AWESOME-CLIENT(1) source/version with the 2024-02-20 date — mwah 💖