14 files changed, 877 insertions, 0 deletions
diff --git a/scripts/clear-pacman-cache b/scripts/clear-pacman-cache
new file mode 100755
index 0000000..3891796
--- /dev/null
+++ b/scripts/clear-pacman-cache
@@ -0,0 +1,9 @@
+#!/bin/sh
+
+if [[ $UID -eq 0 ]]
+then
+    paccache -r
+    paccache -ruk0
+else
+    echo "You need to be root!"
+fi
diff --git a/scripts/get-volume.sh b/scripts/get-volume.sh
new file mode 100755
index 0000000..0696b6f
--- /dev/null
+++ b/scripts/get-volume.sh
@@ -0,0 +1,150 @@
+#!/bin/bash
+
+# This prints a character '♫' and the percentage of the actual volume.
+# ♫ = E299AB
+WITH_ICONS=false
+
+get_percentage() {
+    full_db=65.25
+    # -65.25 <= $db <= 0
+    db=$1
+    bc <<CALC scale=2
+(-$db)/$full_db
+CALC
+}
+
+get_icon() {
+    if [ "$volStatus" == "on" ]
+    then
+        echo "\fr♫"
+    else
+        echo "\f1♫"
+    fi
+}
+
+panel_volume()
+{
+
+    volStatus=$(amixer get Master | tail -n 1 | cut -d '[' -f 4 | sed 's/].*//g')
+    volLevel=$(amixer get Master | tail -n 1 | cut -d '[' -f 2 | sed 's/\%].*//g')
+    if $WITH_ICONS
+    then
+        headphone=$(amixer -c 0 contents | grep 'Headphone Jack' -A 2 | tail -n 1 | sed s/.*=//g)
+    else
+        headphone=""
+    fi
+
+    if $WITH_ICONS
+    then
+        if [ "$volStatus" == "on" ] && [ "$headphone" == "off" ];
+        then
+            icon="\fr ⮞"
+        elif [ "$volStatus" == "on" ] && [ "$headphone" == "on" ];
+        then
+            icon="\fr ⮜"
+        elif [ "$volStatus" == "off" ] && [ "$headphone" == "on" ];
+        then
+            icon="\fr ⮜"
+        elif [ "$volStatus" == "off" ] && [ "$headphone" == "off" ];
+        then
+            icon="\fr ⮝"
+        else
+            icon="\f1 ⮝"
+        fi
+    else
+        icon=$(get_icon)
+    fi
+
+    case $volLevel in
+        100)
+            if [ "$volStatus" == "on" ]
+            then 
+                echo "$icon" "\fr——————————\fr"
+            else 
+                echo "$icon" "\f8——————————\fr"
+            fi
+            ;;
+        [0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr—\f8—————————\fr"
+            else
+                echo "$icon" "\f1—\f8—————————\fr"
+            fi
+            ;;
+        1[0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr——\f8————————\fr"
+            else
+                echo "$icon" "\f1——\f8————————\fr"
+            fi
+            ;;
+        2[0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr———\f8———————\fr"
+            else
+                echo "$icon" "\f1———\f8———————\fr"
+            fi
+            ;;
+        3[0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr————\f8——————\fr"
+            else
+                echo "$icon" "\f1————\f8——————\fr"
+            fi
+            ;;
+        4[0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr—————\f8—————\fr"
+            else
+                echo "$icon" "\f1—————\f8—————\fr"
+            fi
+            ;;
+        5[0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr——————\f8————\fr"
+            else
+                echo "$icon" "\f1——————\f8————\fr"
+            fi
+            ;;
+        6[0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr———————\f8———\fr"
+            else
+                echo "$icon" "\f1———————\f8———\fr"
+            fi
+            ;;
+        7[0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr————————\f8——\fr"
+            else
+                echo "$icon" "\f1————————\f8——\fr"
+            fi
+            ;;
+        8[0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr——————————\f8—\fr"
+            else
+                echo "$icon" "\f1——————————\f8—\fr"
+            fi
+            ;;
+        9[0-9])
+            if [ "$volStatus" == "on" ]
+            then
+                echo "$icon" "\fr——————————\fr"
+            else
+                echo "$icon" "\f1——————————\fr"
+            fi
+            ;;
+    esac
+}
+
+panel_volume
diff --git a/scripts/hs-cycle-padding b/scripts/hs-cycle-padding
new file mode 100755
index 0000000..56fe802
--- /dev/null
+++ b/scripts/hs-cycle-padding
@@ -0,0 +1,21 @@
+#!/usr/bin/ruby
+
+file1 = "/tmp/herbst-padding-1"
+file2 = "/tmp/herbst-padding-2"
+
+pad1 = 'pad 0 0 0 0 0'
+pad2 = 'pad 0 0 20 0 200'
+pad3 = 'pad 0 0 0 0 150'
+
+files = [file1, file2].map{|f| File.exist? File.expand_path(f)}
+
+if files == [false, false]  # 0 files
+    system "herbstclient #{pad2}"
+    system "touch #{file1}"
+elsif files == [true, false]  # 1 file
+    system "herbstclient #{pad1}"
+    system "touch #{file2}"
+else           # 2 files
+    system "herbstclient #{pad3}"
+    system "rm #{file1} #{file2}"
+end
diff --git a/scripts/ix b/scripts/ix
new file mode 100755
index 0000000..47c3e2b
--- /dev/null
+++ b/scripts/ix
@@ -0,0 +1,3 @@
+#!/bin/bash
+curl -F 'f:1=<-' -F "ext:1=$1" ix.io  #| \
+    #xclip -i -selection clipboard
diff --git a/scripts/lock b/scripts/lock
new file mode 100755
index 0000000..4046b49
--- /dev/null
+++ b/scripts/lock
@@ -0,0 +1,18 @@
+#!/bin/bash
+
+bg=/tmp/screen.png
+lock_png=${HOME}/scripts/lock.png
+_backlight=$(xbacklight -get)
+backlight=${_backlight::2}
+
+scrot ${bg}
+#convert ${bg} -scale 25% -scale 400% ${bg}
+convert ${bg} -blur 0x2 -sharpen 1x4 ${bg}
+ 
+[[ -f ${lock_png} ]] && convert ${bg} ${lock_png} \
+			-gravity center -composite -matte \
+			${bg}
+xbacklight -set 10
+i3lock -u -n -i ${bg}
+rm ${bg}
+xbacklight -set $backlight
diff --git a/scripts/lock.png b/scripts/lock.png
new file mode 100644
index 0000000..62eb9e9
--- /dev/null
+++ b/scripts/lock.png
diff --git a/scripts/markdown-mine b/scripts/markdown-mine
new file mode 100755
index 0000000..6505be7
--- /dev/null
+++ b/scripts/markdown-mine
@@ -0,0 +1,64 @@
+#!/bin/bash
+
+begin_of_html() {
+    cat > "$1" <<EOF
+<!DOCTYPE html>
+<html>
+<head>
+<meta http-equiv="content-type" content="text/html; charset=utf-8">
+<style>
+html, body {
+    padding: 10px;
+    padding-left: 4%;
+    padding-right: 4%;
+    font-family: monospace;
+    font-size: 13px;
+}
+
+a {
+    text-decoration: none;
+    color: #ab2323;
+    font-size: 0.95em;
+    font-weight: bold;
+}
+
+h1 {
+    font-size: 32px;
+    padding:3px;
+}
+
+h2 {
+    border-bottom: 1px solid #dedede;
+    padding:1px;
+}
+</style>
+</head>
+<body>
+EOF
+}
+
+_OUTFILE="$2"
+_INFILE="$1"
+
+main() {
+    begin_of_html "$_OUTFILE"
+    /usr/bin/markdown "$_INFILE" >> "$_OUTFILE"
+    echo "</body>" >> "$_OUTFILE"
+}
+
+case $1 in
+    --help|-h)
+        echo "$0 file.md out.html"
+        exit 0
+        ;;
+    *)
+        if [[ $# -ne 2 ]]
+        then
+            echo "Invalid arguments!"
+            echo "$0 file.md out.html"
+        else
+            main
+        fi
+        exit 1
+        ;;
+esac
diff --git a/scripts/mlblog b/scripts/mlblog
new file mode 120000
index 0000000..84a2657
--- /dev/null
+++ b/scripts/mlblog
@@ -0,0 +1 @@
+/home/matias/Workspace/blog/bin/mlblog
+\ No newline at end of file
diff --git a/scripts/monserv b/scripts/monserv
new file mode 120000
index 0000000..38b3fa6
--- /dev/null
+++ b/scripts/monserv
@@ -0,0 +1 @@
+/home/matias/Workspace/other_projects/monserv/bin/monserv
+\ No newline at end of file
diff --git a/scripts/nm-connected-device b/scripts/nm-connected-device
new file mode 100755
index 0000000..c4fc24a
--- /dev/null
+++ b/scripts/nm-connected-device
@@ -0,0 +1,5 @@
+#!/bin/bash
+
+OUT=$(nmcli device wifi list | grep "^\*" | tail -n 1 | awk -e '{print $2,$8}')
+
+echo "network $OUT"
diff --git a/scripts/spawn b/scripts/spawn
new file mode 100755
index 0000000..6a30ee1
--- /dev/null
+++ b/scripts/spawn
@@ -0,0 +1,3 @@
+#!/bin/bash
+
+$@ 2>&1 >/dev/null & disown %1
diff --git a/scripts/sprunge b/scripts/sprunge
new file mode 100755
index 0000000..ba30dae
--- /dev/null
+++ b/scripts/sprunge
@@ -0,0 +1,2 @@
+#!/bin/bash
+curl -F sprunge=@- sprunge.us
diff --git a/scripts/terminal-colors b/scripts/terminal-colors
new file mode 100755
index 0000000..985cefb
--- /dev/null
+++ b/scripts/terminal-colors
@@ -0,0 +1,529 @@
+#!/usr/bin/env python
+
+"""2.2 John Eikenberry <jae@zhar.net> GPL-3+ http://zhar.net/projects/
+
+Copyright
+    Copyright (C) 2010-2013 John Eikenberry <jae@zhar.net>
+
+License
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+Description
+    My goal in writing this script was to provide all the functionality of all
+    the various perl/sh scripts found around the web in one place with some
+    additional bells and whistles.
+
+    It automatically detects 8, 16, 88, 256 color capabilities (via ncurses)
+    and displays the appropriate color charts. It can display the colors as
+    blocks or (2d) cubes optionally with color values overlaid in int or hex
+    values.  It can show the full rgb text string as well. It can also show the
+    display with a vertical (default) or horizontal orientation. It has the
+    option of additional padding and supports -h --help as well.
+
+    It also works as a utility for converting between 256 and 88 color values.
+
+Development
+    A note on coding style. I was playing around with using classes as simple
+    module-esque namespaces; i.e. having classes that have all staticmethods
+    and never get instatiated. As a side effect of this it makes calls at the
+    module level thus this script is not really importable, thus limiting
+    reuse.
+
+Contributors
+    Isaac Cammann <icammann@gmail.com> - cube display bugfix
+    Jan Larres <jan@majutsushi.net> - submitted patches for..
+        - compact rgb display
+        - use of color intensity to determine foreground contrast color
+        - 16 color SGR ANSI chart
+        - 88 color rgb display bugfix
+
+"""
+from __future__ import print_function
+
+__version__ = __doc__.split('\n')[0]
+
+import sys
+import curses
+from optparse import OptionParser, OptionGroup, make_option
+from math import ceil, sqrt
+from functools import wraps
+
+# output constants
+fg_escape = "\x1b[38;5;%dm"
+bg_escape = "\x1b[48;5;%dm"
+clear = "\x1b[0m"
+
+def _get_options(args):
+    """ Setup and parse options.
+    """
+    option_list = [
+        make_option("-b", "--block", action="store_true", dest="block",
+            default=True, help="Display as block format (vs cube) [default]."),
+        make_option("-c", "--cube-slice", action="store_true", dest="cube",
+            default=False, help="Display as cube slices (vs block)."),
+        make_option("-f", "--foreground", action="store_true",
+            dest="foreground", default=False,
+            help="Use color for foreground text."),
+        make_option("-l", "--rgb", action="store_true", dest="rgb",
+            default=False, help="Long format. RGB values as text."),
+        make_option("-n", "--numbers", action="store_true", dest="numbers",
+            default=False, help="Include color escape numbers on chart."),
+        make_option("-o", "--basiccodes", action="store_true",
+            dest="basiccodes", default=False,
+            help="Display 16 color chart with SGR ANSI escape codes."),
+        make_option("-p", "--padding", action="store_true", dest="padding",
+            default=False, help="Add extra padding (helps discern colors)."),
+        make_option("-v", "--vertical", action="store_true", dest="vertical",
+            default=True, help="Display with vertical orientation [default]."),
+        make_option("-x", "--hex", action="store_true", dest="hex",
+            default=False, help="Include hex color numbers on chart."),
+        make_option("-z", "--horizontal", action="store_true",
+            dest="horizontal", default=False,
+            help="Display with horizontal orientation."),
+        ]
+
+    parser = OptionParser(version=__version__, option_list=option_list)
+
+    convert_option_list = [
+        make_option("-r", "--256to88", action="store", dest="reduce",
+            metavar="N", type="int",
+            help="Convert (reduce) 256 color value N to an 88 color value."),
+        make_option("-e", "--88to256", action="store", dest="expand",
+            metavar="N", type="int",
+            help="Convert (expand) 88 color value N to an 256 color value."),
+        ]
+    group = OptionGroup(parser, "Conversion options")
+    group.add_options(option_list=convert_option_list)
+    parser.add_option_group(group)
+
+    (options, args) = parser.parse_args(args)
+    return options
+
+# instantiate global options based on command arguments
+options = _get_options(sys.argv[1:])
+# don't allow -f by itself
+options.foreground = options.foreground and (
+        options.numbers or options.hex or options.rgb )
+
+class _staticmethods(type):
+    """ Got tired of adding @staticmethod in front of every method.
+    """
+    def __new__(m, n, b, d):
+        """ turn all methods in to staticmethods.
+            staticmethod() deals correctly with class attributes.
+        """
+        for (n, f) in d.items():
+            if callable(f):
+                d[n] = staticmethod(f)
+        return type.__new__(m, n, b, d)
+
+def _cached(f):
+    """ Memoize function w/ no params
+    """
+    _cache = {}
+    def cache():
+        if None not in _cache:
+            _cache[None] = f()
+        return _cache[None]
+    return cache
+
+
+class term16(object):
+    """ Basic 16 color terminal.
+    """
+    __metaclass__ = _staticmethods
+
+    def label(n, esc):
+        """ color label for 256 color values
+        """
+        if options.numbers:
+            return esc(n) + "%3d " % n
+        elif options.hex:
+            return esc(n) + " %2x " % n
+        return esc(n) + "  "
+
+    def _render():
+        """ 16 color info
+        """
+        if options.foreground:
+            esc = lambda n: fg_escape % n
+        else:
+            esc = lambda n: bg_escape % n + fg_escape % (15 if n < 9 else 0)
+        return [[term16.label(n, esc) + clear for n in range(8)],
+                [term16.label(n, esc) + clear for n in range(8,16)]]
+
+    def basiccodes():
+        text = "  gYw  "
+        esc_code = "\x1b[%sm"
+        print(' ' * 17 + '     '.join([str(40 + n) + "m" for n in range(8)]))
+        fg_codes = ['0', '1']
+        for i in range(30, 38):
+            fg_codes.extend([str(i), "1;%d" % i])
+        for fg in fg_codes:
+            print("%5sm " % fg + esc_code % fg + text + clear + ' ', end='')
+            print(' '.join([esc_code % fg + esc_code % bg + text + clear
+                            for bg in range(40, 48)]))
+
+    def display():
+        """ display 16 color info
+        """
+        print("System colors:")
+        colors = term16._render()
+        padding='  ' if options.padding else ''
+        for r in colors:
+            print(padding.join(i for i in r))
+            if options.padding: print()
+
+
+class term256(term16):
+    """ eg. xterm-256
+    """
+
+    @_cached
+    def _rgb_lookup():
+        """ color rgb lookup dict
+        """
+        # color increment is based on xterm/rxvt palette
+        cincr = [0] + [95+40*n for n in range(5)]
+        color_rgb = [rgb(i, j, k)
+                for i in cincr for j in cincr for k in cincr]
+        color_rgb = dict(zip(range(16, len(color_rgb)+16), color_rgb))
+        greys = [rgb(*((n,)*3)) for n in range(8, 248, 10)]
+        greys = dict(zip(range(232, 256), greys))
+        color_rgb.update(greys)
+        return color_rgb
+
+    def _to_rgb(n):
+        """ Convert color value to rgb tuple.
+        """
+        return term256._rgb_lookup()[n]
+
+    def _rgb_color_table():
+        """ 256 color info
+        """
+        rgbl = term256._rgb_lookup()
+        label_num = "% 4d: "
+        label_val = "%s"
+        if options.foreground:
+            render = lambda n: fg_escape % n + label_num % n + \
+                    label_val % str(rgbl[n]) + clear
+        else:
+            render = lambda n: fg_escape % n + label_num % n + \
+                    fg_escape % (16 if rgbl[n].is_light() else 255) \
+                    + bg_escape % n + label_val % str(rgbl[n]) + clear
+        return [[render(n) for n in [i+j for j in range(6)]]
+                    for i in range(16, 256, 6)]
+
+    def _rgb_display():
+        """ display colors with rgb hex info
+        """
+        colors = term256._rgb_color_table()
+        padding='  ' if options.padding else ''
+        while colors:
+            rows, colors = colors[:6], colors[6:]
+            if not options.horizontal:
+                rows = zip(*rows)
+            for r in rows:
+                print(padding.join(i for i in r))
+                if options.padding: print()
+            print()
+
+    def _colors():
+        """ 256 color numbers
+        """
+        return [[i+j for j in range(6)] for i in range(16, 232, 6)]
+
+    def _greyscale():
+        """ 256 greyscale numbers
+        """
+        return [[i+j for j in range(12)] for i in range(232, 256, 12)]
+
+    def _render(palette):
+        """ compact 256 color info
+        """
+        if options.foreground:
+            esc = lambda n: fg_escape % n
+            render = lambda n: term256.label(n, esc) + clear
+        else:
+            esc = lambda n: fg_escape % \
+                    (16 if term256._to_rgb(n).is_light() else 255)
+            render = lambda n: bg_escape % n + term256.label(n, esc) + clear
+        return [[render(n) for n in i] for i in palette]
+
+    def _compact_display():
+        """ display colors in compact format
+        """
+        colors = term256._render(term256._colors())
+        if options.cube:
+            _cube_display(colors)
+        elif options.block:
+            _block_display(colors)
+        print()
+        greys = term256._render(term256._greyscale())
+        padding='  ' if options.padding else ''
+        for r in greys:
+            print(padding.join(i for i in r))
+            if options.padding: print()
+
+    def display():
+        """ display 256 color info (+ 16 in compact format)
+        """
+        if options.rgb:
+            print("Xterm RGB values for 6x6x6 color cube and greyscale.")
+            print()
+            term256._rgb_display()
+        else:
+            term16.display()
+            print()
+            print("6x6x6 color cube and greyscale:")
+            term256._compact_display()
+
+
+class term88(term16):
+    """ xterm-88 or urxvt
+    """
+
+    @_cached
+    def _rgb_lookup():
+        """ color rgb lookup dict
+        """
+        # color increment is based on rxvt palette
+        cincr = [0, 0x8b, 0xcd, 0xff]
+        color_rgb = [rgb(i, j, k)
+                for i in cincr for j in cincr for k in cincr]
+        color_rgb = dict(zip(range(16, len(color_rgb)+16), color_rgb))
+        greys = [rgb(*((n,)*3))
+                for n in [0x2e, 0x5c, 0x73, 0x8b, 0xa2, 0xb9, 0xd0, 0xe7]]
+        greys = dict(zip(range(80, 88), greys))
+        color_rgb.update(greys)
+        return color_rgb
+
+    def _to_rgb(n):
+        """ Convert color value to rgb tuple.
+        """
+        return term88._rgb_lookup()[n]
+
+    def _rgb_color_table():
+        """ 88 color info
+        """
+        rgbl = term88._rgb_lookup()
+        label_num = "% 4d: "
+        label_val = "%s"
+        if options.foreground:
+            render = lambda n: fg_escape % n + label_num % n + \
+                    label_val % str(rgbl[n]) + clear
+        else:
+            render = lambda n: fg_escape % n + label_num % n + \
+                    fg_escape % (16 if rgbl[n].is_light() else 87) \
+                    + bg_escape % n + label_val % str(rgbl[n]) + clear
+        return [[render(n) for n in [i+j for j in range(4)]]
+                    for i in range(16, 88, 4)]
+
+    def _rgb_display():
+        """ display colors with rgb hex info
+        """
+        colors = term88._rgb_color_table()
+        while colors:
+            rows, colors = colors[:4], colors[4:]
+            for r in zip(*rows):
+                print(''.join(i for i in r))
+            print()
+
+    def _render(palette):
+        """ 88 color info
+        """
+        if options.foreground:
+            esc = lambda n: fg_escape % n
+            render = lambda n: term88.label(n, esc) + clear
+        else:
+            esc = lambda n: fg_escape % \
+                    (16 if term88._to_rgb(n).is_light() else 87)
+            render = lambda n: bg_escape % n + term88.label(n, esc) + clear
+        return [[render(n) for n in i] for i in palette]
+                #for n in [i+j for j in range(4)]]
+                    #for i in range(16, 80, 4)]
+
+    def _colors():
+        """ 88 color numbers
+        """
+        return [[i+j for j in range(4)] for i in range(16, 80, 4)]
+
+    def _greyscale():
+        """ 88 greyscale numbers
+        """
+        return [range(80,88)]
+
+
+    def display():
+        """ display 16 + 88 color info
+        """
+        if options.rgb:
+            print("Xterm RGB values for 4x4x4 color cube and greyscale.")
+            print()
+            term88._rgb_display()
+        else:
+            padding = '  ' if options.padding else ''
+            term16.display()
+            print()
+            print("4x4x4 color cube and greyscale:")
+            colors = term88._render(term88._colors())
+            if options.cube:
+                _cube_display(colors)
+            elif options.block:
+                _block_display(colors)
+            print()
+            greys  = term88._render(term88._greyscale())
+            for r in greys:
+                print(padding.join(i for i in r))
+
+class rgb(tuple):
+    """ An RGB, (red, green, blue) tuple. Takes integers.
+    """
+    def __new__(cls, r, g, b):
+        """ We want 3 colors.
+        """
+        return super(rgb, cls).__new__(cls, (r,g,b))
+
+    def __str__(self):
+        """ Display in compact rgb format.
+        """
+        return "#%02x%02x%02x" % self
+
+    def is_light(self):
+        """ Is this color light (or dark).
+        """
+        red, green, blue = self[0], self[1], self[2]
+        intensity = red*0.2126 + green*0.7152 + blue*0.0722
+        return intensity > 127
+
+
+def _cube_display(colors):
+    """ Display color cube as color aligned flatten cube sides.
+    """
+    padding = '  ' if options.padding else ''
+    if options.horizontal:
+        def _horizontal(colors):
+            size = int(sqrt(len(colors)))
+            for n in (n*size for n in range(size)):
+                colors[n:n+size] = zip(*colors[n:n+size])
+            while colors:
+                rows, colors = colors[:size*2], colors[size*2:]
+                for n in range(size):
+                    print(padding.join(i
+                            for i in rows[n]+tuple(reversed(rows[n+size]))))
+                    if options.padding: print(padding)
+                if colors: print()
+        _horizontal(colors)
+    else: #options.vertical - default
+        def _vertical(colors):
+            size = int(sqrt(len(colors)))
+            top = [colors[n:len(colors):size*2] for n in range(size)]
+            bottom = [colors[n+size:len(colors):size*2]
+                    for n in reversed(range(size))]
+            for group in [top, bottom]:
+                for rows in group:
+                    for r in rows:
+                        print(padding.join(i for i in r), end=' ')
+                        if options.padding: print(padding, end=' ')
+                    if options.padding: print()
+                    print()
+        _vertical(colors)
+
+def _block_display(colors):
+    """ Display color cube as cube sides organized by color #s (default).
+    """
+    padding = '  ' if options.padding else ''
+    size = int(sqrt(len(colors)))
+    if not options.horizontal:
+        for n in (n*size for n in range(size)):
+            colors[n:n+size] = zip(*colors[n:n+size])
+    while colors:
+        half = size*(size//2)
+        rows, colors = colors[:half], colors[half:]
+        for n in range(size):
+            for r in rows[n:len(rows):size]:
+                print(padding.join(i for i in r), end=' ')
+                if options.padding: print(padding, end=' ')
+            if options.padding: print()
+            print()
+        if colors: print()
+
+def convert88to256(n):
+    """ 88 (4x4x4) color cube to 256 (6x6x6) color cube values
+    """
+    if n < 16:
+        return n
+    elif n > 79:
+        return 234 + (3 * (n - 80))
+    else:
+        def m(n):
+            "0->0, 1->1, 2->3, 3->5"
+            return n and n + n-1 or n
+        b = n - 16
+        x = b % 4
+        y = (b // 4) % 4
+        z = b // 16
+        return 16 + m(x) + (6 * m(y) + 36 * m(z))
+
+def convert256to88(n):
+    """ 256 (6x6x6) color cube to 88 (4x4x4) color cube values
+    """
+    if n < 16:
+        return n
+    elif n > 231:
+        if n < 234:
+            return 0
+        return 80 + ((n - 234) // 3)
+    else:
+        def m(n, _ratio=(4./6.)):
+            if n < 2:
+                return int(ceil(_ratio*n))
+            else:
+                return int(_ratio*n)
+        b = n - 16
+        x = b % 6
+        y = (b // 6) % 6
+        z = b // 36
+        return 16 + m(x) + (4 * m(y) + 16 * m(z))
+
+def _terminal():
+    """ detect # of colors supported by terminal and return appropriate
+        terminal class
+    """
+    curses.setupterm()
+    num_colors = curses.tigetnum('colors')
+    if num_colors > 0:
+        return {16:term16, 88:term88, 256:term256}.get(num_colors, term16)
+
+def main():
+    if options.reduce:
+        v = convert256to88(options.reduce)
+        # reconvert back to display reduction in context
+        print("%s (equivalent to 256 value: %s)" % (v, convert88to256(v)))
+    elif options.expand:
+        print(convert88to256(options.expand))
+    else:
+        term = _terminal()
+        if term is None:
+            print("Your terminal reports that it has no color support.")
+        else:
+            if options.basiccodes:
+                print("Basic 16 color chart with SGR ANSI escape codes.\n")
+                term16.basiccodes()
+            else:
+                term.display()
+
+if __name__ == "__main__":
+    main()
+
diff --git a/scripts/whoneeds b/scripts/whoneeds
new file mode 100755
index 0000000..6f8f23c
--- /dev/null
+++ b/scripts/whoneeds
@@ -0,0 +1,71 @@
+#!/bin/bash
+# whoneeds package : shows explicitly installed packages that require some package
+
+# we use associative arrays to get uniqueness for "free"
+typeset -A root_packages
+typeset -A walked_nodes
+query="$1"
+
+function walk_nodes () {
+    local package="$1"
+
+    # if we've walked this node before, skip. This drastically
+    # reduces overhead for a relatively cheap operation
+    [[ "${walked_nodes[$package]}" -eq 1 ]] && return 0
+    walked_nodes["$package"]=1
+
+    # we do this so that we can make a single call to pacman
+    # to get both bits of information that we require
+    result=( $(LC_ALL=c pacman -Qi "$package" | awk -F':' \
+      'BEGIN { tag = ""; dependents = ""; explicit = 0 }
+       {
+          # since the formatting of the pacman output is more for human
+          # consumption than programmatic, we find ourselves with the following need.
+          # if we have two fields, then we know we have a proper identifier on the line
+          # so we store the identifier as a current tag
+          # All identifier checks are made against the current tag, which allows us
+          # to deal with instances where "Required By" spans lines
+          if (NF == 2) { tag = $1 }
+          if (tag ~ /^Required By[ ]*$/) {  dependents = dependents $(NF) }
+          if ($1 ~ /^Install Reason $/ && $2 ~/^ Explicitly installed/) { explicit = 1 }
+       }
+       END { print explicit,dependents}') )
+
+    # and if we hit an issue retrieving package information
+    if [[ ${#result[*]} -lt 2 ]]; then
+            echo "error: could not get information on $package" 1>&2
+            exit 3
+    fi
+    if [[ ${result[0]} -eq 1 ]]; then
+        # we found an explicitly installed package that relies on
+        # the original query. Add it to our array, provided it isn't
+        # the original query, as that would be useless information
+        [[ "$query" != "$package" ]] && root_packages["$package"]=1
+    fi
+    if [[ "${result[1]}" != "None" ]]; then
+        # iterate over our 'Required By:' packages
+        dependents="${result[@]:1:${#result[*]}}"
+        for i in "$dependents"; do
+            walk_nodes "$i"
+        done
+    fi
+}
+
+if [ $# -ne 1 ]; then
+    echo "error: unexpected number of arguments" 1>&2
+    echo "Usage: $(basename $0) <package-name>"
+    exit 2
+fi
+
+walk_nodes "$1"
+echo "Packages that depend on [$query]"
+if [[ -n "${!root_packages[*]}" ]]; then
+    for pkg in "${!root_packages[@]}"; do
+        echo "  $pkg"
+    done | sort
+    exit 0
+fi
+echo "  None"
+exit 1
+
+# vim: set ts=4 sw=4 et: