readme.txt

   1 Live info
   2 ---------
   3
   4 This is a tool that shows CPU, memory, I/O, network and battery
   5 information on an always-visible layer, updated once a second.
   6 Uses system-reserved OMAP hardware layer, so should be visible
   7 in most programs that don't use tv-out (tv-out needs that same
   8 layer to send video to TV).
   9
  10 When you want to exit Live info, just run this pnd again.
  11
  12
  13 Fields
  14 ------
  15
  16  17:40:05    real time clock, hours:minutes:seconds
  17
  18  CPU:  100%  total CPU usage, in percent
  19  SYS:    0%  CPU usage by the kernel only
  20  IRQ:   29   CPU interrupts per second
  21  CS:    30   CPU context switches per second
  22  f:   1000M  CPU clock frequency, in MHz
  23  V:  1.375V  CPU voltage
  24
  25  mem
  26  M:    414M  free RAM, in megabytes
  27  S:    125M  free swap space, in megabytes
  28  H:      0M  memory used in huge pages, MB (only shown if nonzero)
  29
  30  i/o
  31  R:  0.0M/s  current read throughput from SD cards, in megabytes/s
  32  W:  0.0M/s  current write throughput to SD cards, in megabytes/s
  33
  34  net
  35  D:    0K/s  download throughput, kilobytes/s
  36  U:    0K/s  upload throughput, kilobytes/s
  37  S:  -45dBm  wifi signal strength, in dBm
  38
  39  batt
  40  C:     91%  estimated battery charge level (from monitoring chip)
  41  t:  13:14   estimated time to empty/full, hours:minutes
  42  V:  3.960V  current battery voltage
  43  P: -1.140W  electric power going into battery, negative means discharge
  44  T:   23.2C  battery temperature
  45
  46
  47 Configuration
  48 -------------
  49
  50 Currently only the layer's position can be changed by editing config.cfg
  51 in appdata (file is automatically created on first run).
  52
  53
  54 Controlling live info
  55 ---------------------
  56
  57 It's possible to hide Live info by sending it USR1 signal and show it
  58 again by sending the same signal. This can be done by simply running
  59 "killall -USR1 liveinfo" command. This command can also be bound to
  60 xfce keyboard shortcuts or similar.
  61
  62 Sending the TERM signal ("killall liveinfo") causes it to cleanly exit
  63 (sending it KILL / -9 signal will leave the layer enabled and visible,
  64 so is not recommended).
  65
  66
  67 Showing custom fields and alternative control
  68 ---------------------------------------------
  69
  70 There is a tool called 'custom' included inside of .pnd, it can be used
  71 to also send commands and display custom fields. The code is included
  72 inside the .pnd and can be integrated in other programs, it's simple
  73 communication over local/unix sockets.
  74
  75 Any command containing a semicolon ":" is interpreted as a field to
  76 display on screen. For example, running
  77 ./custom "fps: 60"
  78 will show that string on screen. There is no removal command, the
  79 string will time out by itself.
  80
  81 Other understood commands are:
  82   quit   - self explanatory
  83   hide
  84   show
  85   poke   - if hidden, show up; if visible, exit
  86
  87
  88 License
  89 -------
  90
  91 3-clause BSD, see COPYING file.
  92 Source code is included in pnd itself.