awesome/manpages/awesome-client.1.txt

68 lines
1.4 KiB
Plaintext

awesome-client(1)
=================
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