Skip to main content

qosd - display text over your Xorg screen

qosd is a command-line tool and python library can display text over your Linux desktop screen:

  • text is displayed over any window (On-Screen-Display)
  • display simple line
  • tail stdin
  • transparency and text style is configurable

Install

pip install qosd

Usage

usage: qosd [-h] [-i] [-m MAXLINES] [-n SESSION_NAME] [-o OPACITY] [-p {topleft,topright,bottomleft,bottomright}] [-P POSITION_OFFSET POSITION_OFFSET] [-s STYLE] [-t TIMEOUT] text [text ...]

qosd - OSD from python - v20230516

positional arguments:
  text                  text to display, or '-' for stdin

options:
  -h, --help            show this help message and exit
  -i, --no-input        set window transparent to input
  -m MAXLINES, --maxlines MAXLINES
                        default: 30
  -n SESSION_NAME, --session-name SESSION_NAME
                        start named OSD display session, killing previous OSD with same session name
  -o OPACITY, --opacity OPACITY
                        default: 1.0
  -p {topleft,topright,bottomleft,bottomright}, --position {topleft,topright,bottomleft,bottomright}
                        text position, default=topleft
  -P POSITION_OFFSET POSITION_OFFSET, --position-offset POSITION_OFFSET POSITION_OFFSET
                        offset in pixels from position, default: 0 0
  -s STYLE, --style STYLE
                        default: 'color:"#FFFFFF";background-color:"#99000000";font-size:11pt;font-weight:bold;'
  -t TIMEOUT, --timeout TIMEOUT
                        display timeout in seconds, default: 3

examples:
$ qosd hello
$ tail -f /var/log/{messages,auth.log} | qosd -

Metadata

Release files for qosd 20230518

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

Source distribution (sdist)

Source distribution for qosd 20230518
File Size Uploaded
qosd-20230518.tar.gz 4.4 kB Details

Built distribution (wheel)

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

Total release size: 9.2 kB

Release files / qosd-20230518.tar.gz

Download URL qosd-20230518.tar.gz
Size 4.4 kB
Tags Source
SHA-256 checksum
How to use checksums
3780764c9b25c3e49224df1d5311eca4a80e656710e0e748efeb1578d7f60d05
BLAKE2b-256 checksum
How to use checksums
efec4af94d70998d8d78862a5de21beb4803a7f72538d16d53d05a349c479a9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.3

Release files / qosd-20230518-py3-none-any.whl

Download URL qosd-20230518-py3-none-any.whl
Size 4.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1ebf36437373597577aa27b0b0e94a24bad923857bd3c6a26a26d5b8902d4f1f
BLAKE2b-256 checksum
How to use checksums
0ec0d56a6112c882908b7193d04c29788fb6ec3ef1d5ce55160f055fa2b0fd4f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.3

Release history Release notifications | RSS feed

This release

20230518 This release

2 release files

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