{"id":13739467,"url":"https://github.com/tony/tmux-config","last_synced_at":"2025-05-15T07:07:04.453Z","repository":{"id":41504694,"uuid":"703516","full_name":"tony/tmux-config","owner":"tony","description":":green_book: Example tmux configuration - screen + vim key-bindings, system stat, cpu load bar.","archived":false,"fork":false,"pushed_at":"2024-07-06T13:00:32.000Z","size":406,"stargazers_count":1827,"open_issues_count":10,"forks_count":479,"subscribers_count":65,"default_branch":"master","last_synced_at":"2025-04-11T18:25:05.052Z","etag":null,"topics":["configuration","dot-config","dotfile","dotfiles","shell","terminal","tmux"],"latest_commit_sha":null,"homepage":"http://tony.github.com/tmux-config/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tony.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2010-06-04T16:21:42.000Z","updated_at":"2025-03-29T07:46:57.000Z","dependencies_parsed_at":"2024-01-17T16:06:56.937Z","dependency_job_id":"7c4b3eae-ad4c-4847-9e0a-e5066f7d70d6","html_url":"https://github.com/tony/tmux-config","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tony%2Ftmux-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tony%2Ftmux-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tony%2Ftmux-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tony%2Ftmux-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tony","download_url":"https://codeload.github.com/tony/tmux-config/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254292042,"owners_count":22046426,"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":["configuration","dot-config","dotfile","dotfiles","shell","terminal","tmux"],"created_at":"2024-08-03T04:00:34.258Z","updated_at":"2025-05-15T07:06:59.444Z","avatar_url":"https://github.com/tony.png","language":"Shell","funding_links":[],"categories":["User configuraions","tmux","Shell","Configuration"],"sub_categories":[],"readme":"[tmux](http://tmux.sourceforge.net/) is a terminal multiplexer.\n\n- Tested with tmux 1.5+.\n- Support for [tmux-mem-cpu-load](http://github.com/thewtex/tmux-mem-cpu-load).\n- Prefix mapped to Ctrl-A for `screen` users.\n\nNew to tmux? [_The Tao of tmux_](https://leanpub.com/the-tao-of-tmux) is now available on Leanpub\nand [Amazon Kindle](http://amzn.to/2gPfRhC). Read and browse the book for\n[on the web](https://leanpub.com/the-tao-of-tmux/read).\n\nWant more tmux? Check out the [libtmux](https://github.com/tony/libtmux) python library for\ncontrolling tmux, and load your code projects via YAML/JSON with\n[tmuxp](https://github.com/tony/tmuxp).\n\n## Share your .dot-configs\n\nHave a tmux configuration you'd like to share? Whether a fork of this project, another's, or your\nown, submit it to [awesome-tmux-configs](https://github.com/tony/awesome-tmux-configs).\n\n## Installation\n\nDownload:\n\n```bash\ngit clone --recursive https://github.com/tony/tmux-config.git ~/.tmux\n```\n\nCopy tmux config to home:\n\n```bash\nln -s ~/.tmux/.tmux.conf ~/.tmux.conf\n```\n\nGo to config dir:\n\n```bash\ncd ~/.tmux\n```\n\n## Stats\n\n### tmux-mem-cpu-load\n\nWorks on Linux and OS X.\n\nPrep ourself to download submodule (if you forgot `--recursive` when cloning):\n\n```bash\ngit submodule init\n```\n\nDownload submodule:\n\n```bash\ngit submodule update\n```\n\nChange dir to tmux-mem-cpu-load:\n\n```bash\ncd ~/.tmux/vendor/tmux-mem-cpu-load\n```\n\nMake `_build` directory and `cd` into it:\n\n```bash\nmkdir _build; cd _build\n```\n\nGeneral make file:\n\n```bash\ncmake ..\n```\n\nCompile binary:\n\n```bash\nmake\n```\n\nInstall our binary to `/usr/local/bin/tmux-mem-cpu-load`:\n\n```bash\nsudo make install\n```\n\n(No need to do `sudo` if on OS X / macOS)\n\nGo home:\n\n```bash\ncd ~\n```\n\nLaunch tmux:\n\n```\ntmux\n```\n\nAnd press `Control + a` then `d` to go back to the terminal.\n\nUpdate config:\n\n```bash\ntmux source-file ~/.tmux.conf\n```\n\n### basic-cpu-and-memory.tmux\n\n(Cross platform, tested with python 2.7+)\n\nUpdate March 19, 2014. Works with psutil 2.0 now.\n\nInstall `psutil`:\n\n```bash\nsudo pip install psutil\n```\n\nCopy `~/.tmux/vendor/basic-cpu-and-memory.tmux` to bin:\n\n```bash\nsudo cp ~/.tmux/vendor/basic-cpu-and-memory.tmux /usr/local/bin/tmux-mem-cpu-load\n```\n\nmake executable:\n\n```bash\nsudo chmod +x /usr/local/bin/tmux-mem-cpu-load\n```\n\n### Powerline (Advanced)\n\nYou can add suport for [powerline](https://github.com/powerline/powerline) by adding these to your\n`~/.tmux.conf`. Be sure to grab and install [powerline-fonts](https://github.com/powerline/fonts)\nfor your system.\n\nSee [Powerline on ReadTheDocs.org](https://powerline.readthedocs.org/en/master/) for more info.\n\n```\n# pip install --user git+git://github.com/powerline/powerline\nif-shell 'test -f ~/.local/lib/python2.7/site-packages/powerline/bindings/tmux/powerline.conf' 'source-file ~/.local/lib/python2.7/site-packages/powerline/bindings/tmux/powerline.conf'\n\n# [sudo] pip install git+git://github.com/powerline/powerline\nif-shell 'test -f /usr/local/lib/python2.7/site-packages/powerline/bindings/tmux/powerline.conf' 'source-file /usr/local/lib/python2.7/site-packages/powerline/bindings/tmux/powerline.conf'\n\n# [sudo] pip install git+git://github.com/powerline/powerline\nif-shell 'test -f /usr/local/lib/python2.7/dist-packages/powerline/bindings/tmux/powerline.conf' 'source-file /usr/local/lib/python2.7/dist-packages/powerline/bindings/tmux/powerline.conf'\n# python 3.3 ?\nif-shell 'test -f /usr/local/lib/python3.3/dist-packages/powerline/bindings/tmux/powerline.conf' 'source-file /usr/local/lib/python3.3/dist-packages/powerline/bindings/tmux/powerline.conf'\n# python 3.4 ?\n# if-shell 'test -f /usr/local/lib/python3.4/dist-packages/powerline/bindings/tmux/powerline.conf' 'source-file /usr/local/lib/python3.4/dist-packages/powerline/bindings/tmux/powerline.conf'\n# python 3.5 ?\n# if-shell 'test -f /usr/local/lib/python3.5/dist-packages/powerline/bindings/tmux/powerline.conf' 'source-file /usr/local/lib/python3.5/dist-packages/powerline/bindings/tmux/powerline.conf'\n# python 3.6 ?\n# if-shell 'test -f /usr/local/lib/python3.6/dist-packages/powerline/bindings/tmux/powerline.conf' 'source-file /usr/local/lib/python3.6/dist-packages/powerline/bindings/tmux/powerline.conf'\n```\n\n## Start tmux\n\nTo start a session:\n\n`tmux`\n\nTo reattach a previous session:\n\n`tmux attach`\n\nTo reload config file\n\n`\u003cControl + b\u003e:` (which could Ctrl-B or Ctrl-A if you overidden it) then `source-file ~/.tmux.conf`\n\n## Commands\n\nOur prefix/leader key is `Control + a` now (just like the `screen` multiplexer). This sequence must\nbe typed before any tmux shortcut.\n\n- `Control + a` before any command\n- `Control + a` then `?` to bring up list of keyboard shortcuts\n- `Control + a` then `\"` to split window\n- `Control + a` then `\u003cSpace\u003e` to change pane arrangement\n- `Control + a` then `o` to rotate panes\n- `Control + a` then `h`, `j`, `k`, `l` to move left, down, up, right. Respectively. (vim hjkl)\n- `Control + a` then `;` to go to last panel\n\nBeyond your first window:\n\n- `Control + a` then `c` to create a new window\n- `Control + a` then `n` to next window\n- `Control + a` then `p` to previous window\n- `Control + a` then `[0-9]` move to window number\n- `Control + a` then `\u0026` to kill window\n\nCustom:\n\n- `Control + a` then `m` to switch to `main-horizontal` layout with the main window at 2/3 height..\n- `Control + a` then `M` to switch to `main-vertical` layout with the main window at half width.\n\n## More configs / Tools\n\n- _Save / Load your tmux workspaces through JSON or YAML_ with\n  [tmuxp](https://github.com/tony/tmuxp).\n- _Clone + Synchronize your git / hg / svn projects through JSON / YAML_ with\n  [vcspull](https://github.com/tony/vcspull).\n- _Modular, Lazy-loading vim configuration_ with support for C, C++, Python, Go and Javascript with\n  [tony/vim-config](https://github.com/tony/vim-config)\n- _Modular dot-config example_ [tony/.dot-config](https://github.com/tony/.dot-config)\n\n## Other\n\n- Github: http://www.github.com/tony\n- Website: http://www.git-pull.com\n- LICENSE: MIT\n- Author: Tony Narlock (tony@git-pull.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftony%2Ftmux-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftony%2Ftmux-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftony%2Ftmux-config/lists"}