https://github.com/looran/qosd
display text over your Xorg screen
https://github.com/looran/qosd
logs osd tail xorg
Last synced: 8 months ago
JSON representation
display text over your Xorg screen
- Host: GitHub
- URL: https://github.com/looran/qosd
- Owner: looran
- Created: 2023-05-15T20:22:46.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-06T21:17:07.000Z (about 3 years ago)
- Last Synced: 2025-02-12T12:57:07.311Z (over 1 year ago)
- Topics: logs, osd, tail, xorg
- Language: Python
- Homepage:
- Size: 12.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## 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,center,centerleft,centerright}] [-P POSITION_OFFSET POSITION_OFFSET] [-s STYLE] [-t TIMEOUT] text [text ...]
qosd - display text over your Xorg screen - v20230529
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,center,centerleft,centerright}, --position {topleft,topright,bottomleft,bottomright,center,centerleft,centerright}
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 -
```