169 lines
13 KiB
Markdown
169 lines
13 KiB
Markdown
<p align="center">
|
|
<a href="https://www.nordtheme.com/ports/tmux" target="_blank">
|
|
<picture>
|
|
<source srcset="https://raw.githubusercontent.com/nordtheme/web/main/assets/images/ports/tmux/repository-hero.svg?sanitize=true" width="100%" media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)" />
|
|
<img srcset="https://raw.githubusercontent.com/nordtheme/web/main/assets/images/ports/tmux/repository-hero.svg?sanitize=true" width="100%" />
|
|
</picture>
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/nordtheme/tmux/releases/latest" target="_blank">
|
|
<img src="https://img.shields.io/github/release/nordtheme/tmux.svg?style=flat-square&label=Release&logo=github&logoColor=eceff4&colorA=4c566a&colorB=88c0d0"/>
|
|
</a>
|
|
<a href="https://www.nordtheme.com/docs/ports/tmux" target="_blank">
|
|
<img src="https://img.shields.io/github/release/nordtheme/tmux.svg?style=flat-square&label=Docs&colorA=4c566a&colorB=88c0d0&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiI%2BCiAgICA8cGF0aCBmaWxsPSIjZDhkZWU5IiBkPSJNMTMuNzQ2IDIuODEzYS42Ny42NyAwIDAgMC0uNTU5LS4xMzNMOCAzLjg0OGwtNS4xODgtMS4xOGEuNjY5LjY2OSAwIDAgMC0uNTcuMTMzLjY3Ny42NzcgMCAwIDAtLjI0Mi41MzF2OC4xMzNjLS4wMDguMzIuMjEuNTk4LjUyLjY2OGw1LjMzMiAxLjE5OWguMjk2bDUuMzMyLTEuMmEuNjY4LjY2OCAwIDAgMCAuNTItLjY2N1YzLjMzMmEuNjU5LjY1OSAwIDAgMC0uMjU0LS41MnpNMy4zMzIgNC4xNjhsNCAuODk4djYuNzY2bC00LS44OTh6bTkuMzM2IDYuNzY2bC00IC44OThWNS4wNjZsNC0uODk4em0wIDAiLz4KPC9zdmc%2BCg%3D%3D"/>
|
|
</a>
|
|
<a href="https://github.com/nordtheme/tmux/blob/develop/changelog.md" target="_blank">
|
|
<img src="https://img.shields.io/github/release/nordtheme/tmux.svg?style=flat-square&label=Changelog&logo=github&logoColor=eceff4&colorA=4c566a&colorB=88c0d0"/>
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/svengreb/styleguide-javascript/releases/latest" target="_blank">
|
|
<img src="https://img.shields.io/github/release/svengreb/styleguide-javascript.svg?style=flat-square&label=JavaScript%20Style%20Guide&logoColor=eceff4&colorA=4c566a&colorB=88c0d0&logo=javascript"/>
|
|
</a>
|
|
<a href="https://github.com/svengreb/styleguide-markdown/releases/latest" target="_blank">
|
|
<img src="https://img.shields.io/github/release/svengreb/styleguide-markdown.svg?style=flat-square&label=Markdown%20Style%20Guide&colorA=4c566a&colorB=88c0d0&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIzOSIgaGVpZ2h0PSIzOSIgdmlld0JveD0iMCAwIDM5IDM5Ij48cGF0aCBmaWxsPSJub25lIiBzdHJva2U9IiNEOERFRTkiIHN0cm9rZS13aWR0aD0iMyIgc3Ryb2tlLW1pdGVybGltaXQ9IjEwIiBkPSJNMS41IDEuNWgzNnYzNmgtMzZ6Ii8%2BPHBhdGggZmlsbD0iI0Q4REVFOSIgZD0iTTIwLjY4MyAyNS42NTVsNS44NzItMTMuNDhoLjU2Nmw1Ljg3MyAxMy40OGgtMS45OTZsLTQuMTU5LTEwLjA1Ni00LjE2MSAxMC4wNTZoLTEuOTk1em0tMi42OTYgMGwtMTMuNDgtNS44NzJ2LS41NjZsMTMuNDgtNS44NzJ2MS45OTVMNy45MzEgMTkuNWwxMC4wNTYgNC4xNnoiLz48L3N2Zz4%3D"/>
|
|
</a>
|
|
<a href="https://github.com/svengreb/styleguide-git/releases/latest" target="_blank">
|
|
<img src="https://img.shields.io/github/release/svengreb/styleguide-git.svg?style=flat-square&label=Git%20Style%20Guide&logoColor=eceff4&colorA=4c566a&colorB=88c0d0&logo=git"/>
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/nordtheme/nord/releases/tag/v0.2.0" target="_blank">
|
|
<img src="https://img.shields.io/static/v1.svg?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAACUklEQVRIibXUQUiTcRjH8e+zvaO0AgPd1mDmNvFVI+ng1UNU1wiDoEIIoUNUdOkQUkER1KWTnRJCLyZBIdEhQvAWQVp5KN9X3bskmHunYbeZbu/TaWXRdOLrc3ue5/f/f/6nP+xwycy8m6y0LGqg0N7UsLB+9jmdbQwZQaNawPBKpCstA3g/7fRCl5k68P7PLNjplRgBQtUAYjmuCriqDP690RqQK8A3WSt1mmZsqbyyM+4pVc5tcvdxYD+W46qVdif/l7Ac95bluGo57piqBqt58e+zaXfSclwNbBQyE+F7KKPAMTuzeGcrQLk2BEREV41dvYAD2jeddrt9BQA6DtYtC3QDKyIM2pmlVl+Bublc2ExGpgS9BuxTLT2byuX2+AYUJTAyPq6GmYwOIPoEOLy7IAO+AYgejTW5dwF2UbiM8kGVs9NO/qo/AGRV5Ybl5E4mEokVT0rdwHdBH9pOvmvbgCd6GlgDGZqddVPtydg8aC9gKDqybaA9EX2nyHWgrhTkxUQ2W9uajL4U0QdAbNsAQFsy3C8wBHTsXQk+BmhpitwE3vgCANSGVi8pfATO207uooh4hqc9vgHxeLzgeXIG+KFIv5Ve7GxujuZ9AwAONYfnVLUHCCHec9vO1vsKALSloq9A7gONhILDm/2yWwYAzETDbeC1wgk7k+/bKCuW4yqwDIxtGBSGzURktNzbdrZeQ8EJIA76CJXCP/kLCpEyUE2VVLWnLRV9Wh7MZPJHPNW3QE2lQ0YgSKpKgLWiV1zftyTCn758XUwZ4lUEdrx+ASW88rx2UJY8AAAAAElFTkSuQmCC&label=Nord&message=v0.2.0&colorA=4c566a&colorB=88c0d0"/>
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">An arctic, north-bluish clean and elegant <a href="https://tmux.github.io" target="_blank">tmux</a> color theme.</p>
|
|
|
|
<p align="center">Designed for a fluent and clear workflow based on the <a href="https://www.nordtheme.com" target="_blank">Nord</a> color palette.</p>
|
|
|
|
<p align="center">
|
|
<a href="https://www.nordtheme.com/ports/tmux" target="_blank">
|
|
<img src="https://raw.githubusercontent.com/nordtheme/web/main/assets/images/ports/tmux/overview.png"/>
|
|
</a>
|
|
</p>
|
|
|
|
## Getting Started
|
|
|
|
Visit the [official website][nord-home] to learn all about the [fluidly merging appearance][nord-home#intro] features, details and elements of [UI elements][nord-home#ui-elements], the [various theme configurations][nord-home#configurations] and the [support for plugins][nord-home#plugin-support].
|
|
|
|
Learn about the [installation and activation][nord-docs-home-install], how to [configure][nord-docs-home-config] the theme and [supported plugins][nord-docs-home-plugins] from the [official documentations][nord-docs-home].
|
|
|
|
### Quick Start
|
|
|
|
Thanks to existing plugin managers for tmux, Nord tmux can be installed for all platforms in a uniform way within a few lines of codes. The recommended manager is [tpm][gh-tmux-plugins/tpm], but any other manager like [tundle][gh-javier-lopez/tundle] can also be used.
|
|
|
|
To automatically download and activate Nord tmux, follow the install instructions for [tpm][gh-tmux-plugins/tpm] and
|
|
|
|
1. add `set -g @plugin "nordtheme/tmux"` to your [`tmux.conf`][tmux-man-tmux.conf], by default `.tmux.conf` located in your [home directory][wiki-home_dir]
|
|
2. press the default key binding `prefix` + <kbd>I</kbd> to fetch- and install the plugin
|
|
|
|
<p align="center">
|
|
<picture>
|
|
<img src="https://raw.githubusercontent.com/nordtheme/web/main/assets/images/ports/tmux/installation-tpm.png" />
|
|
</picture>
|
|
</p>
|
|
|
|
See the Nord tmux's documentation for [more installation options][nord-docs-home-install] and how to [set it up manually][nord-docs-home-install#manual].
|
|
Also see [_tpm's_ install instructions][gh-tpm-docs-install-plugins] for more details.
|
|
|
|
## Features
|
|
|
|
<div align="center">
|
|
<p><strong>Your terminal. Your style.</strong></p>
|
|
<p>The unified UI element design provides a clutter-free and fluidly merging appearance.</p>
|
|
</div>
|
|
|
|
<p align="center">
|
|
<a href="https://www.nordtheme.com/ports/tmux#intro" target="_blank">
|
|
<img src="https://raw.githubusercontent.com/nordtheme/web/main/assets/images/ports/tmux/ui-fluid-appearance-vim.png" />
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://www.nordtheme.com/ports/tmux#introduction" target="_blank">
|
|
<img src="https://raw.githubusercontent.com/nordtheme/web/main/assets/images/ports/tmux/ui-fluid-appearance-gotop.png" />
|
|
</a>
|
|
</p>
|
|
|
|
<div align="center">
|
|
<p><strong>Uniform design with beautiful UI elements.</strong></p>
|
|
<p>The themed UI elements provide a fluid and unobtrusive transition from the terminal to the tmux status bar.</p>
|
|
</div>
|
|
|
|
<p align="center">
|
|
<a href="https://www.nordtheme.com/ports/tmux#ui-elements" target="_blank">
|
|
<img src="https://raw.githubusercontent.com/nordtheme/web/main/assets/images/ports/tmux/ui-clock.png" />
|
|
</a>
|
|
</p>
|
|
|
|
<div align="center"><p><strong>Take your favorite plugins with you.</strong></p><p>The theme supports popular plugins for a fluid and unobtrusive user interface transition.</p></div>
|
|
|
|
<p align="center">
|
|
<a href="https://www.nordtheme.com/ports/tmux#plugin-support" target="_blank">
|
|
<img src="https://raw.githubusercontent.com/nordtheme/web/main/assets/images/ports/tmux/plugins-tmux-prefix-highlight.png" />
|
|
</a>
|
|
</p>
|
|
|
|
## Contributing
|
|
|
|
Nord is an open source project and we love to receive contributions from the [community][nord-comm]!
|
|
|
|
There are many ways to contribute, from [writing- and improving documentation and tutorials][nord-contrib-guide-docs], [reporting bugs][nord-contrib-guide-bugs], [submitting enhancement suggestions][nord-contrib-guide-enhance] that can be added to Nord by [submitting pull requests][nord-contrib-guide-pr].
|
|
|
|
Please take a moment to read Nord's full [contributing guide][nord-contrib-guide] to learn about the development process, the project's used [styleguides][nord-contrib-guide-styles], [branch organization][nord-contrib-guide-branching] and [versioning][nord-contrib-guide-versioning] model.
|
|
|
|
The guide also includes information about [minimal, complete, and verifiable examples][nord-contrib-guide-mcve] and other ways to contribute to the project like [improving existing issues][nord-contrib-guide-impr-issues] and [giving feedback on issues and pull requests][nord-contrib-guide-feedback].
|
|
|
|
<p align="center">
|
|
<picture>
|
|
<source srcset="https://raw.githubusercontent.com/nordtheme/assets/main/static/images/elements/separators/iceberg/footer/dark/spaced.svg" width="100%" media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)" />
|
|
<source srcset="https://raw.githubusercontent.com/nordtheme/assets/main/static/images/elements/separators/iceberg/footer/light/spaced.svg" width="100%" media="(prefers-color-scheme: dark)" />
|
|
<img src="https://raw.githubusercontent.com/nordtheme/assets/main/static/images/elements/separators/iceberg/footer/dark/spaced.svg" width="100%" />
|
|
</picture>
|
|
</p>
|
|
|
|
<p align="center">
|
|
Copyright © 2016-present <a href="https://www.svengreb.de" target="_blank">Sven Greb</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/nordtheme/tmux/blob/develop/license" target="_blank">
|
|
<img src="https://img.shields.io/static/v1.svg?style=flat-square&label=License&message=MIT&logoColor=eceff4&colorA=4c566a&colorB=88c0d0"/>
|
|
</a>
|
|
<a href="https://www.svengreb.de">
|
|
<img src="https://img.shields.io/static/v1.svg?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAABMklEQVQ4jcWQvUoDQRRGz52s5IfVIiDWPkGKFFaCIVaGdIagjcFAwICFb7DvIK6QQlNpY2UQLMQVBbEQ0SewFkGbKCQmOzaTJay7/lR+zTAf9xwuF/47Mv45rdezqWEq72v/RWZnHgqOMwDwHMfSj085JSqb6Pu38we7r18E3nqzhmYbsE11rxKsAvhDfQiSM30XYbOw57YDwfnaRl6U3ABWaMNn806H+oGPzBX3d+4UgChZiYBHYBgGsBLoKoAyhR0x9G20Zmpc4P1ZoMQDcwMNclFrdhBKv6M5WWi7ZQGtjEUn35IV4OwnVjSX/WGmKqCDDUa5rmyle3bvGFiMg3WGUsF1u0EXHoqTRMGRgkAy2eugKZrqijRLYThWANBpNDL2h3UE0J0YLJdbrfe42f/NJ0wqY7/KcXKPAAAAAElFTkSuQmCC&label=lovely%20crafted%20in&message=Germany&colorA=4c566a&colorB=88c0d0"/>
|
|
</a>
|
|
</p>
|
|
|
|
[gh-javier-lopez/tundle]: https://github.com/javier-lopez/tundle
|
|
[gh-tmux-plugins/tpm]: https://github.com/tmux-plugins/tpm
|
|
[gh-tpm-docs-install-plugins]: https://github.com/tmux-plugins/tpm#installing-plugins
|
|
[nord-comm]: https://www.nordtheme.com/community
|
|
[nord-contrib-guide-branching]: https://github.com/nordtheme/.github/blob/main/contributing.md#branch-organization
|
|
[nord-contrib-guide-bugs]: https://github.com/nordtheme/.github/blob/main/contributing.md#bug-reports
|
|
[nord-contrib-guide-docs]: https://github.com/nordtheme/.github/blob/main/contributing.md#documentations
|
|
[nord-contrib-guide-enhance]: https://github.com/nordtheme/.github/blob/main/contributing.md#enhancement-suggestions
|
|
[nord-contrib-guide-feedback]: https://github.com/nordtheme/.github/blob/main/contributing.md#feedback
|
|
[nord-contrib-guide-impr-issues]: https://github.com/nordtheme/.github/blob/main/contributing.md#improve-issues
|
|
[nord-contrib-guide-mcve]: https://github.com/nordtheme/.github/blob/main/contributing.md#mcve
|
|
[nord-contrib-guide-pr]: https://github.com/nordtheme/.github/blob/main/contributing.md#pull-requests
|
|
[nord-contrib-guide-styles]: https://github.com/nordtheme/.github/blob/main/contributing.md#style-guides
|
|
[nord-contrib-guide-versioning]: https://github.com/nordtheme/.github/blob/main/contributing.md#versioning
|
|
[nord-contrib-guide]: https://github.com/nordtheme/.github/blob/main/contributing.md
|
|
[nord-docs-home-config]: https://www.nordtheme.com/docs/ports/tmux/configuration
|
|
[nord-docs-home-install]: https://www.nordtheme.com/docs/ports/tmux/installation
|
|
[nord-docs-home-install#manual]: https://www.nordtheme.com/docs/ports/tmux/installation#manual
|
|
[nord-docs-home-plugins]: https://www.nordtheme.com/docs/ports/tmux/plugin-support
|
|
[nord-docs-home]: https://www.nordtheme.com/docs/ports/tmux
|
|
[nord-home]: https://www.nordtheme.com/ports/tmux
|
|
[nord-home#configurations]: https://www.nordtheme.com/ports/tmux#configurations
|
|
[nord-home#intro]: https://www.nordtheme.com/ports/tmux#intro
|
|
[nord-home#plugin-support]: https://www.nordtheme.com/ports/tmux#plugin-support
|
|
[nord-home#ui-elements]: https://www.nordtheme.com/ports/tmux#ui-elements
|
|
[tmux-man-tmux.conf]: http://man.openbsd.org/OpenBSD-current/man1/tmux.1#FILES
|
|
[wiki-home_dir]: https://en.wikipedia.org/wiki/Home_directory
|