# mmon

> micro monitor - CLI system monitor

Latest version **1.2.1** (published 2024-12-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install mmon
pnpm add mmon
yarn add mmon
bun add mmon
```

Provides the command `mmon`.

## Health

**Score 25/100 (F)** — status: maintenance-mode.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.1 |
| Published | 2024-12-21 |
| First published | 2016-08-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=4.0.0 |
| Dependencies | 1 |
| Unpacked size | 192.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 83 |
| Author | Sebastian Hildebrandt |
| Maintainers | plusinnovations |
| Keywords | system information, sysinfo, monitor, monitoring, os, linux, osx, cpu, cpuload, memory, file system, fsstats, diskio, netstats, network, network connections, processes, users, internet, docker, battery, CLI |

## Links

- npm: https://www.npmjs.com/package/mmon
- Repository: https://github.com/sebhildebrandt/mmon
- Issues: https://github.com/sebhildebrandt/mmon/issues
- npm.io page: https://npm.io/package/mmon

## Dependencies (1)

- [systeminformation](https://npm.io/package/systeminformation.md) ^5.23.7

## Alternatives

- [launchdarkly-js-client-sdk](https://npm.io/package/launchdarkly-js-client-sdk.md) — 2.5M weekly downloads
- [@elastic/elasticsearch](https://npm.io/package/@elastic/elasticsearch.md) — 2.1M weekly downloads
- [@c8y/client](https://npm.io/package/@c8y/client.md) — 15.3K weekly downloads
- [@signaldb/maverickjs](https://npm.io/package/@signaldb/maverickjs.md) — 1.7K weekly downloads
- [@bbc/http-transport-cache](https://npm.io/package/@bbc/http-transport-cache.md) — 1.2K weekly downloads

## Recent versions

- 1.2.1 (latest) — 2024-12-21
- 1.2.0 — 2024-12-21
- 1.1.5 — 2017-02-19
- 1.1.4 — 2016-11-03
- 1.1.3 — 2016-11-02
- 1.1.2 — 2016-08-30
- 1.1.1 — 2016-08-30
- 1.1.0 — 2016-08-29
- 1.0.4 — 2016-08-23
- 1.0.3 — 2016-08-19
- 1.0.2 — 2016-08-19
- 1.0.1 — 2016-08-19
- 1.0.0 — 2016-08-19

## README

# mmon

<img src="assets//micro-monitor-logo.png" alt="mmon logo">

micro-mon - Simple CLI system and OS information tool for Linux, macOS and
windows implemented in [node.js][nodejs-url]

[![NPM Version][npm-image]][npm-url]
[![NPM Downloads][downloads-image]][downloads-url]
[![Git Issues][issues-img]][issues-url]
[![deps status][daviddm-img]][daviddm-url]
[![MIT license][license-img]][license-url]

## Quick Start

### Installation & Start

```bash
$ npm install mmon -g
$ mmon
```

Press `q` (quit) or `CTRL-c` to exit mmon.

## Features

<img src="assets/micro-monitor-1-1-0.png" alt="mmon screenshot">

- current CPU load
- current MEM usage
- file system usage (overall and per mount)
- file system stats (R/W per second, IOPS)
- network stats (rx, tx per second)
- \# network connections
- \# processes
- top processes
- users online
- [docker][docker-url] containers

I tested it on several Debian, Raspbian, Ubuntu distributions, inside Docker
containers as well as OS X (Mavericks, Yosemite, El Captain, Sierra, High
Sierra, Mojave, Catalina) and Windows 10.

This CLI tool depends on the [systeminformation][systeminformation-url] npm
package that I wrote. Have a look at it, if you are interested.

## Command Line Options

**Set interval**

The default update interval is 2 seconds but you can change it easily: the
following command line option sets it to 5 seconds:

```
mmon -i 5
```

## Version history

| Version | Date       | Comment                                     |
| ------- | ---------- | ------------------------------------------- |
| 1.2.0   | 2024-12-21 | dependencies bump - systeminformation 5.x.x |
| 1.1.5   | 2017-02-19 | dependencies bump                           |
| 1.1.4   | 2016-11-03 | minor refactoring, dependencies bump        |
| 1.1.3   | 2016-11-02 | bug fix mem total, dependencies bump        |
| 1.1.2   | 2016-08-30 | tiny fixes, design improvement              |
| 1.1.1   | 2016-08-30 | systeminformation dependency bump           |
| 1.1.0   | 2016-08-29 | top processes                               |
| 1.0.4   | 2016-08-23 | tiny fixes (merge, use strict)              |
| 1.0.3   | 2016-08-19 | tiny improvement, updated copyright notes   |
| 1.0.2   | 2016-08-19 | tiny fixes                                  |
| 1.0.1   | 2016-08-19 | documentation update, colors                |
| 1.0.0   | 2016-08-19 | initial version                             |

## Comments

If you have ideas or comments, please do not hesitate to contact me.

Happy monitoring!

Sincerely,

Sebastian Hildebrandt, [+innovations](http://www.plus-innovations.com)

## Credits

Written by Sebastian Hildebrandt
[sebhildebrandt](https://github.com/sebhildebrandt)

#### Contributers

- none so far. Comments, pull requests welcome ;-)

## Copyright Information

Linux is a registered trademark of Linus Torvalds, OS X is a registered
trademark of Apple Inc., Windows is a registered trademark of Microsoft
Corporation. Node.js is a trademark of Joyent Inc., Intel is a trademark of
Intel Corporation, Raspberry Pi is a trademark of the Raspberry Pi Foundation,
Debian is a trademark of the Debian Project, Ubuntu is a trademark of Canonical
Ltd., Docker is a trademark of Docker Inc. All other trademarks are the property
of their respective owners.

## License [![MIT license][license-img]][license-url]

> The [`MIT`][license-url] License (MIT)
>
> Copyright &copy; 2014-2020 Sebastian Hildebrandt,
> [+innovations](http://www.plus-innovations.com).
>
> Permission is hereby granted, free of charge, to any person obtaining a copy
> of this software and associated documentation files (the "Software"), to deal
> in the Software without restriction, including without limitation the rights
> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
> copies of the Software, and to permit persons to whom the Software is
> furnished to do so, subject to the following conditions:
>
> The above copyright notice and this permission notice shall be included in all
> copies or substantial portions of the Software.
>
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
> SOFTWARE.
>
> Further details see [LICENSE](LICENSE) file.

[npm-image]: https://img.shields.io/npm/v/mmon.svg?style=flat-square
[npm-url]: https://npmjs.org/package/mmon
[downloads-image]: https://img.shields.io/npm/dm/mmon.svg?style=flat-square
[downloads-url]: https://npmjs.org/package/mmon
[license-url]: https://github.com/sebhildebrandt/mmon/blob/master/LICENSE
[license-img]: https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square
[npmjs-license]: https://img.shields.io/npm/l/mmon.svg?style=flat-square
[systeminformation-url]: https://github.com/sebhildebrandt/systeminformation
[nodejs-url]: https://nodejs.org/en/
[docker-url]: https://www.docker.com/
[daviddm-img]: https://img.shields.io/librariesio/github/sebhildebrandt/mmon?style=flat-square
[daviddm-url]: https://david-dm.org/sebhildebrandt/mmon
[issues-img]: https://img.shields.io/github/issues/sebhildebrandt/mmon.svg?style=flat-square
[issues-url]: https://github.com/sebhildebrandt/mmon/issues

---
_Source: https://npm.io/package/mmon · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
