# virttop
a top like utility for libvirt
![Image](virttop.png)
## How to get
```sh
pipx install virttop
```
## Options
```sh
usage: virttop.py [-h] [--uri URI [URI ...]] [--config CONFIG]
[--active ACTIVE] [--logfile LOGFILE]
options:
-h, --help show this help message and exit
--uri URI [URI ...], -u URI [URI ...]
A list of URIs to connect to seperated by commas
--config CONFIG, -c CONFIG
Path to the config file
--active ACTIVE, -a ACTIVE
Show active VMs only
--logfile LOGFILE, -l LOGFILE
Location of the log file
```
## Configfile
The default location for the config file is '~/.virttop.toml'.
```toml
[color]
name_column_fg=23
name_column_bg=0
active_row_fg=24
active_row_bg=0
inactive_row_fg=244
inactive_row_bg=0
box_fg=29
box_bg=0
selected_fg=0
selected_bg=36
```
## Keybindings
`j`,`k` and arrow keys move up and down.
`g` moves to the top of the list.
`G` moves to the bottom of the list.
`r` runs an inactive domain.
`s` shuts down a running domain.
`d` destroys a running domain.
Raw data
{
"_id": null,
"home_page": "https://github.com/terminaldweller/virttop",
"name": "virttop",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11,<4.0",
"maintainer_email": "",
"keywords": "libvirt,top",
"author": "terminaldweller",
"author_email": "devi@terminaldweller.com",
"download_url": "https://files.pythonhosted.org/packages/91/9f/37222dcc64be0ce15be0fd83abbb591eebe255208e4282927947c2674136/virttop-0.2.4.tar.gz",
"platform": null,
"description": "# virttop\na top like utility for libvirt\n\n![Image](virttop.png)\n\n## How to get\n```sh\npipx install virttop\n```\n\n## Options\n```sh\nusage: virttop.py [-h] [--uri URI [URI ...]] [--config CONFIG]\n [--active ACTIVE] [--logfile LOGFILE]\n\noptions:\n -h, --help show this help message and exit\n --uri URI [URI ...], -u URI [URI ...]\n A list of URIs to connect to seperated by commas\n --config CONFIG, -c CONFIG\n Path to the config file\n --active ACTIVE, -a ACTIVE\n Show active VMs only\n --logfile LOGFILE, -l LOGFILE\n Location of the log file\n```\n\n## Configfile\nThe default location for the config file is '~/.virttop.toml'.\n\n```toml\n[color]\nname_column_fg=23\nname_column_bg=0\nactive_row_fg=24\nactive_row_bg=0\ninactive_row_fg=244\ninactive_row_bg=0\nbox_fg=29\nbox_bg=0\nselected_fg=0\nselected_bg=36\n```\n\n## Keybindings\n\n`j`,`k` and arrow keys move up and down.\n\n`g` moves to the top of the list.\n\n`G` moves to the bottom of the list.\n\n`r` runs an inactive domain.\n\n`s` shuts down a running domain.\n\n`d` destroys a running domain.\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "A top like utility for libvirt",
"version": "0.2.4",
"project_urls": {
"Homepage": "https://github.com/terminaldweller/virttop",
"Repository": "https://github.com/terminaldweller/virttop"
},
"split_keywords": [
"libvirt",
"top"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "98856ae5e67710321459fbdf6f31e3b8521f604f2fed5bf14e153d1e32084b57",
"md5": "9bbc1438e007a8267f655dbd4b5a1da7",
"sha256": "ef9f515e6476206d53e20b4df7e2c08248824c0e51f890567669c9fdd6b247d8"
},
"downloads": -1,
"filename": "virttop-0.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9bbc1438e007a8267f655dbd4b5a1da7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11,<4.0",
"size": 31592,
"upload_time": "2023-11-21T04:19:20",
"upload_time_iso_8601": "2023-11-21T04:19:20.462456Z",
"url": "https://files.pythonhosted.org/packages/98/85/6ae5e67710321459fbdf6f31e3b8521f604f2fed5bf14e153d1e32084b57/virttop-0.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "919f37222dcc64be0ce15be0fd83abbb591eebe255208e4282927947c2674136",
"md5": "e60639fe9446d19bef2e12a9e11d87dd",
"sha256": "291d9b9acd440c037e5c8b009b2545c0ecd84992a181f7fe1120b8681461292a"
},
"downloads": -1,
"filename": "virttop-0.2.4.tar.gz",
"has_sig": false,
"md5_digest": "e60639fe9446d19bef2e12a9e11d87dd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11,<4.0",
"size": 18722,
"upload_time": "2023-11-21T04:19:22",
"upload_time_iso_8601": "2023-11-21T04:19:22.145368Z",
"url": "https://files.pythonhosted.org/packages/91/9f/37222dcc64be0ce15be0fd83abbb591eebe255208e4282927947c2674136/virttop-0.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-21 04:19:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "terminaldweller",
"github_project": "virttop",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "virttop"
}