Go to file
luke bonham f2953e3eae README updated 2015-05-21 20:13:53 +02:00
eminent holo: mpd update 2013-09-15 22:00:40 +02:00
lain@adc899ba1f README updated 2015-05-21 20:13:53 +02:00
menugen #61 wallpaper and menugen readded 2014-10-12 11:01:16 +02:00
scratchdrop lain: new commit 2014-10-11 14:48:52 +02:00
themes lain: new commit 2015-03-25 19:41:24 +01:00
.gitignore #61 wallpaper and menugen readded 2014-10-12 11:01:16 +02:00
.gitmodules copycats are back! v2.0 release 2013-09-13 21:20:22 +02:00
README.rst README updated 2015-05-21 20:13:53 +02:00
rc.lua.blackburn removed localizations; lain: new commit 2015-05-19 15:42:41 +02:00
rc.lua.copland removed localizations; lain: new commit 2015-05-19 15:42:41 +02:00
rc.lua.dremora removed localizations; lain: new commit 2015-05-19 15:42:41 +02:00
rc.lua.holo removed localizations; lain: new commit 2015-05-19 15:42:41 +02:00
rc.lua.multicolor removed localizations; lain: new commit 2015-05-19 15:42:41 +02:00
rc.lua.powerarrow-darker removed localizations; lain: new commit 2015-05-19 15:42:41 +02:00
rc.lua.rainbow removed localizations; lain: new commit 2015-05-19 15:42:41 +02:00
rc.lua.steamburn removed localizations; lain: new commit 2015-05-19 15:42:41 +02:00
switch-theme.sh switch-theme.sh: vim typos removed 2015-02-01 12:01:29 +01:00

README.rst

===================
Awesome WM Copycats
===================

--------------------------------
Power themes for Awesome WM 3.5+
--------------------------------

:Author: Luke Bonham <dada [at] archlinux [dot] info>
:Version: 2.0-git
:License: BY-NC-SA_
:Source: https://github.com/copycat-killer/awesome-copycats

Description
===========

A set of themes with the aim of making Awesome_ appearance awesome too!

Notable features
================

- Autohide widgets (*tell me only when you have to*)
- Autostart applications
- Fast MPD and volume shortcuts (first time you see this trick in Awesome)
- Other shortcuts for copying to the clipboard (goodbye clipboard managers!), toggle wiboxes, widgets popups, screenshots capture, moving and magnifying clients
- Quake drop-down terminal
- Calendar with current day highlighted and months 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
- Colorful autoupdating icons
- Symbolic tag names
- TXT layoutbox
- PNG wibox bar
- Custom layouts
- No borders when there's only one visible client
- Powerful volume bar
- Menubar menu
- Vi-like client focus
- Nice client border (colors change along with processes status)
- Non-empty tag browsing
- Dynamic useless gaps
- Dynamic tagging

Gallery
=======

**Multicolor** inspired by tip_

.. image:: http://dotshare.it/public/images/uploads/650.png

**Powerarrow Darker** inspired by romockee_

.. image:: http://dotshare.it/public/images/uploads/649.png

**Steamburn** copycatted from ok100_ [porting from dwm]

.. image:: http://dotshare.it/public/images/uploads/648.png

**Blackburn**

.. image:: http://dotshare.it/public/images/uploads/553.png

**Dremora**

.. image:: http://dotshare.it/public/images/uploads/652.png

**Rainbow**

.. image:: http://dotshare.it/public/images/uploads/606.png

**Holo** requested by amouly_

.. image:: http://dotshare.it/public/images/uploads/651.png

**Copland** inspired by foozer_

.. image:: http://dotshare.it/public/images/uploads/655.png

Installation
============

Using git you can have the full master branch: ::

    git clone --recursive https://github.com/copycat-killer/awesome-copycats.git

then, move the contents of `awesome-copycats` to `~/.config/awesome`.

Otherwise, download the latest two masters of ``awesome-copycats`` and ``lain`` (1_ and 2_), extract the first one, extract the second one into the first one, and put the contents of the first one into your Awesome directory.

Usage
=====

Switch a theme this way: ::

    cd ~/.config/awesome
    cp rc.lua.theme rc.lua

Alternatively, you can use `switch-theme.sh`_, which will also update to the latest commit.

Then customize your ``rc.lua`` and restart Awesome (``Mod4 + ctrl + r``).

Notes
=====

Only compatible with **stable** versions of Lua and Awesome (git/unstable versions are *not* supported).

Complements are provided by lain_: be sure to meet its dependencies_.

Fonts are Terminus_ (Multicolor, Powerarrow Darker) and Tamsyn_ (other ones).

Every theme has a colorscheme_.

Blackburn and Dremora use Icons_: be sure to have bitmaps enabled if running under Debian_ or Ubuntu_.

Feel free to email me if you have any request.

.. _BY-NC-SA: http://creativecommons.org/licenses/by-nc-sa/3.0/
.. _Awesome: http://awesome.naquadah.org/
.. _tip: https://bbs.archlinux.org/profile.php?id=51327
.. _romockee: https://github.com/romockee/powerarrow
.. _ok100: http://ok100.deviantart.com/art/DWM-January-2013-348656846
.. _amouly: https://bbs.archlinux.org/viewtopic.php?pid=1307158#p1307158
.. _foozer: http://dotshare.it/dots/499/
.. _1: https://github.com/copycat-killer/awesome-copycats/archive/master.zip
.. _2: https://github.com/copycat-killer/lain/archive/master.zip
.. _`switch-theme.sh`: https://github.com/copycat-killer/awesome-copycats/issues/36
.. _lain: https://github.com/copycat-killer/lain
.. _dependencies: https://github.com/copycat-killer/lain/wiki
.. _Terminus: http://terminus-font.sourceforge.net/
.. _Tamsyn: http://www.fial.com/~scott/tamsyn-font/
.. _colorscheme: https://github.com/copycat-killer/dots/tree/master/.colors
.. _Icons: https://github.com/copycat-killer/dots/tree/master/.fonts
.. _Debian: http://weiwu.sdf.org/100921.html
.. _Ubuntu: https://wiki.ubuntu.com/Fonts#Enabling_Bitmapped_Fonts