Skip to content

Commit

Permalink
docs(tmux-lazygit-popup) added readme
Browse files Browse the repository at this point in the history
  • Loading branch information
kampanosg committed Jul 3, 2024
1 parent 352c56f commit 15a8a20
Showing 1 changed file with 32 additions and 0 deletions.
32 changes: 32 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# tmux-lazygit-popup


## Installation

Install the plugin via the [TPM](https://github.com/tmux-plugins/tpm/) plugin manager. Add the following line to the `.tmux.conf` and install with `<prefix>I

```sh
set -g @plugin 'kampanosg/tmux-lazygit-popup'
```

### Prerequisites

* [LazyGit](https://github.com/jesseduffield/lazygit)
* [Bash](https://www.gnu.org/software/bash/)

### Customisation

Add the following vars to the `.tmux.conf` to change the key, width, height and border of the popup

```sh
TMUX_LAZYGIT_POPUP_KEY='C-g'
TMUX_LAZYGIT_POPUP_WIDTH='70%'
TMUX_LAZYGIT_POPUP_HEIGHT='70%'
TMUX_LAZYGIT_POPUP_BORDER='double'
```

The available `TMUX_LAZYGIT_POPUP_BORDER` values are `single`, `rounded`, `double`, `heavy`, `simple` and `none`. The default value is `rounded`.

## Usage

To launch `tmux-lazygit-plugin`, press `<prefix>G` (`Shift + g`). The plugin will use the active pane's current working directory to launch `LazyGit` from. You can close the popup by stopping `LazyGit` (e.g. by pressing `q`)

0 comments on commit 15a8a20

Please sign in to comment.