Skip to main content

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...)
weather requests Display weather from city with openweathermap.org api. Weather icons.
xkbstate subprocess Display keyboard layout with xkblayout-state utility.
bat psutil Display battery level.

Installation

$ pip install usts

~/.config/usts/config.py example

# import modules from mkmod.py file
from usts.mkmod import *
# You also can import each module at self
from usts.modules.modcpu import ModCPU

# setup list of items
items = [
    ModuleWeather("API_KEY", 
                  city="London", country="UK"),
    ModuleTemp(),
    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"
# Separator between modules
#   like: text1 SEPARATOR text2 SEPARATOR text3
separator = " | "
# Update periodic is sleep time between updating display
update_periodic = 1.0

Usage

$ usts

Contacts

Contact Description
Matrix Matrix server.
Discord Discord server.

Donates

Monero: 47KkgEb3agJJjSpeW1LpVi1M8fsCfREhnBCb1yib5KQgCxwb6j47XBQAamueByrLUceRinJqveZ82UCbrGqrsY9oNuZ97xN

Release files for usts 0.1.81

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for usts 0.1.81
File Interpreter ABI Platform
usts-0.1.81-py3-none-any.whl Python 3 none any Details

Release files / usts-0.1.81-py3-none-any.whl

Download URL usts-0.1.81-py3-none-any.whl
Size 23.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a27bdf7a3b2cbf2dff0e73a87d1aca57a3cf247a2f838d51f549a9826d2867a8
BLAKE2b-256 checksum
How to use checksums
541c8c9bcdf37969504d4355b02a8591e2d87e35a8fd0e25fbfe83aae40ab08e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.10

Release history Release notifications | RSS feed

This release

0.1.81 This release

1 release file

0.1.41

1 release file

0.1.8

1 release file

0.1.7

1 release file

0.1.6

1 release file

0.1.5

1 release file

0.1.4

1 release file

0.1.3

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page