README

   1 ================================================================================
   2
   3                             On-Screen Display Daemon
   4
   5                        (c) 2010 Martin Mares <mj@ucw.cz>
   6
   7        You can use and distribute this program under the terms of GPLv2.
   8
   9 ================================================================================
  10
  11
  12 OSDD is a simple daemon whose purpose is to wait for messages sent by other
  13 programs and display them on the screen using libxosd. Unlike other such
  14 daemons, it handles message attributes (like colors), keeps its eye on
  15 message timing and uses X properties to pass messages, so it works over SSH
  16 connections with X forwarding.
  17
  18 I have developed osdd on Linux, but it should work on any recent POSIX-compliant
  19 system equipped with libX11 and libxosd.
  20
  21 Please send all bug reports and suggestions to the author.
  22
  23 Usage
  24 ~~~~~
  25 When you run `osdd' without any parameters, it forks and waits in the background
  26 to serve the messages. It is convenient to invoke it from ~/.xsession, so that
  27 it is started with your X session. It should exit properly when the session
  28 terminates.
  29
  30 The simplest way of sending messages to the daemon is using the `osdc' client,
  31 e.g., `osdc "Hello world!"'. Use multiple parameters to create a multi-line
  32 message (however, the maximum number of lines is fixed and it can be changed
  33 only by the `--lines' switch on daemon startup).
  34
  35 You can also add attributes to the message (written as command-line options):
  36
  37   --color=c             Set foreground color of the message. Colors are specified
  38                         either as #RGB, or #RRGGBB, or color names from X11 rgb.txt,
  39                         or any other method documented in XParseColor(3).
  40
  41   --outline-color=c     Set color of character outlines.
  42
  43   --duration=ms         Show the message for a given number of miliseconds.
  44
  45   --min-duration=ms     When another message arrives while this one is displayed,
  46                         the duration of this message can be shortened, but not
  47                         below this parameter.
  48
  49   --percent=p           Draw a line with a percentage bar (p=0..100)
  50
  51   --slider=p            Draw a line with a slider (p=0..100)
  52
  53 The default values of most of these attributes can be given by command-line
  54 options of the daemon, use `osdd --help' to get the full list.
  55
  56 Any value can be replaced by "-", meaning "read from standard input".
  57
  58
  59 Example clients
  60 ~~~~~~~~~~~~~~~
  61
  62 osd-clock               Display current date and time (a shell script piping
  63                         its output to osdc).
  64
  65 osd-mpc-volume          Adjust volume of the MPD music player daemon and show
  66                         a slider with the new value.
  67
  68 osd-batt                A slightly more complex client written in C, showing
  69                         the current status of laptop batteries. It can be asked
  70                         to show status immediately or to run in background and
  71                         croak whenever the battery is low.
  72
  73 osd-alsa                Adjust volume of an ALSA mixer channel. Also written in C.