Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hadenlabs/zsh-tmux
tmux settings
https://github.com/hadenlabs/zsh-tmux
hadenlabs peru plugins tmux tools zsh
Last synced: about 1 month ago
JSON representation
tmux settings
- Host: GitHub
- URL: https://github.com/hadenlabs/zsh-tmux
- Owner: hadenlabs
- License: lgpl-3.0
- Created: 2019-11-23T19:55:23.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-11-11T01:33:14.000Z (2 months ago)
- Last Synced: 2024-11-11T02:28:06.349Z (2 months ago)
- Topics: hadenlabs, peru, plugins, tmux, tools, zsh
- Language: Shell
- Homepage:
- Size: 5.06 MB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: docs/code_of_conduct.md
- Security: SECURITY.md
- Support: docs/support.md
- Roadmap: docs/roadmap.md
Awesome Lists containing this project
README
[![Latest Release](https://img.shields.io/github/release/hadenlabs/zsh-tmux)](https://github.com/hadenlabs/zsh-tmux/releases) [![Lint](https://img.shields.io/github/workflow/status/hadenlabs/zsh-tmux/lint-code)](https://github.com/hadenlabs/zsh-tmux/actions?workflow=lint-code) [![CI](https://img.shields.io/github/workflow/status/hadenlabs/zsh-tmux/ci)](https://github.com/hadenlabs/zsh-tmux/actions?workflow=ci) [![Test](https://img.shields.io/github/workflow/status/hadenlabs/zsh-tmux/test)](https://github.com/hadenlabs/zsh-tmux/actions?workflow=test) [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit) [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow)](https://conventionalcommits.org) [![KeepAChangelog](https://img.shields.io/badge/changelog-Keep%20a%20Changelog%20v1.0.0-orange)](https://keepachangelog.com)
# zsh-tmux
zsh-tmux plugin for zsh.
## Requirements
This is a list of plugins that need to be installed previously to enjoy all the goodies of this configuration:
- [gomplate](https://github.com/hairyhenderson/gomplate)
- [python](https://www.python.org)
- [taskfile](https://github.com/go-task/task)## Installation
### [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh) users
If you're using [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh), install this plugin by doing the following:
1. Go to your oh-my-zsh custom plugins directory -`cd ~/.oh-my-zsh/custom/plugins`
2. Clone the plugin `bash git clone https://github.com/hadenlabs/zsh-tmux`bash
3. Edit your `.zshrc` and add `plugins=( ... zsh-tmux )` to your list of plugins
4. Open a new terminal and enjoy!### [antigen](https://github.com/zsh-users/antigen) users
If you're using [Antigen](https://github.com/zsh-users/antigen), install this plugin by doing the following:
1. Add `antigen bundle hadenlabs/zsh-tmux` to your `.zshrc` where you're adding your other plugins.
2. Either open a new terminal to force zsh to load the new plugin, or run `antigen bundle hadenlabs/zsh-tmux` in a running zsh session.
3. Enjoy!### [antibody](https://github.com/getantibody/antibody) users
If you're using [Antibody](https://github.com/getantibody/antibody), install this plugin by doing the following:
1. Add :
```{.sourceCode .bash}
antibody bundle hadenlabs/zsh-tmux
```to your `.zshrc` where you're adding your other plugins.
2. Either open a new terminal to force zsh to load the new plugin, or run `antibody bundle hadenlabs/zsh-tmux` in a running zsh session.
3. Enjoy!## Usage
# How to use this project
## Replace name project to New Project
```bash
agr 'zsh-tmux' 'new-project'
```## Examples
### Common
## Functions
zsh tmux includes a small utility `tmux`.
#### `tmux::post_install`
Synchronizes and install configurations.
#### `tmux::sync`
Synchronizes the configurations that are in `conf/.tmux.conf`
#### `tmux::install`
Install tmux
#### `tx::project` `name_project`
Run tmux session using tmuxinator template project
#### `ftm`
Create new tmux session, or switch to existing one.
#### `ftmk`
Delete tmux session.
## Help
**Got a question?**
File a GitHub [issue](https://github.com/hadenlabs/zsh-tmux/issues).
## Contributing
See [Contributing](./docs/contributing.md).
## Module Versioning
This Module follows the principles of [Semantic Versioning (SemVer)](https://semver.org/).
Using the given version number of `MAJOR.MINOR.PATCH`, we apply the following constructs:
1. Use the `MAJOR` version for incompatible changes.
1. Use the `MINOR` version when adding functionality in a backwards compatible manner.
1. Use the `PATCH` version when introducing backwards compatible bug fixes.### Backwards compatibility in `0.0.z` and `0.y.z` version
- In the context of initial development, backwards compatibility in versions `0.0.z` is **not guaranteed** when `z` is increased. (Initial development)
- In the context of pre-release, backwards compatibility in versions `0.y.z` is **not guaranteed** when `y` is increased. (Pre-release)## Copyright
Copyright © 2018-2023 [Hadenlabs](https://hadenlabs.com)
## Trademarks
All other trademarks referenced herein are the property of their respective owners.
## License
The code and styles are licensed under the LGPL-3.0 license [See project license.](LICENSE).
## Don't forget to 🌟 Star 🌟 the repo if you like zsh-tmux
[Your feedback is appreciated](https://github.com/hadenlabs/zsh-tmux/issues)