<div align="center">
<kbd>
  <img src="https://github.com/imegeek/terminal-widgets/assets/63346676/dc2f97ad-7f17-421d-947e-c94ddc4cd58d" alt="Preview" />
</kbd>
</div><br>

Terminal Widgets is a command-line interface (CLI) program designed to provide information about their system. It offers a convenient way to monitor various aspects of your system right from your terminal.

## Key Features

- Comprehensive System Metrics: Gain instant access to critical system metrics including hostname, system, battery level, shell name, storage usage, package count, net status, date, time, and RAM statistics.

## Install via PIP
```
pip install terminal-widgets
```

## Local Installation

1. Clone this repository to your local machine.
`git clone https://github.com/imegeek/terminal-widgets`

2. Navigate to the cloned directory.
`cd terminal-widgets`

3. Run the following command to install:
`pip install .`

## Android
Note : If you're running this on Termux, [Termux-API](https://play.google.com/store/apps/details?id=com.termux.api) must be required to run this program.

## Usage

Simply run the **`twidgets`** in your terminal to get an overview of your system status.

## Contributing

Contributions are welcome! If you have any suggestions, bug reports, or feature requests, please open an issue or submit a pull request on GitHub.


## License

This project is licensed under the MIT License - see the LICENSE file for details.