https://github.com/greymd/tmux-adtty
Adjust terminal emulator's size to true column and line size.
https://github.com/greymd/tmux-adtty
tmux tmux-plugins
Last synced: about 1 month ago
JSON representation
Adjust terminal emulator's size to true column and line size.
- Host: GitHub
- URL: https://github.com/greymd/tmux-adtty
- Owner: greymd
- License: mit
- Created: 2017-03-30T07:49:01.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2017-03-30T11:18:34.000Z (about 9 years ago)
- Last Synced: 2025-01-28T10:30:06.536Z (over 1 year ago)
- Topics: tmux, tmux-plugins
- Language: Shell
- Homepage:
- Size: 190 KB
- Stars: 4
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tmux-adtty
ADjust + TTY: Adjust terminal emulator's size to true column and line size.
# Introduction
When a remote terminal device cannot receives local's terminal emulator's screen size, screen layout would be broken.
If any servers does not convey terminal information in SSH connection, such the issue can be happened. This plugin helps tmux users fix such the issue.
## Key binding
* `prefix + a` - Adjust terminal emulator's column and line size properly.
+ Send two commands `$ stty rows #{pane_height} cols #{pane_width}` and `clear`.
+ See [Change key binding](#change-default-bind-key) to change this key binding.
## Installation with [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm) (recommended)
Add plugin to the list of TPM plugins in `.tmux.conf`.
```
set -g @plugin 'greymd/tmux-adtty'
```
Hit `prefix + I` to fetch the plugin and source it. You should now be able to use the plugin.
## Manual installation
```
$ git clone https://github.com/greymd/tmux-adtty.git ~/clone/path
```
Add this line to the bottom of `.tmux.conf`.
```
run-shell ~/clone/path/adtty.tmux
```
Reload TMUX environment.
```
$ tmux source-file ~/.tmux.conf
```
## Change default bind key.
Update `@adtty` in `tmux.conf` with such the statement.
```
# Example: Change key binding to 'prefix + A' key.
set -g @adtty 'A'
```
## LICENSE
This is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).