From d8b78f78f3b3edc8a5bc7df69a26d587f7ef3052 Mon Sep 17 00:00:00 2001 From: Mark Date: Fri, 4 Nov 2022 22:17:45 -0700 Subject: [PATCH] Documentation --- config-template.lua | 9 ++++++++- modules/README.md | 25 +++++++++++++++++++++++-- 2 files changed, 31 insertions(+), 3 deletions(-) diff --git a/config-template.lua b/config-template.lua index 55dce40..e9f7824 100755 --- a/config-template.lua +++ b/config-template.lua @@ -1,12 +1,19 @@ local config = {} +-- Copy this file to `config.lua` before starting awesome. + +-- To enable a module, add a line like the ones below. +-- To disable a module, delete its config table or set +-- enabled to false. + +config.picom = { enabled = true } +config.lock = { enabled = true, type = "i3lock"} config.battery = { enabled = false } config.backlight = { enabled = false } config.simple_widgets = { enabled = true } config.launcher = { enabled = true } config.screenshot = { enabled = true } config.keymap_popup = { enabled = true } -config.lock = { enabled = true, type = "i3lock"} config.core = { wallpaper = "/home/assets/wallpapers/Themed/Stellaris/Gigapixel/City.png", diff --git a/modules/README.md b/modules/README.md index 65630f2..15b8737 100644 --- a/modules/README.md +++ b/modules/README.md @@ -1,8 +1,29 @@ -# Modules +# Mark's Awesomewm Config + +## Dependencies +Some features require extra tools. Tools each module requires are listed below. If a module is disabled, its tool is not needed. Applications required by `core` MUST be installed. + + - Core: `fish` + - Backlight: `xbacklight` + - Battery: `upower` + - Ibus: `ibus` + - Launcher: `rofi` + - Lock: `i3lock, imagemagick, scrot` or `lightdm` (For `dm-tool`), depending on configuration. + - MPC: `mpc` + - Picom: `picom` + - Screenshot: `flameshot`, `tesseract (and data)`, `xclip`, `lpr` + - Volume: `pamixer` + + +## Modules Modules are parts of this configuration that can be disabled. Nearly all features in this config are defined by a module. -## Organization +### Enable / Disable Modules + +See `config-template.lua` + +### Organization Every directory in `modules/` is a module. Modules cannot be in subdirectories. \ Each module directory MUST have an ``init.lua``, which returns a table. That table can contain anything, but a few keys are special: