https://github.com/nylander/awesome
My settings for the tiling windows manager "awesome"
https://github.com/nylander/awesome
List: awesome
Last synced: 16 days ago
JSON representation
My settings for the tiling windows manager "awesome"
- Host: GitHub
- URL: https://github.com/nylander/awesome
- Owner: nylander
- License: gpl-2.0
- Created: 2021-01-29T12:14:18.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2026-01-15T12:46:44.000Z (5 months ago)
- Last Synced: 2026-01-15T16:57:15.421Z (5 months ago)
- Language: Lua
- Size: 646 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Settings for the awesome windows manager
- Last modified: 2025-12-12 10:34:40
- Sign: JN
## Description
Some notes about my settings of the [awesome window manager](https://awesomewm.org/).
## Installation
Tested on Ubuntu 22.04.3 LTS.
Note Dec 2025: The deb package provided by Ubuntu 22.04 is old and I recently had issues.
Try instead to [install from source](https://github.com/awesomeWM/awesome#debian-based).
# Old deb from apt sources would have been: `sudo apt install awesome awesome-extra`
# Build your own deb from source:
$ sudo apt install -y libxcb-xfixes0-dev feh
$ sudo apt build-dep awesome
$ git clone https://github.com/awesomewm/awesome
$ cd awesome
$ make package
$ cp build/awesome-*.deb /tmp
$ cd /tmp
$ sudo apt install ./awesome-*.deb
Also, make sure there is a file `/usr/share/xsessions/awesome.desktop`:
$ curl https://raw.githubusercontent.com/awesomeWM/awesome/master/awesome.desktop | sudo tee /usr/share/xsessions/awesome.desktop
## Local configuration
- [X] Change wallpaper to `~/.config/awesome/wallpapers/Baertling-Oradalki.jpg`
See
- [X] Set terminal to `x-terminal-emulator`
- [X] Set editor to `os.getenv("EDITOR") or "editor"`
- [X] Set webbrowser to `firefox`
- [X] Add volume widget ()
- [ ] Add wireless/network widget ()?
- [ ] Add bluetooth widget
- [ ] Add Debian menus (? ?, ?)
- [ ] Add battery indicator ()?
Commands:
$ cd ~/.config
$ git clone https://github.com/nylander/awesome.git
$ cd ~/.config/awesome
$ git clone https://github.com/streetturtle/awesome-wm-widgets.git
$ git clone https://github.com/pltanton/net_widgets.git
## Files
- `rc.lua` - The main user resource file. Put in `~/.config/awesome/`
- `theme.lua` - System theme file. Put in `/usr/local/share/awesome/themes/default/`
- `bin/termx` - Launcher of `gnome-terminal` with random profiles. Put in `~/bin/`.
- `wallpapers/` - Folder with Desktop backround images. Put in `~/.config/awesome/`
## Debugging
- `~/.xsession-errors` - Error messages for debugging.