docs: improve startup and config information
This commit is contained in:
Isaac Freund
parent
c7bc47d6d4
commit
53d4c12d41
2 changed files with 38 additions and 39 deletions
45
README.md
45
README.md
|
|
@ -42,48 +42,33 @@ installed:
|
||||||
*Note: NixOS users may refer to the
|
*Note: NixOS users may refer to the
|
||||||
[Building on NixOS wiki page](https://github.com/ifreund/river/wiki/Building-on-NixOS)*
|
[Building on NixOS wiki page](https://github.com/ifreund/river/wiki/Building-on-NixOS)*
|
||||||
|
|
||||||
Then run, for example,
|
Then run, for example:
|
||||||
```
|
```
|
||||||
zig build -Drelease-safe=true --prefix /usr/local install
|
zig build -Drelease-safe=true --prefix /usr install
|
||||||
```
|
```
|
||||||
to build and install the binaries and man pages to `/usr/local/bin` and
|
To enable experimental Xwayland support pass the `-Dxwayland=true` option as well.
|
||||||
`/usr/local/share/man`. To enable experimental Xwayland support pass the
|
|
||||||
`-Dxwayland=true` option as well.
|
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
River can either be run nested in an X11/wayland session or directly
|
River can either be run nested in an X11/wayland session or directly
|
||||||
from a tty using KMS/DRM.
|
from a tty using KMS/DRM.
|
||||||
|
|
||||||
River has no keybindings by default; mappings can be created using the `map`
|
On startup river will look for and run an executable file at one of the
|
||||||
command of `riverctl`. Generally, creating mappings and other configuration is
|
following locations, checked in the order listed:
|
||||||
done with a shell script. River will execute any arbitrary shell command passed
|
|
||||||
with the `-c` flag during startup. For example:
|
|
||||||
|
|
||||||
```
|
- `$XDG_CONFIG_HOME/river/init`
|
||||||
river -c /path/to/config.sh
|
- `$HOME/.config/river/init`
|
||||||
```
|
- `/etc/river/init`
|
||||||
|
|
||||||
An example script with sane defaults is provided [here](contrib/config.sh) in
|
Usually this executable init file will be a shell script invoking riverctl
|
||||||
the contrib directory.
|
to create mappings and preform other configuration. The init file path may
|
||||||
|
be overridden with the `-c` flag.
|
||||||
|
|
||||||
For a complete list of commands see the `riverctl(1)` man page.
|
An example init script with sane defaults is provided [here](example/init)
|
||||||
|
in the example directory and installed to `/etc/river/init`.
|
||||||
|
|
||||||
Keyboard configuration is not yet implemented in river, but since river uses
|
For a complete list of commands and documentation see the `riverctl(1)`
|
||||||
libxkbcommon you may use the following environment variables to set defaults:
|
man page.
|
||||||
|
|
||||||
- `XKB_DEFAULT_RULES`
|
|
||||||
- `XKB_DEFAULT_MODEL`
|
|
||||||
- `XKB_DEFAULT_LAYOUT`
|
|
||||||
- `XKB_DEFAULT_VARIANT`
|
|
||||||
- `XKB_DEFAULT_OPTIONS`
|
|
||||||
|
|
||||||
Possible values for these variables can be found in the `xkeyboard-config(7)`
|
|
||||||
man page. For example, to use a dvorak layout one could start river with
|
|
||||||
|
|
||||||
```
|
|
||||||
XKB_DEFAULT_LAYOUT="us(dvorak)" river
|
|
||||||
```
|
|
||||||
|
|
||||||
## Development
|
## Development
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -16,13 +16,9 @@ on wlroots and written in Zig.
|
||||||
# OPTIONS
|
# OPTIONS
|
||||||
|
|
||||||
*-c* _shell_command_
|
*-c* _shell_command_
|
||||||
Run a shell command or give the path to a script that will be run after
|
Override the default search paths for an init executable: instead
|
||||||
river's wayland server is initialized but before entering the main
|
_shell_command_ will be run with `/bin/sh -c`. See the *CONFIGURATION*
|
||||||
loop. You may use this to configure river and define keymaps using
|
section for more details.
|
||||||
*riverctl*(1), start programs such as a status bar, or perhaps run a
|
|
||||||
service manager. If the process started by this flag is still running
|
|
||||||
when river exits, river will send SIGTERM and and wait for it to
|
|
||||||
terminate.
|
|
||||||
|
|
||||||
*-l* _log_level_
|
*-l* _log_level_
|
||||||
Set the log level of river to a value from 0 to 7 with 0 being the
|
Set the log level of river to a value from 0 to 7 with 0 being the
|
||||||
|
|
@ -31,8 +27,20 @@ on wlroots and written in Zig.
|
||||||
|
|
||||||
# CONFIGURATION
|
# CONFIGURATION
|
||||||
|
|
||||||
Experimental XWayland support can be enabled on compile-time with the
|
On startup river will look for and run an executable file at one of the
|
||||||
_-Dxwayland=true_ flag.
|
following locations, checked in the order listed:
|
||||||
|
|
||||||
|
- $XDG_CONFIG_HOME/river/init
|
||||||
|
- $HOME/.config/river/init
|
||||||
|
- /etc/river/init
|
||||||
|
|
||||||
|
This executable init file will be run after river's wayland server is
|
||||||
|
initialized but before entering the main loop. If the process started by
|
||||||
|
this flag is still running when river exits, river will send SIGTERM and
|
||||||
|
and wait for it to terminate.
|
||||||
|
|
||||||
|
Usually this will be a shell script invoking *riverctl*(1) to create mappings,
|
||||||
|
start programs such as a status bar, and preform other configuration.
|
||||||
|
|
||||||
# ENVIRONMENT
|
# ENVIRONMENT
|
||||||
|
|
||||||
|
|
@ -45,6 +53,12 @@ The following environment variables are used to configure the keyboard. See
|
||||||
- XKB_DEFAULT_OPTIONS
|
- XKB_DEFAULT_OPTIONS
|
||||||
- XKB_DEFAULT_RULES
|
- XKB_DEFAULT_RULES
|
||||||
|
|
||||||
|
# EXAMPLES
|
||||||
|
|
||||||
|
Set the keyboard layout to colemak:
|
||||||
|
|
||||||
|
XKB_DEFAULT_LAYOUT="us(colemak)" river
|
||||||
|
|
||||||
# AUTHORS
|
# AUTHORS
|
||||||
|
|
||||||
Maintained by Isaac Freund <ifreund@ifreund.xyz> who is assisted by open
|
Maintained by Isaac Freund <ifreund@ifreund.xyz> who is assisted by open
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue