Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/imomaliev/tmux-keyboard-layout

Tmux plugin to show current keyboard layout
https://github.com/imomaliev/tmux-keyboard-layout

keyboard-layout tmux tmux-plugin

Last synced: 10 days ago
JSON representation

Tmux plugin to show current keyboard layout

Awesome Lists containing this project

README

        

# Tmux Keyboard Layout plugin

Plugin that shows current keyboard layout.

### Usage

```tmux.conf
set -g status-right '#{keyboard_layout}'
```

### Installation with Tmux Plugin Manager (recommended)

Add plugin to the list of TPM plugins:

```tmux.conf
set -g @plugin 'imomaliev/tmux-keyboard-layout'
```

Press prefix + I to install it.

### Manual Installation

Clone the repo:

```bash
$ git clone https://github.com/imomaliev/tmux-keyboard-layout.git ~/clone/path
```

Add this line to your .tmux.conf:

```tmux.conf
run-shell ~/clone/path/keyboard-layout.tmux
```

Reload TMUX environment with:

```bash
$ tmux source-file ~/.tmux.conf
```

### Configurations

#### Change option scope (default g - global)

Follows same rules as `set-option`

**Special case**: To set scope to session use `'-'`, because by default session scope used when no param is provided.

```tmux.conf
set -g @keyboard_layout:option_scope '-'
```

#### Change output length (default 16)

Make output length equal to 2

```tmux.conf
set -g @keyboard_layout:length 2
```

### License

[MIT](LICENSE)