Skip to main content

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

Project description

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.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

usts-0.1.7-py3-none-any.whl (22.4 kB view details)

Uploaded Python 3

File details

Details for the file usts-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: usts-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 22.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.10

File hashes

Hashes for usts-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 117676438033f08a242f877cf08c627d10a2d3b7360c180fb5c214e47ec5d974
MD5 f15a2f42274718df76e86faac86ea0b9
BLAKE2b-256 411436669e8b73b3c9dc761cd5655e1afb2673b594d66a4819a5f5d66bc3bd33

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page