155 lines
7.1 KiB
HTML
155 lines
7.1 KiB
HTML
<h1 id="awesome-awesome-wm-awesome">Awesome Awesome WM <a
|
||
href="https://github.com/sindresorhus/awesome"><img
|
||
src="https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg"
|
||
alt="Awesome" /></a></h1>
|
||
<blockquote>
|
||
<p>A curated list of high-quality tools/scripts/configs for Awesome
|
||
Window Manager.</p>
|
||
</blockquote>
|
||
<p>This guide was created because an out-of-the-box Awesome WM
|
||
experience is miserable, yet the WM quickly grows on those courageous
|
||
enough to tinker with it and weather version-incompatibility issues.
|
||
This guide was created for those who need a head start with their
|
||
awesome config.</p>
|
||
<p>One problem with Awesome WM is that newer versions of Awesome break a
|
||
lot of backwards compatibility. Many of the below libraries have been
|
||
updated to Awesome 4.2, ones that haven’t will not work with the latest
|
||
version of Awesome. A library written for Awesome 3.5 will not work with
|
||
Awesome 4.0 and one written for 3.4 will not work with either so make
|
||
sure the versions between your modules match. This in itself creates a
|
||
lot of frustration for users and a segmentation of Awesome user
|
||
base.</p>
|
||
<p>This repository tries to keep up to date, most of the tools listed
|
||
here are compatible with Awesome 4.0+, some 3.4-3.5 tools are listed if
|
||
they’re notable due to their use case or compatible with current version
|
||
of Awesome.</p>
|
||
<p>Inspired by the <a
|
||
href="https://github.com/sindresorhus/awesome">awesome</a> list
|
||
thing.</p>
|
||
<h2 id="contents">Contents</h2>
|
||
<ul>
|
||
<li><a href="#official-resources">Official Resources</a></li>
|
||
<li><a href="#pre-built-versions">Pre-Built Versions</a></li>
|
||
<li><a href="#configuration">Configuration</a></li>
|
||
<li><a href="#theming">Theming</a></li>
|
||
<li><a href="#widget-packs">Widget Packs</a></li>
|
||
<li><a href="#basic-widgets">Basic Widgets</a></li>
|
||
<li><a href="#productivity-widgets">Productivity Widgets</a></li>
|
||
<li><a href="#wanted">Wanted</a></li>
|
||
</ul>
|
||
<h2 id="official-resources">Official Resources</h2>
|
||
<ul>
|
||
<li><a href="https://github.com/awesomeWM/awesome">Main repository</a> -
|
||
Latest development build.</li>
|
||
<li><a href="http://awesome.naquadah.org/wiki/Main_Page">Wiki</a> -
|
||
While not terse, a very useful resource.</li>
|
||
</ul>
|
||
<h2 id="pre-built-versions">Pre-Built Versions</h2>
|
||
<ul>
|
||
<li><a
|
||
href="https://launchpad.net/~klaus-vormweg/+archive/ubuntu/awesome">Ubuntu/Mint</a>
|
||
- Use this PPA instead of official which tends to be very old.</li>
|
||
</ul>
|
||
<h2 id="configuration">Configuration</h2>
|
||
<ul>
|
||
<li><a href="http://wiki.linuxquestions.org/wiki/List_of_keysyms">Valid
|
||
Key Names</a> - Useful for figuring out things like <code>PgUp</code> is
|
||
actually called <code>Prior</code> so you can map your shortcuts.</li>
|
||
<li><a href="https://github.com/pw4ever/awesome-wm-config">Dynamic
|
||
Tagging</a> - Those numbered tags in upper-left corner can now be
|
||
renamed on the fly.</li>
|
||
<li><a href="https://github.com/lcpz/awesome-freedesktop">Menu
|
||
Replacement</a> - Unlike default menu that looks very basic compared to
|
||
other window managers, this menu replaces the original with a more
|
||
<code>Start</code>-like menu with icons.</li>
|
||
</ul>
|
||
<h2 id="theming">Theming</h2>
|
||
<ul>
|
||
<li><a href="https://github.com/copycat-killer/awesome-copycats">Awesome
|
||
Copycats</a> - A collection of well-polished themes with distinct look
|
||
and feel.</li>
|
||
<li><a href="https://github.com/actionless/awesome_config">Theme with
|
||
fancy features</a> - A beautiful theme with screenshots.</li>
|
||
<li><a href="https://github.com/worron/awesome-config">Another polished
|
||
theme</a> - A theme showing that you don’t have to settle for crappy
|
||
ASCII art visuals.</li>
|
||
<li><a href="https://github.com/4ban/awesome-ban">awesome-ban</a> - A
|
||
theme inspired by Copycats themes</li>
|
||
<li><a href="https://github.com/4ban/awesome-pro">awesome-pro</a> - Pro
|
||
theme updated to support Awesome 4.0</li>
|
||
<li><a href="https://github.com/Relz/awesome-wm-theme">Minimalist
|
||
theme</a> - Minimalist theme with high level of customization.</li>
|
||
<li><a href="https://github.com/chjj/compton">compton</a> -
|
||
High-performance compositor for those who like transparent windows.</li>
|
||
<li><a href="https://github.com/Elv13/radical">radical</a> - Fancy
|
||
generator for custom menus</li>
|
||
</ul>
|
||
<h2 id="widget-packs">Widget Packs</h2>
|
||
<ul>
|
||
<li><a href="https://github.com/atsepkov/awesome-zen">Awesome Zen</a> -
|
||
Collection of widgets with a consistent interface that hides when
|
||
they’re not relevant to declutter your desktop. Also includes utilities
|
||
for managing windows more effectively.</li>
|
||
<li><a href="https://github.com/streetturtle/awesome-wm-widgets">Awesome
|
||
WM Widgets</a> - Good options for battery, music, CPU/RAM, and Volume
|
||
widgets</li>
|
||
<li><a href="https://github.com/lcpz/lain">Lain</a> - Another set of
|
||
polished Widgets for Awesome</li>
|
||
<li><a href="https://github.com/vicious-widgets/vicious">Vicious</a> -
|
||
Contains modules that gather data about your system</li>
|
||
</ul>
|
||
<h2 id="basic-widgets">Basic Widgets</h2>
|
||
<ul>
|
||
<li><a href="https://github.com/Maato/volumeicon">Volume Icon</a> -
|
||
Stand-alone volume icon for lightweight WMs that fits well with
|
||
nm-applet (C).</li>
|
||
<li><a href="https://github.com/plotnikovanton/net_widgets">Network</a>
|
||
- A wireless + wired network widget that replaces nm-applet (Lua).</li>
|
||
<li><a href="https://github.com/NuckChorris/assault/">Battery</a> -
|
||
Stand-alone battery widget (C).</li>
|
||
<li><a href="https://github.com/ralluri/yawn">Weather</a> - Widget that
|
||
retrieves localized weather information from Yahoo.</li>
|
||
</ul>
|
||
<h2 id="productivity-widgets">Productivity Widgets</h2>
|
||
<ul>
|
||
<li><a href="https://github.com/cdump/awesome-calendar">Basic
|
||
Calendar</a> - Simple, but pretty calendar.</li>
|
||
<li><a href="https://github.com/alexander-yakushev/Orglendar">Calendar
|
||
w/ TODO</a> - (orglendar) A calendar + to-do list for awesome that reads
|
||
entries from a .org file (I have a cronjob dumping my Google Calendar to
|
||
that file) (Lua).</li>
|
||
<li><a href="https://github.com/optama/awmodoro">Pomodoro Timer</a> -
|
||
Hides clutter from the screen for 25 mins, replacing it with a progress
|
||
bar (Lua).</li>
|
||
<li><a
|
||
href="https://github.com/proteansec/awesome-scratch">awesome-scratch</a>
|
||
- A stashing area for window to declutter the workspace and easily
|
||
recall programs, doesn’t seem to be actively maintained</li>
|
||
</ul>
|
||
<h2 id="multi-monitor-and-docking-stations">Multi-Monitor and Docking
|
||
Stations</h2>
|
||
<ul>
|
||
<li><a href="https://github.com/dluksza/screenful">screenful</a> - An
|
||
extension that leverages udev to detect monitor
|
||
connection/disconnection</li>
|
||
<li><a href="https://github.com/wertarbyte/autorandr">autorandr</a> -
|
||
Automatically select xrandr display configuration based on connected
|
||
devices</li>
|
||
</ul>
|
||
<h2 id="other">Other</h2>
|
||
<ul>
|
||
<li><a href="https://github.com/wheatdog/awesome-termgrp">tmux
|
||
integration to manage terminal sessions</a></li>
|
||
<li><a href="https://github.com/RobSis/treesome">treesome</a> - no
|
||
longer maintained, a utility for splitting workspace in a manner similar
|
||
to TMUX</li>
|
||
</ul>
|
||
<h2 id="wanted">Wanted</h2>
|
||
<ul>
|
||
<li>Widgets for CPU monitoring, polished mail integration.</li>
|
||
<li>Audio/MPD integration that’s not overly complex like AwsoMPD (which
|
||
is somewhat bloated and buggy).</li>
|
||
<li>More theme bundles to share (if you want to share your theme, I ask
|
||
that you attach a screenshot to your repo).</li>
|
||
</ul>
|