Metadata-Version: 2.1
Name: usts
Version: 0.1.3
Summary: Simple cli tool for creating status text to something like dwm-bar.
Home-page: https://notabug.org/loliconshik3/usts
Author: loliconshik3
Description-Content-Type: text/markdown
License-File: LICENSE

# usts 

Simple cli tool for creating status text to something like dwm-bar.

## Modules

| Module    | Dependencies | Description                                          |
| :---:     | :---:        | :---                                                 |
| `str`     |              | Display string.                                      |
| `time`    | `datetime`   | Display current time with strftime formating.        |
| `cpu`     | `psutil`     | Display percent of cpu usage.                        |
| `ram`     | `psutil`     | Display memory usage (percent, available, etc...)    |
| `disk`    | `os`         | Display disk usage (free, available, total)          |
| `temp`    | `psutil`     | Display temperature (cpu, gpu, etc...)               | 

## Installation

```sh
$ pip install usts
```

## ~/.config/usts/config.py example

```py
# import make functions from mkmod.py file
from usts.mkmod import *

# setup list of items
items = [
    ModuleCPU(),
    # print example -> RAM: 10.1/16.0Gb
    ModuleRAM("RAM: {used}/{total}{data_format}", data_format="Gb"),
    # print example -> /: 121.3Gb
    ModuleDisk("{path}: {free}{data_format}"),  
    ModuleTime(),
    ModuleStr("☭")
]

# Execute is action with status
#   setxroot -> setxroot -name "status"
#   stdout   -> just print status in terminal
execute = "stdout"
```

## Usage

```sh
$ usts
```

## Contacts

| Contact                                               | Description       |
| :---:                                                 | :---              |
| [`Matrix`](https://matrix.to/#/#librehub:matrix.org)  | Matrix server.    |
| [`Discord`](https://discord.gg/naGkzRN)               | Discord server.   |

## Donates
**Monero:** `47KkgEb3agJJjSpeW1LpVi1M8fsCfREhnBCb1yib5KQgCxwb6j47XBQAamueByrLUceRinJqveZ82UCbrGqrsY9oNuZ97xN`

