{"id":13503108,"url":"https://github.com/p-e-w/hegemon","last_synced_at":"2025-04-04T21:10:24.569Z","repository":{"id":62440066,"uuid":"149846714","full_name":"p-e-w/hegemon","owner":"p-e-w","description":"A modular system monitor written in Rust","archived":false,"fork":false,"pushed_at":"2020-03-19T06:19:28.000Z","size":147,"stargazers_count":329,"open_issues_count":13,"forks_count":18,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-10-30T03:49:25.742Z","etag":null,"topics":["linux","rust","system-monitoring","terminal"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/p-e-w.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-22T04:55:48.000Z","updated_at":"2024-10-28T22:45:18.000Z","dependencies_parsed_at":"2022-11-01T22:01:41.918Z","dependency_job_id":null,"html_url":"https://github.com/p-e-w/hegemon","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p-e-w%2Fhegemon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p-e-w%2Fhegemon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p-e-w%2Fhegemon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p-e-w%2Fhegemon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/p-e-w","download_url":"https://codeload.github.com/p-e-w/hegemon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247249532,"owners_count":20908212,"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":["linux","rust","system-monitoring","terminal"],"created_at":"2024-07-31T22:02:37.377Z","updated_at":"2025-04-04T21:10:24.530Z","avatar_url":"https://github.com/p-e-w.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"## Introducing Hegemon\n\n[![Crates.io](https://img.shields.io/crates/v/hegemon.svg)](https://crates.io/crates/hegemon)\n[![Build Status](https://travis-ci.org/p-e-w/hegemon.svg?branch=master)](https://travis-ci.org/p-e-w/hegemon)\n[**GitLab Mirror**](https://gitlab.com/p-e-w/hegemon)\n\nHegemon is a **work-in-progress** [modular](#adding-new-data-streams) system monitor\nwritten in safe Rust.\n\n![Screencast](https://user-images.githubusercontent.com/2702526/45913619-818f1100-be53-11e8-8138-6ddfe42e15af.gif)\n\nCurrently, it has the following features:\n\n- Monitor CPU and memory usage, temperatures, and fan speeds\n- Expand any data stream to reveal a more detailed graph and additional information\n- Adjustable update interval\n- Clean MVC architecture with good code quality\n- Unit tests\n\n**Planned** features include:\n\n- macOS and BSD support (only Linux is supported at the moment)\n- Monitor disk and network I/O, GPU usage (maybe), and more\n- Select and reorder data streams\n- Mouse control\n\nHegemon is built around the excellent\n[crossbeam-channel](https://github.com/crossbeam-rs/crossbeam/tree/master/crossbeam-channel),\n[termion](https://gitlab.redox-os.org/redox-os/termion),\n[systemstat](https://github.com/myfreeweb/systemstat),\nand [sensors](https://github.com/nyantec/sensors) crates.\n\n\n## Building\n\nHegemon is currently **Linux only** and requires **Rust 1.34 or later** and the\n**development files for [libsensors](https://github.com/lm-sensors/lm-sensors).**\nThe latter can be found in the package repository of every major Linux distribution,\ne.g. `lm_sensors-devel` in Fedora and `libsensors4-dev` in Ubuntu.\n\nOnce these requirements are met, Hegemon can be built and run with\n\n```\ngit clone https://github.com/p-e-w/hegemon.git\ncd hegemon\ncargo run\n```\n\n\n## Adding new data streams\n\nUnlike traditional system monitors such as `top`, which are tailor-made\nto display specific metrics like CPU and memory usage only, Hegemon shows\nthe output of monitoring modules called *data streams,* whose behavior is\ndefined by the [`Stream`](src/stream.rs) trait.\n\nStreams only need to supply basic properties such as name and description,\nand a method for retrieving a numeric data value. Everything else is managed\nby Hegemon, including update scheduling, layout and rendering, adaptive scaling,\nand computation of statistics.\n\n`Stream` objects are in turn generated by [`StreamProvider`](src/stream.rs)s.\nThis makes it possible to have streams whose exact nature and number can only\nbe determined at runtime, such as one stream per CPU core.\n\nAdding new streams, then, involves the following steps:\n\n1. Create a `StreamProvider`\n2. Make it return `Stream` objects from its `streams` method\n3. Register the provider in [`providers/mod.rs`](src/providers/mod.rs)\n\nThe [`providers`](src/providers) directory contains several working provider\nimplementations that can be used as a reference. In particular, most providers\nwill want to use the `Stream::new` helper function to create streams\ninstead of manually implementing the `Stream` trait.\n\n**Ideas for, and implementations of, additional data streams are very welcome!**\n\n\n## License\n\nCopyright \u0026copy; 2018-2020  Philipp Emanuel Weidmann (\u003cpew@worldwidemann.com\u003e)\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\n**By contributing to this project, you agree to release your\ncontributions under the same license.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fp-e-w%2Fhegemon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fp-e-w%2Fhegemon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fp-e-w%2Fhegemon/lists"}