3 an amazing widget manager for an awesome window manager
5 Usage: amazing [options]
6 -c, --config FILE Configuration file (~/.amazing.yml)
7 -s, --screen ID Screen ID (0)
8 -l, --log-level LEVEL Severity threshold (info)
9 -i, --include SCRIPT Include a widgets script
10 -u, --update WIDGET Update a widget and exit
11 -w, --list-widgets List available widgets
12 -h, --help You're looking at it
16 * Battery: Remaining battery power in percentage
17 * Maildir: Mail count in maildirs
18 * ALSA: Various data for the ALSA mixer
19 * Raggle: Unread posts in raggle
20 * Memory: Various memory related data
21 * Clock: Displays date and time
57 In this example tb_mail doesn't have an "every" setting and is instead
58 updated manually with <tt>amazing -u tb_mail</tt>, perhaps in cron after fetching
59 new mail via fdm, getmail, fetchmail or similar. A good idea is also to
60 update after closing your MUA such as Mutt which could be done with
61 shell functions, example:
70 TODO: describe this more completely
75 description "Displays date and time"
76 dependency "some/library", "how to get the library (url, gem name...)"
77 option :time_format, "Time format as described in DATE(1)", "%R"
78 field :time, "Formatted time"
82 @time = Time.now.strftime(@time_format)
83 raise WidgetError, "An error occured!" if some_error?
87 The ProcFile class can be used for parsing /proc files:
89 cpuinfo = ProcFile.new("cpuinfo")
90 cpuinfo[1]["model name"]
91 #=> "AMD Turion(tm) 64 X2 Mobile Technology TL-50"
95 Copyright (C) 2008 Dag Odenhall <dag.odenhall@gmail.com>
96 Licensed under the Academic Free License version 3.0