sway-autostart-i3ipc/README.md

43 lines
1 KiB
Markdown

# sway-autostart-i3ipc
A smart but also lazy login autostart manager for i3/Sway.
Will conditionally exec other things defined in a YML dict.
Required i3/Sway config line:
```bash
exec path/to/startup.py
```
## Requirements
### Fedora
```bash
sudo dnf -yq install python3-{i3ipc,pyxdg,pyyaml,systemd}
```
### Generic / pip
```bash
git clone git@github.com:joshlay/sway-autostart-i3ipc.git
pip3 install --user -r requirements.txt
```
## Config sample
```yaml
---
autostarts:
pre: [] # blocking tasks that run every day, before any other section. intended for backups/updates
common: [] # non-blocking tasks that run every day
weekend: [] # blocking tasks for Saturday/Sunday, after 'pre' but before 'common'
work: [] # non-blocking tasks run if Monday through Friday between 8AM - 4PM
```
The config may be chosen with `-c path/to/autostart.yml`.
The default is `XDG_CONFIG_HOME/autostart-i3ipc.yml` _(typically in ~/.config)_
Work day autostarts may be temporarily disabled by creating `~/.vacation`.
When desired again, remove the file.