{"id":13545087,"url":"https://github.com/creaktive/rainbarf","last_synced_at":"2025-05-16T03:04:54.847Z","repository":{"id":6669377,"uuid":"7914164","full_name":"creaktive/rainbarf","owner":"creaktive","description":"it's like Rainmeter, but for CLI!","archived":false,"fork":false,"pushed_at":"2022-06-03T18:10:40.000Z","size":160,"stargazers_count":1186,"open_issues_count":2,"forks_count":65,"subscribers_count":48,"default_branch":"master","last_synced_at":"2025-05-14T06:56:28.873Z","etag":null,"topics":["battery","chart","cpu","graph","memory","monitoring","powerline","rainmeter","tmux","widget"],"latest_commit_sha":null,"homepage":"https://metacpan.org/module/rainbarf","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/creaktive.png","metadata":{"files":{"readme":"README","changelog":"Changes","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-01-30T12:28:15.000Z","updated_at":"2025-05-10T19:34:07.000Z","dependencies_parsed_at":"2022-07-31T03:48:49.449Z","dependency_job_id":null,"html_url":"https://github.com/creaktive/rainbarf","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creaktive%2Frainbarf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creaktive%2Frainbarf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creaktive%2Frainbarf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creaktive%2Frainbarf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/creaktive","download_url":"https://codeload.github.com/creaktive/rainbarf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254459087,"owners_count":22074605,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["battery","chart","cpu","graph","memory","monitoring","powerline","rainmeter","tmux","widget"],"created_at":"2024-08-01T11:00:57.594Z","updated_at":"2025-05-16T03:04:49.840Z","avatar_url":"https://github.com/creaktive.png","language":"Perl","funding_links":[],"categories":["Perl"],"sub_categories":[],"readme":"NAME\n\n    rainbarf - CPU/RAM/battery stats chart bar for tmux (and GNU screen)\n\nVERSION\n\n    version 1.4\n\nSYNOPSIS\n\n     rainbarf --tmux --width 40 --no-battery\n\nDESCRIPTION\n\n    Fancy resource usage charts to put into the tmux\n    \u003chttp://tmux.sourceforge.net/\u003e status line. The CPU utilization history\n    chart is tinted with the following colors to reflect the system memory\n    allocation:\n\n      * green: free memory;\n\n      * yellow: active memory;\n\n      * blue: inactive memory;\n\n      * red: wired memory on Mac OS X / FreeBSD; \"unaccounted\" memory on\n      Linux;\n\n      * cyan: cached memory on Linux, buf on FreeBSD.\n\n      * magenta: used swap memory.\n\n    If available, battery charge is displayed on the right.\n\n    Just go to https://github.com/creaktive/rainbarf to see some\n    screenshots.\n\nUSAGE\n\n Installation\n\n      * Traditional way:\n\n       perl Build.PL\n       ./Build test\n       ./Build install\n\n      * Homebrew \u003chttp://brew.sh/\u003e way:\n\n       brew install rainbarf\n\n      * MacPorts \u003chttp://www.macports.org/\u003e way:\n\n       port install rainbarf\n\n      * CPAN way:\n\n       cpan -i App::rainbarf\n\n      * Modern Perl way:\n\n       cpanm git://github.com/creaktive/rainbarf.git\n\n Configuration\n\n    Add the following line to your ~/.tmux.conf file:\n\n     set-option -g status-utf8 on\n     set -g status-right '#(rainbarf)'\n\n    Or, under GNOME Terminal:\n\n     set-option -g status-utf8 on\n     set -g status-right '#(rainbarf --rgb)'\n\n    Reload the tmux config by running tmux source-file ~/.tmux.conf.\n\nCONFIGURATION FILE\n\n    ~/.rainbarf.conf can be used to persistently store \"OPTIONS\":\n\n     # example configuration file\n     width=20   # widget width\n     bolt       # fancy charging character\n     remaining  # display remaining battery\n     rgb        # 256-colored palette\n\n    \"OPTIONS\" specified via command line override that values.\n    Configuration file can be specified via RAINBARF environment variable:\n\n     RAINBARF=~/.rainbarf.conf rainbarf\n\nOPTIONS\n\n    --help\n\n      This.\n\n    --[no]battery\n\n      Display the battery charge indicator. Enabled by default.\n\n    --[no]remaining\n\n      Display the time remaining until the battery is fully charged/empty.\n      See \"CAVEAT\". Disabled by default.\n\n    --[no]bolt\n\n      Display even fancier battery indicator. Disabled by default.\n\n    --[no]bright\n\n      Tricky one. Disabled by default. See \"CAVEAT\".\n\n    --[no]rgb\n\n      Use the RGB palette instead of the system colors. Also disabled by\n      default, for the same reasons as above.\n\n    --fg COLOR_NAME\n\n      Force chart foreground color.\n\n    --bg COLOR_NAME\n\n      Force chart background color.\n\n    --[no]loadavg\n\n      Use load average \u003chttps://en.wikipedia.org/wiki/Load_(computing)\u003e\n      metric instead of CPU utilization. You might want to set the --max\n      threshold since this is an absolute value and has varying ranges on\n      different systems. Disabled by default.\n\n    --[no]swap\n\n      Display the swap usage. Used swap amount is added to the total\n      amount, but the free swap amount is not! Disabled by default.\n\n    --max NUMBER\n\n      Maximum loadavg you expect before rescaling the chart. Default is 1.\n\n    --order INDEXES\n\n      Specify the memory usage bar order. The default is fwaic ( free,\n      wired, active, inactive \u0026 cached ).\n\n    --[no]tmux\n\n      Force tmux colors mode. By default, rainbarf detects automatically if\n      it is being called from tmux or from the interactive shell.\n\n    --screen\n\n      screen(1)\n      \u003chttp://manpages.ubuntu.com/manpages/hardy/man1/screen.1.html\u003e colors\n      mode. Experimental. See \"CAVEAT\".\n\n    --width NUMBER\n\n      Chart width. Default is 38, so both the chart and the battery\n      indicator fit the tmux status line. Higher values may require\n      disabling the battery indicator or raising the status-right-length\n      value in ~/.tmux.conf.\n\n    --datfile FILENAME\n\n      Specify the file to log CPU stats to. Default: $HOME/.rainbarf.dat\n\n    --skip NUMBER\n\n      Do not write CPU stats if file already exists and is newer than this\n      many seconds. Useful if you refresh tmux status quite frequently.\n\nCAVEAT\n\n Time remaining\n\n    If the --remaining option is present but you do not see the time in\n    your status bar, you may need to increase the value of\n    status-right-length to 48.\n\n Color scheme\n\n    If you only see the memory usage bars but no CPU utilization chart,\n    that's because your terminal's color scheme need an explicit\n    distinction between foreground and background colors. For instance,\n    \"red on red background\" will be displayed as a red block on such\n    terminals. Thus, you may need the ANSI bright attribute for greater\n    contrast, or maybe consider switching to the 256-color palette. There\n    are some issues with that, though:\n\n      1. Other color schemes (notably, solarized\n      \u003chttp://ethanschoonover.com/solarized\u003e) have different meaning for\n      the ANSI bright attribute. So using it will result in a quite\n      psychedelic appearance. 256-color pallette, activated by the --rgb\n      flag, is unaffected by that.\n\n      2. The older versions of Term::ANSIColor dependency do not recognize\n      bright/RGB settings, falling back to the default behavior (plain 16\n      colors). However, the whole Term::ANSIColor is optional, it is only\n      required to preview the effects of the \"OPTIONS\" via command line\n      before actually editing the ~/.tmux.conf. That is, rainbarf --bright\n      --tmux is guaranteed to work despite the outdated Term::ANSIColor!\n\n    Another option is skipping the system colors altogether and use the RGB\n    palette (rainbarf --rgb). This fixes the issue 1, but doesn't affect\n    the issue 2. It still looks better, though.\n\n Persistent storage\n\n    CPU utilization stats are persistently stored in the ~/.rainbarf.dat\n    file. Every rainbarf execution will update and rotate that file. Since\n    tmux calls rainbarf periodically (every 15 seconds, by default), the\n    chart will display CPU utilization for the last ~9.5 minutes (15 * 38).\n    Thus, several tmux instances running simultaneously for the same user\n    will result in a faster chart scrolling.\n\n screen\n\n    Stable screen version unfortunately has a broken UTF-8 handling\n    specifically for the status bar. Thus, I have only tested the rainbarf\n    with the variant from git://git.savannah.gnu.org/screen.git. My\n    ~/.screenrc contents:\n\n     backtick 1 15 15 rainbarf --bright --screen\n     hardstatus string \"%1`\"\n     hardstatus lastline\n\nREFERENCES\n\n      * top(1)\n      \u003chttp://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man1/top.1.html\u003e\n      is used to get the CPU/RAM stats if no /proc filesystem is available.\n\n      * ioreg(8)\n      \u003chttp://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man8/ioreg.8.html\u003e\n      is used to get the battery status on Mac OS X.\n\n      * ACPI \u003chttp://www.tldp.org/howto/acpi-howto/usingacpi.html\u003e is used\n      to get the battery status on Linux.\n\n      * Battery \u003chttps://github.com/Goles/Battery\u003e was a source of\n      inspiration.\n\n      * Spark \u003chttp://zachholman.com/spark/\u003e was another source of\n      inspiration.\n\nAUTHOR\n\n    Stanislaw Pusep \u003cstas@sysd.org\u003e\n\nCONTRIBUTORS\n\n      * Chris Knadler \u003chttps://github.com/cknadler\u003e\n\n      * cinaeco \u003chttps://github.com/cinaeco\u003e\n\n      * Clemens Hammacher \u003chttps://github.com/hammacher\u003e\n\n      * H.Merijn Brand \u003chttps://github.com/Tux\u003e\n\n      * Henrik Hodne \u003chttps://github.com/henrikhodne\u003e\n\n      * Joe Hassick \u003chttps://github.com/jh3\u003e\n\n      * Josh Matthews \u003chttps://github.com/jmatth\u003e\n\n      * Lars Engels \u003chttps://github.com/larsengels\u003e\n\n      * Sergey Romanov \u003chttps://github.com/sergeyromanov\u003e\n\n      * Tom Cammann \u003chttps://github.com/takac\u003e\n\n      * Tuomas Jormola \u003chttps://github.com/tjormola\u003e\n\nCOPYRIGHT AND LICENSE\n\n    This software is copyright (c) 2016 by Stanislaw Pusep \u003cstas@sysd.org\u003e.\n\n    This is free software; you can redistribute it and/or modify it under\n    the same terms as the Perl 5 programming language system itself.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreaktive%2Frainbarf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcreaktive%2Frainbarf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreaktive%2Frainbarf/lists"}