Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aarondill/awesome

My AwesomeWM configuration
https://github.com/aarondill/awesome

List: awesome

Last synced: 28 days ago
JSON representation

My AwesomeWM configuration

Awesome Lists containing this project

README 

        

## Theme for [AwesomeWM](https://awesomewm.org/)



### Original design by [PapyElGringo](https://github.com/PapyElGringo). Cloned from [ChrisTitusTech/titus-awesome](https://github.com/ChrisTitusTech/titus-awesome)



This repo is designed to be compatible with AwesomeWM latest (4.3) and the git HEAD.

I primarily use latest, so this may be undertested on HEAD.

If you notice any issues, please create an issue or PR!



An almost desktop environment made with [AwesomeWM](https://awesomewm.org/) with a performant opinionated keyboard workflow to increase daily productivity and comfort.



![](./theme/images/demo.png)



|             Fullscreen             |        Rofi Launcher         |             Exit Screen             |

| :--------------------------------: | :--------------------------: | :---------------------------------: |

| ![](./theme/images/fullscreen.png) | ![](./theme/images/rofi.png) | ![](./theme/images/exit-screen.png) |



## Installation



### `setup.lua`



For convenience, a `setup.lua` script has been provided, simply clone the repository and run `lua ./setup.lua` to auto install dependencies and setup submodules.



```shell

> git clone 'https://github.com/aarondill/awesome' ~/.config/awesome

> cd ~/.config/awesome/ && ./setup.lua

> # run lxappearance to modify theme if so desired

```



### Program List



- Arch:

  - [awesome](https://awesomewm.org/): AwesomeWM

  - [blueman](https://github.com/blueman-project/blueman): Bluetooth - System Tray

  - [brightnessctl](https://github.com/Hummer12007/brightnessctl): adjusting screen brightness with keyboard shortcuts

  - [diodon](https://github.com/diodon-dev/diodon): Persistent cliboard manager

  - [flameshot](https://flameshot.org): Screenshot tool

  - [i3lock](https://i3wm.org/i3lock/): Screen locker - `lock` script

  - [ibus](https://github.com/ibus/ibus): Changing input method - System Tray

  - [libinput](https://wayland.freedesktop.org/libinput/doc/latest/): Needed for libinput-gestures (touchpad gestures)

  - [libpulse](https://www.freedesktop.org/wiki/Software/PulseAudio/): Adjust volume with keyboard shortcuts

  - [network-manager-applet](https://apps.gnome.org): Network - System Tray

  - [numlockx](https://github.com/rg3/numlockx): Enable Numlock on startup

  - [pacutils](https://github.com/andrewgregory/pacutils): Get update count

  - [pasystray](https://github.com/christophgysin/pasystray): Audio system tray

  - [picom](https://github.com/yshui/picom): Compositor

  - [playerctl](https://github.com/altdesktop/playerctl): Control media players

  - [polkit-gnome](https://wiki.gnome.org/Projects/PolicyKit): Polkit

  - [qt5-styleplugins](https://github.com/qt/qtstyleplugins): Use GTK theme in Qt applications

  - [redshift](https://github.com/jonls/redshift): Automatically adjust screen temperature

  - [rofi-git](https://github.com/davatorium/rofi): Window switcher and application launcher - Git Version has some fixes

  - [ttf-roboto](https://fonts.google.com/specimen/Roboto): The primary font

  - [udiskie](https://github.com/coldfix/udiskie): Automatically mount removable media - System Tray

  - [xclip](https://github.com/astrand/xclip): Copy to clipboard

  - [xorg-xrandr](https://www.x.org/wiki/): xrandr - needed for autorandr, xset - disable DPMS

  - [xss-lock](https://bitbucket.org/raymonad/xss-lock/src/master/): Auto-lock on suspend/idle



- Debian / Ubuntu:

  - [awesome](https://awesomewm.org/): AwesomeWM

  - [blueman](https://github.com/blueman-project/blueman): Bluetooth - System Tray

  - [brightnessctl](https://github.com/Hummer12007/brightnessctl): adjusting screen brightness with keyboard shortcuts

  - [diodon](https://github.com/diodon-dev/diodon): Persistent cliboard manager

  - [flameshot](https://flameshot.org): Screenshot tool

  - [fonts-roboto](https://fonts.google.com/specimen/Roboto): The primary font

  - [i3lock](https://i3wm.org/i3lock/): Screen locker - `lock` script

  - [ibus](https://github.com/ibus/ibus): Changing input method - System Tray

  - [libinput-tools](https://wayland.freedesktop.org/libinput/doc/latest/): Needed for libinput-gestures (touchpad gestures)

  - [network-manager-gnome](https://apps.gnome.org): Network - System Tray

  - [numlockx](https://github.com/rg3/numlockx): Enable Numlock on startup

  - [pasystray](https://github.com/christophgysin/pasystray): Audio - System Tray

  - [picom](https://github.com/yshui/picom): Compositor

  - [playerctl](https://github.com/altdesktop/playerctl): Control media players

  - [policykit-1-gnome](https://wiki.gnome.org/Projects/PolicyKit): Polkit

  - [pulseaudio-utils](https://www.freedesktop.org/wiki/Software/PulseAudio/): Adjust volume with keyboard shortcuts

  - [qt5-style-plugins](https://github.com/qt/qtstyleplugins): Use GTK theme in Qt applications

  - [redshift](https://github.com/jonls/redshift): Automatically adjust screen temperature

  - [rofi](https://github.com/davatorium/rofi): Window switcher and application launcher

  - [udiskie](https://github.com/coldfix/udiskie): Automatically mount removable media - System Tray

  - [x11-xserver-utils](https://www.x.org/wiki/): xrandr - needed for autorandr, xset - disable DPMS

  - [xclip](https://github.com/astrand/xclip): Copy to clipboard

  - [xss-lock](https://bitbucket.org/raymonad/xss-lock/src/master/): Auto-lock on suspend/idle



## Set the theme (optional)



Install `lxappearance` to setup the _icon and GTK_ themes

Note: copy `~/.config/gtk3-0/settings.ini` to `~root/config/gtk3-0/settings.ini` to also show up in applications run as root



## Configuration:



All configuration should be possible through the `/configuration` directory.

Note that some of this has become complicated, so please report an issue if any arise.



## Running:



Start awesome you might start any other X window manager.



```shell

> startx "$(which awesome)"

```



If you cloned the repository to an unusual location, you can use awesome's `-c` option to start it

The configuration should handle this without issue.



```shell

startx "$(which awesome)" -c "/rc.lua"

```