This section lists various objects you can use in the layout portion of your configuration file. Objects are enclosed in ${...}. For example, to display the amount of disk usage on sdcard you could say, versus the amount of available space:

        FS: ${fs_used /sdcard} / ${fs_size /sdcard}
    
You can get more ideas for layouts by looking at the examples.

Object Parameters Description

alignc

Align the text to center.

alignr

Align the text to the right.

battery

Display current battery status and level.

battery_bar

Display a bar of the current battery level.

battery_percent

Display current battery level.

color

Change the current paint color to the default color.

color

(color)

Change the current paint color to the value of color.

  • color - a color name or hexadecimal value

cpu

Display the percentage of cpu usage.

cpubar

Display the percentage of cpu usage in a bar.

cpubar

Display the percentage of cpu usage in a bar.

cpugraph

(color1, color2)

Display a historical graph of cpu usage.

  • color1 - left most color of graph
  • color2 - right most color of graph

cpugraph

(hw, color1, color2)

Display a historical graph of cpu usage.

  • hw - height,width of the graph such as 32,120
  • color1 - left most color of graph
  • color2 - right most color of graph

downspeed

(device)

Display the download speed for a network interface.

  • device - network device such as eth0 or wlan0

downspeedgraph

(device, hw, color1, color2)

Display a historical graph of download speeds for a device.

  • device - network device such as eth0 or wlan0
  • hw - height,width of the graph
  • color1 - left most color of graph
  • color2 - right most color of graph

font

Reset to the current font.

font

(font)

Change to the font described in font

  • font - The font to switch to for drawing

freq

Returns firts CPU's frequency in MHz.

freq

(cpuNum)

Returns CPU n's frequency in MHz.

  • cpuNum - the cpu number

fs_bar

(mountPoint)

Display current file system usage in a usage bar.

  • mountPoint - Mount point such as /sdcard, /system or /data

fs_bar

fs_free

(mountPoint)

Display available diskspace.

  • mountPoint - Mount point such as /sdcard, /system or /data

fs_size

(mountPoint)

Display disk size.

  • mountPoint - Mount point such as /sdcard, /system or /data

fs_used

(mountPoint)

Display the amount of disk usage.

  • mountPoint - Mount point such as /sdcard, /system or /data

fs_used_perc

(mountPoint)

Display the amount of disk usage.

  • mountPoint - Mount point such as /sdcard, /system or /data

goto

(position)

Change current horizontal location to postition

  • position - the new position

hr

Draw a horizontal rule using the default line height.

hr

(lh)

Draw a horizontal rule using a line height of lh.

  • lh - a number, used as the new line height

image

Draw a horizontal rule using the default line height.

interval

Changed the current update interval.

kernel

Display the kernel version.

length

(minLength, maxLength, object)

Limit an objects output to a certain number of characters.

  • minLength - minimum length of the string
  • maxLength - max length of the string
  • object - a text object whose output will be limited to N characters

loadavg

Display the 1, 5 and 15 minute load avgerage of jobs in the run queue.

loadavg

(idx)

Display either 1, 5 or 15 minute load avgerage of jobs in the run queue.

  • idx - An integer value, 1 >e; idx <e; 3.

machine

Display the machine name

mem

Display memory used.

membar

Display memory used in a bar graph.

membar

(hw)

Display memory used in a bar graph.

  • hw - comma delimited string of height and width

memmax

Display the maximum available memory.

memperc

Display the percentage of memory being used.

nodename

Display the system name

offset

(pixels)

Move text horizontally by N pixels

  • pixels - the number of pixels

printf

(format, objects)

Accepts a format string and other text objects.

  • format - a format string as describe in...
  • objects - a variable list of text objects

processes

Display the total number of forks since boot.

realtime

Display the systems time since the system was booted, including deep sleep.

running_processes

Number of processes in runnable state.

stippled_hr

Draw a stippled horizontal rule with the default spacing.

stippled_hr

(spacing)

Draw a stippled horizontal rule with the default spacing.

  • spacing - a number to specify the size of the dashes.

swap

Display the amount of swap memory being used.

swapbar

Display swap memory used in a bar graph.

swapbar

(hw)

Display swap used in a bar graph.

  • hw - comma delimited string of height and width

swapmax

Display the maximum swap memory available.

swapperc

Display the percentage of swap memory being used.

sysname

Display the system name

time

(format)

Prints the local time formatted according to parameter.

  • format - uses C's strftime format to specify time format.

top

(var, num)

Display information about the top running processes. For example to display the top three processes, and their cpu usage:


  ${top name 1}${top cpu 1}
  ${top name 2}${top cpu 2}
  ${top name 3}${top cpu 3}
 

  • var - The name of the variable to display
  • num - An integer, >e; 1

top_mem

(var, num)

Display information about the top memory consuming processes. For example to display the top three processes, and their mem usage:


  ${top name 1}${top mem 1}
  ${top name 2}${top mem 2}
  ${top name 3}${top mem 3}
 

  • var - The name of the variable to display
  • num - An integer, >e; 1

totaldown

(device)

Display the download speed for a network interface.

  • device - network device such as eth0 or wlan0

totalup

(device)

Display the download speed for a network interface.

  • device - network device such as eth0 or wlan0

upspeed

(device)

Display the upload speed for a network interface.

  • device - network device such as eth0 or wlan0

upspeedgraph

(device, hw, color1, color2)

Display a historical graph of upload speeds for a device.

  • device - network device such as eth0 or wlan0
  • hw - height,width of the graph
  • color1 - left most color of graph
  • color2 - right most color of graph

uptime

Display the systems uptime. On android this does not include when the system enters deep sleep. @see Realtime.

vgoto

(position)

Change current vertical location to postition

  • position - the new position

voffset

(pixels)

Move text vertically by N pixels

  • pixels - the number of pixels