awesome-copycats/README.rst

116 lines
4.0 KiB
ReStructuredText

=====
Awesome WM Copycats
=====
A collection of power themes for Awesome WM 3.5+
---------
Beware! They're more awesome than they appear, it's just they're shy.
Notable features:
- Autohide widgets (*tell me only when you have to*)
- Autostart functionality
- Fast mpd and volume shortcuts (first time you see this trick in Awesome)
- Other fancy shortcuts for copying to the clipboard (goodbye clipboard managers!), toggle wiboxes, widgets popups, screenshots capture, moving clients
- Quake style dropdown terminal
- Calendar with current day highlighted and previous/next month switch with a click
- Elegant notifications for new mails, current song, volume level, hdd critical state, low battery
- Yahoo Weather integration
- Net carrier status notifier
- Full localization potential (just easily edit a few lines - look for 'stub' keywords)
- Colorful autoupdating icons
- Symbolic tag names
- TXT layouts
- PNG taskbar
- No borders when there's only one visible client
- Powerful volume bar
- Custom layouts
- Freedesktop menu
They're scattered all over the set, so try each theme and choose the one you enjoy the most.
Gallery
--------
**Multicolor** copycatted from tip_ [liked so much --> compulsory personal version]
.. image:: http://i.imgur.com/vBMn8C8.jpg
**Powerarrow Darker** copycatted from romockee_ [his one was stuck at v3.4]
.. image:: http://i.imgur.com/inRoOrg.png
**Steamburn** copycatted from ok100_ [it was so cool, but only for dwm]
.. image:: http://i.imgur.com/esHcVzj.jpg
**Blackburn**
.. image:: http://dotshare.it/public/images/uploads/553.png
**Dremora**
.. image:: http://dotshare.it/public/images/uploads/589.png
**Rainbow**
.. image:: http://i.imgur.com/Ae7hAsK.png
**Holo** suggested by amouly_
.. image:: http://dotshare.it/public/images/uploads/621.png
Notes
--------
**Do not** use without reading and modifying according to your preferences and system specs.
Fonts are Terminus (Multicolor, Powerarrow Darker) and Tamsyn (other ones).
Blackburn and Dremora use Icons_: **if you're running Debian/Ubuntu**, be sure to have bitmaps enabled (1_ 2_).
Except Multicolor and Powerarrow Darker, every theme has a colorscheme_ and uses Yawn_.
Blackburn and Holo use png topbars, supported screen width sizes are:
1024
1152
1280
1366
1440
1600
1680
1920
2560
if your screen don't match one of these widths, then you have to create a proper topbar, and put it into ``themes/*chosentheme*/icons/topbar``.
Freedesktop menu in use is just an example: feel free to modify ``freedesktop/freedesktop.lua``.
If you happen to get an error involving ``/home fs widget``, that's probably because you didn't properly set *$HOME* in your profile or something. Try replacing every occurrence with just ``/``, or some other argument defined in vicious readme_, section ``vicious.widgets.fs``.
**Have any suggestions?** Did you see some great stuff and you want me to put my paws on it? Feel free to email me, it might just be the next copycat!
Author
--------
Luke Bonham <dadasignificanulla [at] gmail [dot] com>
License
--------
If you like this work, you are free to use it as defined in BY-NC-SA_.
I only ask you to not remove my signatures, or to add a link to this repository if you make your own versions.
Let us spread some style, in order to make Awesome appearance awesome too!
.. _tip: http://theimmortalphoenix.deviantart.com/art/Full-Color-Awesome-340997258
.. _romockee: https://github.com/romockee/powerarrow-dark
.. _ok100: http://ok100.deviantart.com/art/DWM-January-2013-348656846
.. _amouly: https://bbs.archlinux.org/viewtopic.php?pid=1307158#p1307158
.. _Icons: https://github.com/copycat-killer/dots/tree/master/.fonts
.. _Yawn: https://github.com/copycat-killer/yawn
.. _1: http://weiwu.sdf.org/100921.html
.. _2: https://wiki.ubuntu.com/Fonts#Enabling_Bitmapped_Fonts
.. _colorscheme: https://github.com/copycat-killer/dots/tree/master/.colors
.. _readme: http://git.sysphere.org/vicious/tree/README
.. _BY-NC-SA: http://creativecommons.org/licenses/by-nc-sa/3.0/