Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
O
osdd
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Deploy
Releases
Package registry
Model registry
Operate
Terraform modules
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Jiří Kalvoda
osdd
Commits
3350ac7b
Commit
3350ac7b
authored
14 years ago
by
Martin Mareš
Browse files
Options
Downloads
Patches
Plain Diff
Added a README with brief documentation
parent
db3540de
Branches
Branches containing commit
No related tags found
No related merge requests found
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
README
+71
-0
71 additions, 0 deletions
README
with
71 additions
and
0 deletions
README
0 → 100644
+
71
−
0
View file @
3350ac7b
================================================================================
On-Screen Display Daemon
(c) 2010 Martin Mares <mj@ucw.cz>
You can use and distribute this program under the terms of GPLv2.
================================================================================
OSDD is a simple daemon whose purpose is to wait for messages sent by other
programs and display them on the screen using libxosd. Unlike other such
daemons, it handles message attributes (like colors), keeps its eye on
message timing and uses X properties to pass messages, so it works over SSH
connections with X forwarding.
I have developed osdd on Linux, but it should work on any recent POSIX-compliant
system equipped with libX11 and libxosd.
Please send all bug reports and suggestions to the author.
Usage
~~~~~
When you run `osdd' without any parameters, it forks and waits in the background
to serve the messages. It is convenient to invoke it from ~/.xsession, so that
it is started with your X session. It should exit properly when the session
terminates.
The simplest way of sending messages to the daemon is using the `osdc' client,
e.g., `osdc "Hello world!"'. Use multiple parameters to create a multi-line
message (however, the maximum number of lines is fixed and it can be changed
only by the `--lines' switch on daemon startup).
You can also add attributes to the message (written as command-line options):
--color=c Set foreground color of the message. Colors are specified
either as #RGB, or #RRGGBB, or color names from X11 rgb.txt,
or any other method documented in XParseColor(3).
--outline-color=c Set color of character outlines.
--duration=ms Show the message for a given number of miliseconds.
--min-duration=ms When another message arrives while this one is displayed,
the duration of this message can be shortened, but not
below this parameter.
--percent=p Draw a line with a percentage bar (p=0..100)
--slider=p Draw a line with a slider (p=0..100)
The default values of most of these attributes can be given by command-line
options of the daemon, use `osdd --help' to get the full list.
Any value can be replaced by "-", meaning "read from standard input".
Example clients
~~~~~~~~~~~~~~~
osd-clock Display current date and time (a shell script piping
its output to osdc).
osd-mpc-volume Adjust volume of the MPD music player daemon and show
a slider with the new value.
osd-batt A slightly more complex client written in C, showing
the current status of laptop batteries. It can be asked
to show status immediately or to run in background and
croak whenever the battery is low.
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment