Skip to content

Configuration GUI and plugin API for the Awesome window manager

License

Notifications You must be signed in to change notification settings

theasp/awesome-config

Repository files navigation

Awesome Configuration

This repository includes the following:

  • awesome-config - A GUI for manipulating the
  • crappy - A library for reading configuration files for Awesome

Crappy

Crappy reads a configuration file to configure Awesome 3.4.x or 3.5.x. Specifically tested on 3.4.11 and 3.5.5+. The goal of this is to be able to move between multiple versions of Awesome and maintain the same basic configuration in a relatively easy to edit file.

Installation from Git

Clone the repository anywhere you want:

git clone https://github.com/theasp/awesome-config.git

Backup your configuration directory:

cp -a ~/.config/awesome ~/.config/awesome.bak-$(date +%F-%T)

Make a symlink from your awesome config directory to the libraries:

ln -s $(pwd)/awesome-config/lib/* ~/.config/awesome/

Copy the example rc.lua and crappy-config.lua to your config directory:

cp awesome-config/examples/{crappy-config.lua,rc.lua} ~/.config/awesome/

Start awesome.

Installation from APT on Ubuntu

For the released version:

sudo add-apt-repository ppa:theasp/awesome-config

For the latest snapshot version:

sudo add-apt-repository ppa:theasp/awesome-config-snapshot

Then run:

sudo apt-get update
sudo apt-get install awesome-config

Backup your configuration directory:

cp -a ~/.config/awesome ~/.config/awesome.bak-$(date +%F-%T)

Copy the example rc.lua and crappy-config.lua to your config directory:

cp /usr/share/doc/awesome-config/examples/{crappy-config.lua,rc.lua} ~/.config/awesome/

Start awesome.

Configuration

You can use your own functions with crappy by defining or requiring them rc.lua before starting crappy, or using anonymous functions.

Awesome Config GUI

Run awesome-config to start the configuration GUI.

Manual Configuration

Edit .config/awesome/crappy-config.lua as desired.

A more detailed description of the configuration file is provided in the docs/config directory.

Plugin API

See the plugin API documentation in docs/plugins.

Code Used

About

Configuration GUI and plugin API for the Awesome window manager

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages