NOTE: this is not under active development
A simple configuration looks like this:
(use tila-core)
(tila '((output . i3)) ; configuration
(element hostname) ; elements...
(element date-and-time #:color "red"))
This will print the system hostname and the current date.
get the system hostname
print current date & time. FMT
is an optional string in the SRFI-19 format.
says hello
print load average, where COUNT
is a number from 1 to 3, specifying how many to print of the 1m, 5m and 15m load averages
The top-level tila configuration is created using the tila
procedure. tila works by re-printing its information every n
seconds. The interval can be defined in the configuration with the interval
parameter, it defaults to 5 seconds. Additionally, in the future, elements will support their own custom intervals.
The config is an association list of the form '((key . value) ...)
. The
following options are available:
output
i3
(default)
color
- the default color for all elements either a color name or a hex RGB
(
#00BBCC
), defaults towhite
- the default color for all elements either a color name or a hex RGB
(
The configuration is followed by any number of elements, which are created as follows.
This specifies an element. The procedure is either a zero-parameter function (a thunk) or a string. The procedure is called to generate the output at every iteration. The optional color keyword argument specifies the color used.
Tila is written in the Chicken Scheme implementation. You need it installed to run tila. Chicken should be available in most Linux package managers.
To build tila, clone this repo and change to its directory and run
chicken-install -s
. This will put the tila executable in your path. Create the
file ~/.tila
using the example above.
tila is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with tila; see the file LICENSE.md. If not, see http://www.gnu.org/licenses/.