{"id":13418290,"url":"https://github.com/thewtex/tmux-mem-cpu-load","last_synced_at":"2025-04-14T11:09:52.303Z","repository":{"id":822259,"uuid":"535959","full_name":"thewtex/tmux-mem-cpu-load","owner":"thewtex","description":"CPU, RAM, and load monitor for use with tmux","archived":false,"fork":false,"pushed_at":"2025-03-13T18:08:07.000Z","size":338,"stargazers_count":1047,"open_issues_count":0,"forks_count":139,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-04-14T11:09:24.858Z","etag":null,"topics":["cpu-monitoring","cross-platform","system-information","tmux"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thewtex.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2010-02-25T17:16:22.000Z","updated_at":"2025-04-11T16:08:41.000Z","dependencies_parsed_at":"2023-02-11T03:00:53.376Z","dependency_job_id":"ea48c880-389e-4b99-83c1-6002cbd67e39","html_url":"https://github.com/thewtex/tmux-mem-cpu-load","commit_stats":{"total_commits":270,"total_committers":28,"mean_commits":9.642857142857142,"dds":0.6666666666666667,"last_synced_commit":"b2c6cd43e05a89e6c72e868a53bbdf1d7b9cb5ba"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewtex%2Ftmux-mem-cpu-load","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewtex%2Ftmux-mem-cpu-load/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewtex%2Ftmux-mem-cpu-load/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewtex%2Ftmux-mem-cpu-load/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thewtex","download_url":"https://codeload.github.com/thewtex/tmux-mem-cpu-load/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248868766,"owners_count":21174758,"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":["cpu-monitoring","cross-platform","system-information","tmux"],"created_at":"2024-07-30T22:01:00.685Z","updated_at":"2025-04-14T11:09:52.263Z","avatar_url":"https://github.com/thewtex.png","language":"C++","funding_links":[],"categories":["TODO scan for Android support in followings","C++","Status Bar"],"sub_categories":[],"readme":"=============================================\n            tmux-mem-cpu-load\n=============================================\n---------------------------------------------\nCPU, RAM, and load monitor for use with tmux_\n---------------------------------------------\n\n.. image:: https://circleci.com/gh/thewtex/tmux-mem-cpu-load.svg?style=svg\n  :target: https://circleci.com/gh/thewtex/tmux-mem-cpu-load\n  \n.. image:: https://github.com/thewtex/tmux-mem-cpu-load/actions/workflows/main.yml/badge.svg\n   :target: https://github.com/thewtex/tmux-mem-cpu-load/actions/workflows/main.yml\n\nDescription\n===========\n\nA simple, lightweight program provided for system monitoring in the *status*\nline of **tmux**.\n\nThe memory monitor displays the used and available memory.\n\nThe CPU usage monitor outputs a percent CPU usage over all processors. It also\ndisplays a textual bar graph of the current percent usage.\n\nThe system load average is also displayed.\n\nExample output::\n\n  2885/7987MB [|||||     ]  51.2% 2.11 2.35 2.44\n\n   ^    ^          ^         ^     ^    ^    ^\n   |    |          |         |     |    |    |\n   1    2          3         4     5    6    7\n\n1. Currently used memory.\n2. Available memory.\n3. CPU usage bar graph.\n4. CPU usage percentage.\n5. Load average for the past minute.\n6. Load average for the past 5 minutes.\n7. Load average for the past 15 minutes.\n\nFor `terminals with 256 color support`_, graded colors can be displayed by\npassing the **--colors** flag.\n\n\nInstallation\n============\n\nDependencies\n------------\n\nCurrently, Linux, Mac OSX, FreeBSD, OpenBSD, and NetBSD are supported.\n\nBuilding\n~~~~~~~~\n\n* \u003e= CMake_ -3.5\n* C++ compiler with C++11 support (e.g. gcc/g++ \u003e= 4.6)\n\nDownload\n--------\n\nThere are links to the source code at the `project homepage`_.\n\nBuild\n-----\n\n::\n\n  cd \u003csource dir\u003e\n  cmake .\n  make\n\nInstall\n-------\n\n::\n\n  su -\n  make install\n  logout\n\nBuild and Install Using tpm_\n-----------------------------\n\nInclude the plugin in your ``.tmux.conf``, the same file you'll set the\nconfiguration in, below.\n\n::\n\n  set -g @plugin 'thewtex/tmux-mem-cpu-load'\n\nInstall with Package Managers\n-----------------------------\n\n* Gentoo: ``emerge tmux-mem-cpu-load``\n* Homebrew: ``brew install tmux-mem-cpu-load``\n\nBuild and Install Using Antigen_\n--------------------------------\n\nInclude the bundle in your ``.zshrc``\n\n::\n\n  antigen bundle thewtex/tmux-mem-cpu-load\n\nConfiguring tmux_\n=================\n\nEdit ``$HOME/.tmux.conf`` to display the program's output in *status-left* or\n*status-right*.  For example::\n\n  set -g status-interval 2\n  set -g status-left \"#S #[fg=green,bg=black]#(tmux-mem-cpu-load --colors --interval 2)#[default]\"\n  set -g status-left-length 60\n\nIf you installed using tpm, you must specify the full path to the\n``tmux-mem-cpu-load`` script, like below::\n\n  set -g status-right '#[fg=green]#($TMUX_PLUGIN_MANAGER_PATH/tmux-mem-cpu-load/tmux-mem-cpu-load --colors --powerline-right --interval 2)#[default]'\n\nNote that the *interval* argument to `tmux-mem-cpu-load` should be the same number\nof seconds that *status-interval* is set at.\n\nAnother optional argument is the number of bars in the bar graph, which\ndefaults to 10.  This can, for instance, be set to the number of cores in a\nmulti-core system.\n\nThe *colors* option will add graded colors for each of the measures.\n\nThe full usage::\n\n  Usage: tmux-mem-cpu-load [OPTIONS]\n\n  Available options:\n  -h, --help\n           Prints this help message\n  -c, --colors\n          Use tmux colors in output\n  -p, --powerline-left\n\t  Use powerline left symbols throughout the output, enables --colors\n  -q, --powerline-right\n\t  Use powerline right symbols throughout the output, enables --colors\n  -v, --vertical-graph\n\t  Use vertical bar chart for CPU graph\n  -l \u003cvalue\u003e, --segments-left \u003cvalue\u003e\n\t  Enable blending bg/fg color (depending on -p or -q use) with segment to left\n\t  Provide color to be used depending on -p or -q option for seamless segment blending\n\t  Color is an integer value which uses the standard tmux color palette values\n  -r \u003cvalue\u003e, --segments-right \u003cvalue\u003e\n\t  Enable blending bg/fg color (depending on -p or -q use) with segment to right\n\t  Provide color to be used depending on -p or -q option for seamless segment blending\n\t  Color is an integer value which uses the standard tmux color palette values\n  -i \u003cvalue\u003e, --interval \u003cvalue\u003e\n          Set tmux status refresh interval in seconds. Default: 1 second\n  -g \u003cvalue\u003e, --graph-lines \u003cvalue\u003e\n          Set how many lines should be drawn in a graph. Default: 10\n  -m \u003cvalue\u003e, --mem-mode \u003cvalue\u003e\n        Set memory display mode. 0: Default, 1: Free memory, 2: Usage percent.\n  -t \u003cvalue\u003e, --cpu-mode \u003cvalue\u003e\n        Set cpu % display mode. 0: Default max 100%, 1: Max 100% * number of threads.\n  -a \u003cvalue\u003e, --averages-count \u003cvalue\u003e\n        Set how many load-averages should be drawn. Default: 3\n\nBlending Dynamic Colors Tmux Powerline Segments\n===============================================\n\nThe -l and -r options when used in conjunction with a recent version of Tmux Powerline\nthat has the ability to selectively disable spacing and separators between segments allow\nfor seamless blending of tmux-mem-cpu-load output with other adjacent segments.  The end\nresult is dynamic changing of appropriate foreground and background colors as the start\nand end of the tmux-mem-cpu-load output string that is aggregated with other Tmux\nPowerline output to produce a more polished status line in Tmux.\n\nSegment Adjaceny before this feature:\n\n.. image:: seg-adj1.png\n\nSegment Adjaceny after this feature:\n\n.. image:: seg-adj2.png\n\nNote that the values for the -l and -r options  will be the standard Tmux integer color\nvalues.  They set the appropriate background and foreground colors used for the separator\ncharacter when used with the poweline-left or powerline-right options so it is easy to\nmatch coloring to adjacent segments.  An example from the segment script that calls\ntmux-mem-cpu-load is as follows::\n\n  tmux-mem-cpu-load -q -v -l 52 -r 33\n\nThis combines with theme options available to tmux-powerline, such as the following::\n\n  \"disk_usage_cust 52 123 ${TMUX_POWERLINE_SEPARATOR_LEFT_BOLD} 52 123 right_disable\" \\\n  \"tmux_mem_cpu_load_cust 52 234 ${TMUX_POWERLINE_SEPARATOR_LEFT_BOLD} 52 234 both_disable separator_disable\" \\\n  \"batt_cust 33 154 ${TMUX_POWERLINE_SEPARATOR_LEFT_BOLD} 16 33 N separator_disable\" \\  \n\nAuthors\n=======\n\nMatt McCormick (thewtex) \u003cmatt@mmmccormick.com\u003e\n\nContributions from:\n\n* cousine \u003ciam@cousine.me\u003e\n* Jasper Lievisse Adriaanse \u003cjasper@humppa.nl\u003e\n* Justin Crawford \u003cjustinc@pci-online.net\u003e\n* krieiter \u003ckrieiter@gmail.com\u003e\n* Mark Palmeri \u003cmlp6@duke.edu\u003e\n* `Pawel 'l0ner' Soltys`_ \u003cpwslts@gmail.com\u003e\n* Travil Heller \u003ctrav.heller@gmail.com\u003e\n* Tony Narlock \u003ctony@git-pull.com\u003e\n* Compilenix \u003cCompilenix@compilenix.org\u003e\n* jodavies \u003cjodavies1010@gmail.com\u003e\n* `@nhdaly`_ (Nathan Daly) \u003cnhdaly@gmail.com\u003e\n* bensuperpc \u003cbensuperpc@gmail.com\u003e\n\n.. _tmux: http://tmux.sourceforge.net/\n.. _CMake: http://www.cmake.org\n.. _`project homepage`: http://github.com/thewtex/tmux-mem-cpu-load\n.. _`tpm`: http://github.com/tmux-plugins/tpm\n.. _`Antigen`: https://github.com/zsh-users/antigen\n.. _`terminals with 256 color support`: http://misc.flogisoft.com/bash/tip_colors_and_formatting#terminals_compatibility\n.. _`Pawel 'l0ner' Soltys` : http://l0ner.github.io/\n.. _`@nhdaly` : http://github.com/nhdaly\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthewtex%2Ftmux-mem-cpu-load","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthewtex%2Ftmux-mem-cpu-load","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthewtex%2Ftmux-mem-cpu-load/lists"}