awesomewm-mirrors
/
bling
mirror of https://github.com/BlingCorp/bling.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
bling/docs/home.md

1.4 KiB
Raw Permalink Blame History

🌟 Bling - Utilities for AwesomeWM 🌟

Why

AwesomeWM is literally what it stands for, an awesome window manager.

Its unique selling point has always been the widget system, which allows for fancy buttons, sliders, bars, dashboards, and anything you can imagine. But that feature can be a curse. Most modules focus on the widget side of things, which leaves the actual window managing part of AwesomeWM underdeveloped compared to, for example, xmonad, even though it's probably just as powerful in that area.

This project aims to fix that problem, adding new layouts and modules that make use of the widget system but primarily focusing on window managing features.

Installation

  • Clone this repo into your ~/.config/awesome folder
    • git clone https://github.com/BlingCorp/bling.git ~/.config/awesome/bling
  • Require the bling module in your rc.lua, making sure it's under the beautiful module initialization
-- other imports

local beautiful = require("beautiful")

-- other configuration stuff here

beautiful.init("some_theme.lua")
local bling = require("bling")

Contributors

A special thanks to all our contributors...

Made with contributors-img.