{"id":13416747,"url":"https://github.com/cjbassi/gotop","last_synced_at":"2025-09-28T21:31:37.592Z","repository":{"id":38184897,"uuid":"122030607","full_name":"cjbassi/gotop","owner":"cjbassi","description":"A terminal based graphical activity monitor inspired by gtop and vtop","archived":true,"fork":false,"pushed_at":"2023-03-30T19:45:21.000Z","size":3559,"stargazers_count":7384,"open_issues_count":73,"forks_count":444,"subscribers_count":98,"default_branch":"master","last_synced_at":"2024-11-17T12:41:42.119Z","etag":null,"topics":["go","golang","linux","mouse","osx","terminal","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cjbassi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-02-19T07:25:22.000Z","updated_at":"2024-11-15T09:21:33.000Z","dependencies_parsed_at":"2023-01-20T23:44:53.487Z","dependency_job_id":"085bbade-e7c1-468f-aed2-b4ab2a6e7ee4","html_url":"https://github.com/cjbassi/gotop","commit_stats":{"total_commits":407,"total_committers":20,"mean_commits":20.35,"dds":0.09336609336609336,"last_synced_commit":"65d76af83079f16b6082a5326023438e87b2a8dd"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjbassi%2Fgotop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjbassi%2Fgotop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjbassi%2Fgotop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjbassi%2Fgotop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cjbassi","download_url":"https://codeload.github.com/cjbassi/gotop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234563156,"owners_count":18853062,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","linux","mouse","osx","terminal","tui"],"created_at":"2024-07-30T22:00:21.285Z","updated_at":"2025-09-28T21:31:32.001Z","avatar_url":"https://github.com/cjbassi.png","language":"Go","funding_links":[],"categories":["Popular","Go","Misc","开源类库","Open source library","HarmonyOS","Tools","Packages","Tool"],"sub_categories":["命令行","Command Line","Windows Manager","Go","CLI Tools","TUI Tool"],"readme":"### **NO LONGER MAINTAINED.** A maintained fork of gotop exists at https://github.com/xxxserxxx/gotop.\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"./assets/logo\"\u003e\n    \u003cimg src=\"./assets/logo/logo.png\" width=\"20%\" /\u003e\n\u003c/a\u003e\n\u003cbr\u003e\u003cbr\u003e\n\nAnother terminal based graphical activity monitor, inspired by [gtop](https://github.com/aksakalli/gtop) and [vtop](https://github.com/MrRio/vtop), this time written in [Go](https://golang.org/)!\n\n\u003cimg src=\"./assets/demos/demo.gif\" /\u003e\n\u003cimg src=\"./assets/screenshots/minimal.png\" width=\"96%\" /\u003e\n\n\u003c/div\u003e\n\n## Installation\n\nWorking and tested on Linux, FreeBSD and macOS. Windows support is planned. OpenBSD works with some caveats.\n\n### Source\n\n```bash\ngo get github.com/cjbassi/gotop\n```\n\n### Prebuilt binaries\n\n**Note**: Doesn't require Go.\n\nClone the repo and then run [scripts/download.sh](./scripts/download.sh) to download the correct binary for your system from the [releases tab](https://github.com/cjbassi/gotop/releases):\n\n```bash\ngit clone --depth 1 https://github.com/cjbassi/gotop /tmp/gotop\n/tmp/gotop/scripts/download.sh\n```\n\nThen move `gotop` into your `$PATH` somewhere.\n\n### Arch Linux\n\nInstall `gotop`, `gotop-bin`, or `gotop-git` from the AUR.\n\n### FreeBSD\n\n```bash\npkg install gotop\n```\n\n### Homebrew\n\n```bash\nbrew tap cjbassi/gotop\nbrew install gotop\n```\n\n### Snap\n\n```bash\nsnap install gotop-cjbassi\n```\n\n**Note**: You may need to enable certain permissions for all of the widgets to work:\n\n```bash\nsnap connect gotop-cjbassi:hardware-observe\nsnap connect gotop-cjbassi:mount-observe\nsnap connect gotop-cjbassi:system-observe\n```\n\n## Usage\n\n### Keybinds\n\n- Quit: `q` or `\u003cC-c\u003e`\n- Process navigation\n  - `k` and `\u003cUp\u003e`: up\n  - `j` and `\u003cDown`: down\n  - `\u003cC-u\u003e`: half page up\n  - `\u003cC-d\u003e`: half page down\n  - `\u003cC-b\u003e`: full page up\n  - `\u003cC-f\u003e`: full page down\n  - `gg` and `\u003cHome\u003e`: jump to top\n  - `G` and `\u003cEnd\u003e`: jump to bottom\n- Process actions:\n  - `\u003cTab\u003e`: toggle process grouping\n  - `dd`: kill selected process or group of processes\n- Process sorting\n  - `c`: CPU\n  - `m`: Mem\n  - `p`: PID\n- CPU and Mem graph scaling:\n  - `h`: scale in\n  - `l`: scale out\n- `?`: toggles keybind help menu\n\n### Mouse\n\n- click to select process\n- mouse wheel to scroll through processes\n\n### Colorschemes\n\ngotop ships with a few colorschemes which can be set with the `-c` flag followed by the name of one. You can find all the colorschemes in the [colorschemes folder](./colorschemes).\n\nTo make a custom colorscheme, check out the [template](./colorschemes/template.go) for instructions and then use [default.json](./colorschemes/default.json) as a starter. Then put the file at `~/.config/gotop/\u003cname\u003e.json` and load it with `gotop -c \u003cname\u003e`. Colorschemes PR's are welcome!\n\n### CLI Options\n\n`-c`, `--color=NAME` Set a colorscheme.  \n`-m`, `--minimal` Only show CPU, Mem and Process widgets.  \n`-r`, `--rate=RATE` Number of times per second to update CPU and Mem widgets [default: 1].  \n`-V`, `--version` Print version and exit.  \n`-p`, `--percpu` Show each CPU in the CPU widget.  \n`-a`, `--averagecpu` Show average CPU in the CPU widget.  \n`-s`, `--statusbar` Show a statusbar with the time.  \n`-b`, `--battery` Show battery level widget (`minimal` turns off). [preview](./assets/screenshots/battery.png)\n`-i`, `--interface=NAME` Select network interface [default: all].\n\n## Built With\n\n- [gizak/termui](https://github.com/gizak/termui)\n  - [nsf/termbox](https://github.com/nsf/termbox-go)\n- [exrook/drawille-go](https://github.com/exrook/drawille-go)\n- [shirou/gopsutil](https://github.com/shirou/gopsutil)\n- [goreleaser/nfpm](https://github.com/goreleaser/nfpm)\n- [distatus/battery](https://github.com/distatus/battery)\n\n## Stargazers over time\n\n[![Stargazers over time](https://starcharts.herokuapp.com/cjbassi/gotop.svg)](https://starcharts.herokuapp.com/cjbassi/gotop)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcjbassi%2Fgotop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcjbassi%2Fgotop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcjbassi%2Fgotop/lists"}