view release on metacpan or  search on metacpan

README  view on Meta::CPAN

        Maximum "loadavg" you expect before rescaling the chart. Default is
        1.

    "--order INDEXES"
        Specify the memory usage bar order. The default is "fwaic" ( free,
        wired, active, inactive & cached ).

    "--[no]tmux"
        Force "tmux" colors mode. By default, rainbarf detects automatically
        if it is being called from "tmux" or from the interactive shell.

    "--screen"
        screen(1)
        <http://manpages.ubuntu.com/manpages/hardy/man1/screen.1.html>
        colors mode. Experimental. See "CAVEAT".

    "--width NUMBER"
        Chart width. Default is 38, so both the chart and the battery
        indicator fit the "tmux" status line. Higher values may require
        disabling the battery indicator or raising the "status-right-length"
        value in ~/.tmux.conf.

    "--datfile FILENAME"
        Specify the file to log CPU stats to. Default: $HOME/.rainbarf.dat

    "--skip NUMBER"
        Do not write CPU stats if file already exists and is newer than this
        many seconds. Useful if you refresh "tmux" status quite frequently.

CAVEAT
  Time remaining
    If the "--remaining" option is present but you do not see the time in
    your status bar, you may need to increase the value of
    "status-right-length" to 48.

  Color scheme
    If you only see the memory usage bars but no CPU utilization chart,
    that's because your terminal's color scheme need an explicit distinction
    between foreground and background colors. For instance, "red on red
    background" will be displayed as a red block on such terminals. Thus,
    you may need the ANSI bright attribute for greater contrast, or maybe
    consider switching to the 256-color palette. There are some issues with
    that, though:

    1.  Other color schemes (notably, solarized
        <http://ethanschoonover.com/solarized>) have different meaning for
        the ANSI bright attribute. So using it will result in a quite
        psychedelic appearance. 256-color pallette, activated by the "--rgb"
        flag, is unaffected by that.

    2.  The older versions of Term::ANSIColor dependency do not recognize
        bright/RGB settings, falling back to the default behavior (plain 16
        colors). However, the whole Term::ANSIColor is optional, it is only
        required to preview the effects of the "OPTIONS" via command line
        before actually editing the ~/.tmux.conf. That is, "rainbarf
        --bright --tmux" is guaranteed to work despite the outdated
        Term::ANSIColor!

    Another option is skipping the system colors altogether and use the RGB
    palette ("rainbarf --rgb"). This fixes the *issue 1*, but doesn't affect
    the *issue 2*. It still looks better, though.

  Persistent storage
    CPU utilization stats are persistently stored in the ~/.rainbarf.dat
    file. Every rainbarf execution will update and rotate that file. Since
    "tmux" calls rainbarf periodically (every 15 seconds, by default), the
    chart will display CPU utilization for the last ~9.5 minutes (15 * 38).
    Thus, several "tmux" instances running simultaneously for the same user
    will result in a faster chart scrolling.

  screen
    Stable "screen" version unfortunately has a broken UTF-8 handling
    specifically for the status bar. Thus, I have only tested the rainbarf
    with the variant from <git://git.savannah.gnu.org/screen.git>. My
    ~/.screenrc contents:

     backtick 1 15 15 rainbarf --bright --screen
     hardstatus string "%1`"
     hardstatus lastline

REFERENCES
    *   top(1)
        <http://developer.apple.com/library/mac/documentation/Darwin/Referen
        ce/ManPages/man1/top.1.html> is used to get the CPU/RAM stats if no
        /proc filesystem is available.

    *   ioreg(8)
        <http://developer.apple.com/library/mac/documentation/Darwin/Referen
        ce/ManPages/man8/ioreg.8.html> is used to get the battery status on
        *Mac OS X*.

    *   ACPI <http://www.tldp.org/howto/acpi-howto/usingacpi.html> is used
        to get the battery status on *Linux*.

    *   Battery <https://github.com/Goles/Battery> was a source of
        inspiration.

    *   Spark <http://zachholman.com/spark/> was another source of
        inspiration.

AUTHOR
    Stanislaw Pusep <stas@sysd.org>

CONTRIBUTORS
    *   Chris Knadler <https://github.com/cknadler>

    *   cinaeco <https://github.com/cinaeco>

    *   Clemens Hammacher <https://github.com/hammacher>

    *   H.Merijn Brand <https://github.com/Tux>

    *   Henrik Hodne <https://github.com/henrikhodne>

    *   Joe Hassick <https://github.com/jh3>

    *   Josh Matthews <https://github.com/jmatth>

    *   Lars Engels <https://github.com/larsengels>

    *   Sergey Romanov <https://github.com/sergeyromanov>