https://github.com/szaffarano/top.nvim
Simple plugin to display a system monitor like htop or btop as a floating neovim window
https://github.com/szaffarano/top.nvim
btop htop lua neovim system-monitoring
Last synced: 2 months ago
JSON representation
Simple plugin to display a system monitor like htop or btop as a floating neovim window
- Host: GitHub
- URL: https://github.com/szaffarano/top.nvim
- Owner: szaffarano
- Created: 2025-09-07T10:28:32.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-09-07T12:12:08.000Z (10 months ago)
- Last Synced: 2025-09-07T12:22:42.773Z (10 months ago)
- Topics: btop, htop, lua, neovim, system-monitoring
- Language: Lua
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# top.nvim
A simple Neovim plugin that displays system monitors (htop/top/btop) in a
floating window.
## Installation
### lazy.nvim
```lua
return {
"szaffarano/top.nvim",
---@module 'top.types'
---@type top.Options
opts = {
bin = "btop",
ui = {
border = "rounded",
},
},
}
```
## Usage
- **Command**: `:Top`: Open the system monitor in a floating window
- **Lua**: `require('top').show()`: Programmatically open the monitor
- **Health check**: `:checkhealth top`: Verify system monitor availability
## Configuration
The plugin uses these defaults:
```lua
{
bin = 'htop', -- System monitor binary
ui = {
height_percent = 0.8, -- Window height (0.0-1.0)
width_percent = 0.8, -- Window width (0.0-1.0)
border = 'single', -- Border style
},
}
```
## Requirements
- Neovim 0.8+
- A system monitor: `htop`, `top`, or `btop`
## License
MIT