+Universal theme
+---------------
+
+The first irssi theme, called "universal", was designed to work best with both
+Solarized Dark and Light palettes, but also to work under default terminal
+colors. In other words, this theme was designed with a "fallback" scenario: if
+you happen to find yourself on a terminal where the Solarized palette has not
+been set up, you won't have elements become invisible or incrediby hard to
+read.
+
+Thus, this theme was designed with these 4 palettes in mind:
+
+- Solarized Dark: the theme works best when the terminal emulator is
+ set to this scheme
+- Solarized Light: the theme works, when the terminal emulator is set
+ to this scheme, almost as well as with Solarized Dark (you probably won't
+ notice the difference, but if you do, it could be optimized slightly by
+ switching the theme's use of some of the Solarized base colors)
+- Default terminal ANSI Colors with a dark background
+- Default terminal ANSI Colors with a light background
+
+This theme was designed to be clean and functional, starting from the default
+theme distributed with irssi. Colors are strictly used for functionality and
+the number of colors visible is minimized when possible. Colors were selected
+based on the characteristics of the text characters to be displayed:
+
+- Visibility generally follows importance, with an attempt to let unimportant
+ text fade into the background (which is not always possible when
+ simultaneously supporting dark and light backgrounds)
+- Loud colors are chosen to call attention to noteworthy messages
+
+### Supported Scripts ###
+
+The following third-party scripts are supported:
+
+- [adv\_windowlist.pl](http://anti.teamidiot.de/static/nei/*/Code/Irssi/)
+- [usercount.pl](http://scripts.irssi.org/html/usercount.pl.html)
+- [trackbar.pl](http://scripts.irssi.org/html/trackbar.pl.html)
+
+### Screenshots ###
+
+This is how the "universal" theme for irssi looks under different palettes.
+Click images to see screenshots.
+
+Solarized Dark (this example uses iTerm2 on OS X):
+
+[![Solarized Dark](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-irssi-in-iTerm2-solarized_dark-th.png)](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-irssi-in-iTerm2-solarized\_dark.png)
+
+Solarized Light (this example uses iTerm2 on OS X):
+
+[![Solarized Light](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-irssi-in-iTerm2-solarized_light-th.png)](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-irssi-in-iTerm2-solarized\_light.png)
+
+Default dark terminal colors (this example uses Apple's Terminal.app on OS X):
+
+[![default dark](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-irssi-in-Terminal.app-dark-th.png)](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-irssi-in-Terminal.app-dark.png)
+
+Default light terminal colors (this example uses iTerm on OS X):
+
+[![default light](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-irssi-in-iTerm-light-th.png)](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-irssi-in-iTerm-light.png)
+
+Downloads
+---------
+
+If you have come across these themes via the [irssi-only repository] on github,
+you may want to check the main [Solarized repository] to see if there is an
+official theme.
+
+In the future, the [irssi-only repository] may be kept in sync with the main
+[Solarized repository], but the [irssi-only repository] may be left separate
+for installation convenience and to include the latest improvements.
+
+At this time, issues, bug reports, changelogs are to be reported at the
+[irssi-only repository].
+
+[Solarized repository]: https://github.com/altercation/solarized
+[irssi-only repository]: https://github.com/huyz/irssi-colors-solarized
+
+
+Installation
+------------
+
+1. Configure your terminal emulator (See the section "Understanding Solarized Colors in
+ Terminals" for a detailed explanation behind these settings)
+
+ 1. Make sure that you have changed your terminal emulator's color settings to
+ the Solarized palette.
+
+ 2. Make sure that bold text is displayed using bright colors. For example,
+ - For iTerm2 on OS X, this means that Text Preferences must have the `Draw
+ bold text in bright colors` checkbox *selected*.
+ - For Apple's Terminal.app on OS X, this means that Text Settings must
+ have the `Use bright colors for bold text` checkbox *selected*.
+
+ 3. It's recommended to turn off the display of bold typeface for bold
+ text. For example,
+ - For iTerm2 on OS X, this means that Text Preferences should have the
+ `Draw bold text in bold font` checkbox *unselected*.
+ - For Apple's Terminal.app on OS X, this means that Text Settings
+ should have the `Use bold fonts` checkbox *unselected*.
+ - For XTerm, this may mean setting the `font` and `boldFont` to be the
+ same in your .Xresources or .Xdefaults, e.g.:
+
+ xterm*font: fixed
+ xterm*boldFont: fixed
+
+ Example: for iTerm2, these are the correct settings:
+
+ ![iTerm bold settings](https://github.com/huyz/irssi-colors-solarized/raw/master/img/screen-iTerm2-bold-options.png)
+
+2. Obtain `solarized-universal.theme`
+
+ a) Option A: Download `solarized-universal.theme` from [irssi-only repository]
+ and place it in your `~/.irssi` directory
+
+ b) Option B: To always have the latest version, clone the git repository:
+
+ $ git clone git://github.com/huyz/irssi-colors-solarized.git
+ $ ln -s $PWD/irssi-colors-solarized/solarized-universal.theme ~/.irssi/.
+
+3. Change your `~/.irssi/config` to include the following settings, while making
+ sure to replace `YOUR_NICKNAME` with your IRC nickname:
+
+ settings = {
+ ...
+ "fe-common/core" = {
+ ...
+ # Solarized
+ theme = "solarized-universal";
+ hilight_color = "= %R";
+ };
+ ...
+ };
+ hilights = (
+ { text = "YOUR_NICKNAME"; color = "%M"; nick = "yes"; word = "yes"; }
+ );
+ statusbar = {
+ ...
+ items = {
+ ...
+ # Solarized
+ lag = "{sb Lag: %m$0-%n}";
+ act = "{sb Act: $0-}";
+ more = "%k%3-- more --%n";
+ };
+ ...
+ };
+
+4. Optionally, if you have the `adv_windowlist.pl` or `trackbar.pl` scripts
+ installed, modify your `~/.irssi/config` so that:
+
+ settings = {
+ ...
+ "perl/core/scripts" = {
+ ...
+ ### For Solarized adv_windowlist.pl script
+ awl_display_key_active = "%k%2[$Q=$N:$C]%n";
+ awl_display_nokey_active = "%k%2[$N:$C]%n";
+ awl_display_key = "[$Q:$H$C$S]";
+ awl_display_nokey = "[$N:$H$C$S]";
+
+ ### For Solarized trackbar.pl script
+ trackbar_style = "%B";
+ };
+ ...
+ };
+