https://github.com/davep/tdim
A quick and dirty terminal dimension checker/seeker
https://github.com/davep/tdim
Last synced: 8 months ago
JSON representation
A quick and dirty terminal dimension checker/seeker
- Host: GitHub
- URL: https://github.com/davep/tdim
- Owner: davep
- License: gpl-3.0
- Created: 2023-05-09T20:54:08.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-16T11:37:37.000Z (about 2 years ago)
- Last Synced: 2025-01-20T06:59:22.481Z (over 1 year ago)
- Language: Python
- Size: 79.1 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tdim - Show and help size terminal dimensions
A simple tool to help when I want to size any terminal "just so".
## Installation
### pipx
The package can be installed using [`pipx`](https://pypa.github.io/pipx/):
```sh
$ pipx install tdim
```
### Homebrew
The package is available via Homebrew. Use the following commands to install:
```sh
$ brew tap davep/homebrew
$ brew install tdim
```
## Usage
To run the tool, just run `tdim`. Once you run it up you'll see a simple
display of the dimensions of your terminal. Resize your terminal and be
amazed as the numbers change!
You can show/hide a border by pressing b.
To aim seeking a specific aspect ratio, a number of keys are set up for
common ones. When pressed the border will be shown, the width set to the
width of your terminal at that moment, and then height to the corresponding
target height for that ratio.
The keys are:
| Key | Ratio |
|--------------|--------------------|
| 0 | Clear target ratio |
| 1 | 16 x 9 |
| 2 | 4 x 3 |
| 3 | 2 x 1 |
| 4 | 1 x 1 |
| 5 | 9 x 16 |
To exit the application press Esc.
[//]: # (README.md ends here)