# 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 <kbd>b</kbd>.
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 |
|--------------|--------------------|
| <kbd>0</kbd> | Clear target ratio |
| <kbd>1</kbd> | 16 x 9 |
| <kbd>2</kbd> | 4 x 3 |
| <kbd>3</kbd> | 2 x 1 |
| <kbd>4</kbd> | 1 x 1 |
To exit the application press <kbd>Esc</kbd>.
[//]: # (README.md ends here)
Raw data
{
"_id": null,
"home_page": "https://github.com/davep/tdim",
"name": "tdim",
"maintainer": "Dave Pearson",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "davep@davep.org",
"keywords": "terminal",
"author": "Dave Pearson",
"author_email": "davep@davep.org",
"download_url": "https://files.pythonhosted.org/packages/3f/80/eacd95f4b42182daade61b2f0ad607868c7db1aab54852e5dc8d39f1c0f4/tdim-0.3.0.tar.gz",
"platform": null,
"description": "# tdim - Show and help size terminal dimensions\n\nA simple tool to help when I want to size any terminal \"just so\".\n\n## Installation\n\n### pipx\n\nThe package can be installed using [`pipx`](https://pypa.github.io/pipx/):\n\n```sh\n$ pipx install tdim\n```\n\n### Homebrew\n\nThe package is available via Homebrew. Use the following commands to install:\n\n```sh\n$ brew tap davep/homebrew\n$ brew install tdim\n```\n\n## Usage\n\nTo run the tool, just run `tdim`. Once you run it up you'll see a simple\ndisplay of the dimensions of your terminal. Resize your terminal and be\namazed as the numbers change!\n\nYou can show/hide a border by pressing <kbd>b</kbd>.\n\nTo aim seeking a specific aspect ratio, a number of keys are set up for\ncommon ones. When pressed the border will be shown, the width set to the\nwidth of your terminal at that moment, and then height to the corresponding\ntarget height for that ratio.\n\nThe keys are:\n\n| Key | Ratio |\n|--------------|--------------------|\n| <kbd>0</kbd> | Clear target ratio |\n| <kbd>1</kbd> | 16 x 9 |\n| <kbd>2</kbd> | 4 x 3 |\n| <kbd>3</kbd> | 2 x 1 |\n| <kbd>4</kbd> | 1 x 1 |\n\nTo exit the application press <kbd>Esc</kbd>.\n\n[//]: # (README.md ends here)\n",
"bugtrack_url": null,
"license": "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
"summary": "A simple tool for displaying terminal dimensions",
"version": "0.3.0",
"project_urls": {
"Discussions": "https://github.com/davep/tdim/discussions",
"Documentation": "https://github.com/davep/tdim/blob/main/README.md",
"Homepage": "https://github.com/davep/tdim",
"Issues": "https://github.com/davep/tdim/issues",
"Source": "https://github.com/davep/tdim"
},
"split_keywords": [
"terminal"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6e3400b75ae5a859a711af6b8a6e7cadcf721e39fe5142c22beda94aabe6833a",
"md5": "532bf35e6bdaf3e823c0ef98d31eac44",
"sha256": "6fa1f3847c7b7ad2494dc5e27b2fe26b5d4537dcd60f5d475eb625a2386d5768"
},
"downloads": -1,
"filename": "tdim-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "532bf35e6bdaf3e823c0ef98d31eac44",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 3707,
"upload_time": "2024-04-16T11:36:26",
"upload_time_iso_8601": "2024-04-16T11:36:26.130692Z",
"url": "https://files.pythonhosted.org/packages/6e/34/00b75ae5a859a711af6b8a6e7cadcf721e39fe5142c22beda94aabe6833a/tdim-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3f80eacd95f4b42182daade61b2f0ad607868c7db1aab54852e5dc8d39f1c0f4",
"md5": "be119260ccb65dbceb495e0a91aedf64",
"sha256": "070c565894049a223ef087edfc2ddaae7c76b7ef62efdd221955a2858989facc"
},
"downloads": -1,
"filename": "tdim-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "be119260ccb65dbceb495e0a91aedf64",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 3309,
"upload_time": "2024-04-16T11:36:28",
"upload_time_iso_8601": "2024-04-16T11:36:28.252530Z",
"url": "https://files.pythonhosted.org/packages/3f/80/eacd95f4b42182daade61b2f0ad607868c7db1aab54852e5dc8d39f1c0f4/tdim-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-16 11:36:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "davep",
"github_project": "tdim",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tdim"
}
JSON
