1conky(1) conky(1)
2
6 conky - A system monitor for X
7
9 conky [ options ]
10
12 Conky is a system monitor for X originally based on torsmo. Since its
13 inception, Conky has changed significantly from its predecessor, while
14 maintaining simplicity and configurability. Conky can display just
15 about anything, either on your root desktop or in its own window. Not
16 only does Conky have many built-in objects, it can also display just
17 about any piece of information by using scripts and other external pro‐
18 grams.
19 Conky has more than 250 built in objects, including support for a
21 plethora of OS stats (uname, uptime, CPU usage, mem usage, disk usage,
22 "top" like process stats, and network monitoring, just to name a few),
23 built in IMAP and POP3 support, built in support for many popular music
24 players (MPD, XMMS2, Audacious), and much much more. Conky can display
25 this info either as text, or using simple progress bars and graph wid‐
26 gets, with different fonts and colours.
27 We are always looking for help, whether its reporting bugs, writing
29 patches, or writing docs. Please use the facilities on GitHub to make
30 bug reports, feature requests, and submit patches.
31 Thanks for your interest in Conky.
33
35 For users compiling from source on a binary distro, make sure you have
36 the X development libraries installed (Unless you configure your build
37 without X11). This should be a package along the lines of "libx11-dev"
38 or "xorg-x11-dev" for X11 libs, and similar "-dev" format for the other
39 libs required (depending on your build options). You should be able to
40 see which extra packages you need to install by reading errors that you
41 get from running `cmake'. The easiest way to view the available build
42 options is to run `ccmake' or `cmake-gui' from the source tree, but be
43 careful when disabling certain features as you may lose desired func‐
44 tionality. E.g., with BUILD_MATH disabled you won't get errors but
45 logarithmic graphs will be normal graphs and gauges will miss their
46 line.
47 Conky has (for some time) been available in the repositories of most
49 popular distributions. Here are some installation instructions for a
50 few:
51 Gentoo users -- Conky is in Gentoo's Portage... simply use "emerge
53 app-admin/conky" for installation.
54 Debian, etc. users -- Conky should be in your repositories, and can be
56 installed by doing "aptitude install conky".
57 Example to compile and run Conky with default components (note that
59 some build options may differ for your system):
60 cmake -D CMAKE_INSTALL_PREFIX:string=/usr .
62 make
64 make install # Optional
66 src/conky
68 Conky has been tested to be compatible with C99 C and C++0x C++, howev‐
70 er it has not been tested with anything other than gcc, and is not
71 guaranteed to work with other compilers.
72 TIP: Try configuring Conky with `ccmake' or `cmake-gui' instead of just
74 `cmake'.
75
77 Conky is generally very good on resources. That said, the more you try
78 to make Conky do, the more resources it is going to consume.
79 An easy way to force Conky to reload your ~/.config/conky/conky.conf:
81 "killall -SIGUSR1 conky". Saves you the trouble of having to kill and
82 then restart.
83
85 Command line options override configurations defined in configuration
86 file.
87 -a | --alignment= ALIGNMENT
89 Text alignment on screen, {top,bottom,middle}_{left,right,mid‐
90 dle} or none. Can also be abbreviated with first chars of posi‐
91 tion, ie. tr for top_right. Only available with build flag
92 BUILD_X11 enabled.
93 -b | --double-buffer
95 Use double buffering (eliminates "flicker"). Only available
96 with build flag BUILD_X11 enabled.
97 -c | --config= FILE
99 Config file to load instead of ~/.config/conky/conky.conf.
100 -C | --print-config
102 Print builtin default config to stdout. See also the section
103 EXAMPLES for more information. Only available with build flag
104 BUILD_BUILTIN_CONFIG enabled.
105 -d | --daemonize
107 Daemonize Conky, aka fork to background.
108 -D | --debug
110 Increase debugging output, ie. -DD for more debugging.
111 -f | --font= FONT
113 Font to use. Only available with build flag BUILD_X11 enabled.
114 -h | --help
116 Prints command line help and exits.
117 -i COUNT
119 Number of times to update Conky (and quit).
120 -o | --own-window
122 Create own window to draw. Only available with build flag
123 BUILD_X11 enabled.
124 -p | --pause= SECONDS
126 Time to pause/wait before actually starting Conky.
127 -q | --quiet
129 Run Conky in 'quiet mode' (ie. no output).
130 -t | --text= TEXT
132 Text to render, remember single quotes, like -t ' $uptime '.
133 -u | --interval= SECONDS
135 Update interval.
136 -v | -V | --version
138 Prints version, build information and general info. Exits after
139 printing.
140 -w | --window-id= WIN_ID
142 Window id to draw. Only available with build flag BUILD_X11 en‐
143 abled.
144 -x X_COORDINATE
146 X position.
147 -X | --display= DISPLAY
149 X11 display to use. Only available with build flag BUILD_X11
150 enabled.
151 -y Y_COORDINATE
153 Y position.
154
156 This is a listing of global configuration options for Conky. These are
157 placed in the conky.config section of your configuration file, before
158 conky.text.
159 The default configuration file location is ~/.config/conky/conky.conf
161 or ${sysconfdir}/conky/conky.conf. On most systems, $sysconfdir is
162 /etc, and you can find the sample config file there in
163 /etc/conky/conky.conf.
164 You might want to copy the default config to ~/.config/conky/conky.conf
166 and then start modifying it. User configs can be found at
167 https://github.com/brndnmtthws/conky/wiki/Configs.
168 Optional arguments are generally denoted with paretheses (i.e., (op‐
170 tional)).
171 alignment
173 Aligned position on screen, may be top_left, top_right, top_mid‐
174 dle, bottom_left, bottom_right, bottom_middle, middle_left, mid‐
175 dle_middle, middle_right, or none (also can be abbreviated as
176 tl, tr, tm, bl, br, bm, ml, mm, mr). See also gap_x and gap_y.
177 append_file
179 Append the file given as argument.
180 background
182 Boolean value, if true, Conky will be forked to background when
183 started.
184 border_inner_margin
186 Inner border margin in pixels (the margin between the border and
187 text).
188 border_outer_margin
190 Outer border margin in pixels (the margin between the border and
191 the edge of the window).
192 border_width
194 Border width in pixels.
195 colorN Predefine a color for use inside conky.text segments. Substi‐
197 tute N by a digit between 0 and 9, inclusively. When specifying
198 the color value in hex, omit the leading hash (#).
199 console_bar_fill
201 A character to fill the console bars.
202 Default: #
204 console_bar_unfill
206 A character to unfill the console bars.
207 Default: .
209 console_graph_ticks
211 A comma-separated list of strings to use as the bars of a graph
212 output to console/shell. The first list item is used for the
213 minimum bar height and the last item is used for the maximum,
214 e.g. " ,_,=,#".
215 cpu_avg_samples
217 The number of samples to average for CPU monitoring.
218 default_bar_height
220 Specify a default height for bars.
221 Default: 6
223 default_bar_width
225 Specify a default width for bars. If not specified, the default
226 value is 0, which causes the bar to expand to fit the width of
227 your Conky window. If you set out_to_console = true, the de‐
228 fault value will be 10 for the text version of the bar.
229 default_color
231 Default color and border color.
232 default_gauge_height
234 Specify a default height for gauges.
235 Default: 25
237 default_gauge_width
239 Specify a default width for gauges.
240 Default: 40
242 default_graph_height
244 Specify a default height for graphs.
245 Default: 25
247 default_graph_width
249 Specify a default width for graphs. If not specified, the de‐
250 fault value is 0, which causes the graph to expand to fit the
251 width of your Conky window. If you set out_to_console = true,
252 the text version of the graph will actually have no width and
253 you will need to set a sensible default or set the height and
254 width of each graph individually.
255 default_outline_color
257 Default outline color.
258 default_shade_color
260 Default shading color and border’s shading color.
261 detect_battery
263 One or more batteries to check in order to use update_inter‐
264 val_on_battery (comma separated).
265 Default: BAT0
267 disable_auto_reload
269 Enable to disable the inotify-based auto config reload feature.
270 diskio_avg_samples
272 The number of samples to average for disk I/O monitoring.
273 display
275 Specify an X display to connect to.
276 double_buffer
278 Use the Xdbe extension? (eliminates flicker) It is highly rec‐
279 ommended to use own window with this one so double buffer won’t
280 be so big.
281 draw_blended
283 Boolean, blend when rendering drawn image? Some images blend
284 incorrectly breaking alpha with ARBG visuals. This provides a
285 possible work around by disabling blending.
286 Default: True
288 draw_borders
290 Draw borders around text.
291 draw_graph_borders
293 Draw borders around graphs.
294 draw_outline
296 Draw outlines.
297 draw_shades
299 Draw shades.
300 extra_newline
302 Put an extra newline at the end when writing to stdout, useful
303 for writing to awesome’s wiboxes.
304 font Font name in X, xfontsel can be used to get a nice font.
306 fontN Predefine a font to be used in conky.text segments. Substitute
308 N by a number between 0 and 9 inclusive. Use the same format as
309 a font variable.
310 forced_redraw
312 Boolean value, if true, Conky will redraw everything when you
313 switch the workspace. This may cause delays/flickering on some
314 WMs.
315 format_human_readable
317 If enabled, values which are in bytes will be printed in human
318 readable format (i.e., KiB, MiB, etc). If disabled, the number
319 of bytes is printed instead.
320 gap_x Gap, in pixels, between right or left border of screen, same as
322 passing -x at command line, e.g. gap_x 10. For other position
323 related stuff, see `alignment'.
324 gap_y Gap, in pixels, between top or bottom border of screen, same as
326 passing -y at command line, e.g. gap_y 10. For other position
327 related stuff, see `alignment'.
328 github_token
330 Specify API token for GitHub notifications.
331 Create an API token at https://github.com/settings/to‐
333 kens/new?scopes=notifications&description=conky.
334 hddtemp_host
336 Hostname to connect to for hddtemp objects.
337 Default: 127.0.0.1
339 hddtemp_port
341 Port to use for hddtemp connections.
342 Default: 7634
344 http_port
346 Port to listen to for HTTP connections. Default value is 10080,
347 but is blocked by Firefox and Chrome, so you really want to
348 change it.
349 Default: 10080
351 http_refresh
353 When this is set the page generated with out_to_http will auto‐
354 matically refresh each interval.
355 if_up_strictness
357 How strict should if_up be when testing an interface for being
358 up? The value is one of up, link or address, to check for the
359 interface being solely up, being up and having link or being up,
360 having link and an assigned IP address.
361 imap host user pass [`-i interval (in seconds)'] [“-f `folder'”] [`-p
363 port'] [“-e `command'”] [`-r retries']
364 Default global IMAP server. Default port is 143, default folder
365 is `INBOX', default interval is 5 minutes, and default number of
366 retries before giving up is 5. If the password is supplied as
367 ’*’, you will be prompted to enter the password when Conky
368 starts.
369 imlib_cache_flush_interval
371 Interval (in seconds) to flush Imlib2 cache.
372 imlib_cache_size
374 Imlib2 image cache size, in bytes. Increase this value if you
375 use $image lots. Set to 0 to disable the image cache.
376 Default: 4194304
378 lua_mouse_hook function_name
380 This function, if defined, will be called by Conky upon receiv‐
381 ing mouse events from X. Requires X support. A table contain‐
382 ing event information will be passed to this function as the
383 first argument. Use this hook for detecting mouse input and
384 acting on it. Conky puts `conky_' in front of function_name to
385 prevent accidental calls to the wrong function unless you place
386 `conky_' in front of it yourself.
387 lowercase
389 Boolean value, if true, text is rendered in lower case.
390 lua_draw_hook_post function_name [`function arguments']
392 This function, if defined, will be called by Conky through each
393 iteration after drawing to the window. Requires X support.
394 Takes any number of optional arguments. Use this hook for draw‐
395 ing things on top of what Conky draws. Conky puts `conky_' in
396 front of function_name to prevent accidental calls to the wrong
397 function unless you place `conky_' in front of it yourself.
398 lua_draw_hook_pre function_name [`function arguments']
400 This function, if defined, will be called by Conky through each
401 iteration before drawing to the window. Requires X support.
402 Takes any number of optional arguments. Use this hook for draw‐
403 ing things on top of what Conky draws. Conky puts `conky_' in
404 front of function_name to prevent accidental calls to the wrong
405 function unless you place `conky_' in front of it yourself.
406 lua_load
408 Loads the Lua scripts separated by spaces.
409 lua_shutdown_hook function_name [`function arguments']
411 This function, if defined, will be called by Conky at shutdown
412 or when the configuration is reloaded. Use this hook to clean
413 up after yourself, such as freeing memory which has been allo‐
414 cated by external libraries via Lua. Conky puts `conky_' in
415 front of function_name to prevent accidental calls to the wrong
416 function unless you place `conky_' in front of it yourself.
417 lua_startup_hook function_name [`function arguments']
419 This function, if defined, will be called by Conky at startup or
420 when the configuration is reloaded. Use this hook to initialize
421 values, or for any run-once applications. Conky puts `conky_'
422 in front of function_name to prevent accidental calls to the
423 wrong function unless you place `conky_' in front of it your‐
424 self.
425 mail_spool
427 Mail spool for mail checking.
428 max_port_monitor_connections
430 Allow each port monitor to track at most this many connections.
431 Default: 256
433 max_text_width seconds
435 When a line in the output contains `width' chars and the end
436 isn’t reached, the next char will start on a new line. If you
437 want to make sure that lines don’t get broken, set `width' to 0.
438 max_user_text seconds
440 Maximum size of user text buffer in bytes, i.e. text inside
441 conky.text section in config file.
442 Default: 16384
444 maximum_width seconds
446 Maximum width of window.
447 minimum_height seconds
449 Minimum height of the window.
450 minimum_width seconds
452 Minimum width of window.
453 mpd_host
455 Host of MPD server.
456 mpd_password
458 MPD server password.
459 mpd_port
461 Port of MPD server.
462 music_player_interval
464 Music player thread update interval.
465 Default: update interval
467 mysql_db
469 MySQL database to use.
470 Default: mysql
472 mysql_host
474 Host of MySQL server
475 Default: localhost
477 mysql_password
479 Password of the MySQL user. Place it between "-chars. When
480 this is not set there is no password used.
481 mysql_port
483 Port of MySQL server.
484 mysql_user
486 MySQL user name to use when connecting to the server. Defaults
487 to your username.
488 net_avg_samples
490 The number of samples to average for net data.
491 no_buffers
493 Subtract (file system) buffers from used memory.
494 nvidia_display
496 The display that the nvidia variable will used.
497 Default: $DISPLAY
499 out_to_console
501 Print text to stdout.
502 out_to_http
504 Let conky act as a small http-server serving its text.
505 out_to_ncurses
507 Print text in the console, but use ncurses so that conky can
508 print the text of a new update over the old text. (In the fu‐
509 ture this will provide more useful things).
510 out_to_stderr
512 Print text to stderr.
513 out_to_wayland
515 Open a Wayland window to display output.
516 out_to_x
518 When set to no, there will be no output in X (useful when you
519 also use things like out_to_console). If you set it to no, make
520 sure that it’s placed before all other X-related setting (take
521 the first line of your configfile to be sure).
522 Default: True
524 override_utf8_locale
526 Force UTF8. Requires XFT.
527 overwrite_file
529 Overwrite the file given as argument.
530 own_window
532 Boolean, create own window to draw.
533 own_window_argb_value
535 When ARGB visuals are enabled, this use this to modify the alpha
536 value used. Valid range is 0-255, where 0 is 0% opacity, and
537 255 is 100% opacity.
538 own_window_argb_visual
540 Boolean, use ARGB visual? ARGB can be used for real transparen‐
541 cy, note that a composite manager is required for real transpar‐
542 ency. This option will not work as desired (in most cases) in
543 conjunction with `own_window_type override'.
544 own_window_class
546 Manually set the WM_CLASS name.
547 Default: Conky
549 own_window_colour seconds
551 If own_window_transparent no, set a specified background colour.
552 Takes either a hex value (e.g. `#ffffff'), a shorthand hex value
553 (e.g. `#fff'), or a valid RGB nam (see /usr/lib/X11/rgb.txt).
554 Default: black
556 own_window_hints seconds
558 If own_window is yes, you may use these window manager hints to
559 affect the way Conky displays. Notes: Use own_window_type desk‐
560 top as another way to implement many of these hints implicitly.
561 If you use own_window_type override, window manager hints have
562 no meaning and are ignored.
563 own_window_title
565 Manually set the window name.
566 Default: conky ()
568 own_window_transparent
570 Boolean, set transparency? If ARGB visual is enabled, sets
571 background opacity to 0%.
572 own_window_type
574 if own_window is yes, you may specify type normal, desktop,
575 dock, panel, utility or override. Desktop windows are special
576 windows that have no window decorations; are always visible on
577 your desktop; do not appear in your pager or taskbar; and are
578 sticky across all workspaces. Utility windows are like desktop
579 windows, except they appear above everything else rather than
580 below. Panel windows reserve space along a desktop edge, just
581 like panels and taskbars, preventing maximized windows from
582 overlapping them. The edge is chosen based on the alignment op‐
583 tion. Override windows are not under the control of the window
584 manager. Hints are ignored. This type of window can be useful
585 for certain situations.
586 Default: normal
588 pad_percents
590 Pad percentages to this many decimals (0 = no padding).
591 pop3 host user pass [`-i interval (in seconds)'] [`-p port'] [“-e `com‐
593 mand'”] [`-r retries']
594 Default global POP3 server. Arguments are: `host user pass [-i
595 interval (in seconds)] [-p port] [-e `command'] [-r retries]".
596 Default port is 110, default interval is 5 minutes, and default
597 number of retries before giving up is 5. If the password is
598 supplied as ’*’, you will be prompted to enter the password when
599 Conky starts.
600 short_units
602 Shortens units to a single character (kiB->k, GiB->G, etc.).
603 show_graph_range
605 Shows the time range covered by a graph.
606 show_graph_scale
608 Shows the maximum value in scaled graphs.
609 graph_gradient_mode (rbg|hcl|hsv)
611 Changes the color space used for interpolation. Arguments are
612 hcl, hsv, and rgb (default).
613 Default: rgb
615 stippled_borders
617 Border stippling (dashing) in pixels.
618 store_graph_data_explicitly
620 Enable storing graph data explicitly by ID. This avoids resets
621 while using conditional colors. This option should be disabled
622 while using graphs indirectly e.g. via execpi or lua_parse.
623 Otherwise the graph stays emtpy. The default value is true.
624 Default: True
626 temperature_unit
628 Desired output unit of all objects displaying a temperature.
629 Parameters are either fahrenheit or celsius.
630 Default: celsius
632 templateN
634 Define a template for later use inside conky.text segments.
635 Substitute N by a digit between 0 and 9, inclusively. The value
636 of the variable is being inserted into the stuff inside
637 conky.text at the corresponding position, but before some sub‐
638 stitutions are applied:
639 • \\n -> newline
641 • \\ -> backslash
643 • \\ -> space
645 • \\N -> template argument N (starting from 1)
647 text_buffer_size seconds
649 Size of the standard text buffer (default is 256 bytes). This
650 buffer is used for intermediary text, such as individual lines,
651 output from $exec vars, and various other variables. Increasing
652 the size of this buffer can drastically reduce Conky’s perfor‐
653 mance, but will allow for more text display per variable. The
654 size of this buffer cannot be smaller than the default value of
655 256 bytes.
656 times_in_seconds
658 If true, variables that output times output a number that repre‐
659 sents seconds. This doesn’t affect $time, $tztime and $utime.
660 top_cpu_separate
662 If true, cpu in top will show usage of one processor’s power.
663 If false, cpu in top will show the usage of all processors’ pow‐
664 er combined.
665 top_name_verbose
667 If true, top name shows the full command line of each process,
668 including arguments (whenever possible). Otherwise, only the
669 basename is displayed. Default value is false.
670 top_name_width
672 Width for $top name value (defaults to 15 characters).
673 total_run_times
675 Total number of times for Conky to update before quitting. Zero
676 makes Conky run forever.
677 units_spacer
679 String to place between values and units.
680 update_interval seconds
682 Update interval.
683 update_interval_on_battery seconds
685 Update interval when running on battery power.
686 uppercase
688 Boolean value, if true, text is rendered in upper case.
689 use_spacer
691 Adds spaces around certain objects to stop them from moving oth‐
692 er things around. Arguments are left, right, and none (de‐
693 fault). The old true/false values are deprecated and default to
694 right/none respectively. Note that this only helps if you are
695 using a mono font, such as Bitstream Vera Sans Mono.
696 Default: none
698 use_xft
700 Use Xft (anti-aliased font and stuff).
701 xftalpha
703 Alpha of Xft font. Must be a value at or between 1 and 0.
704 xinerama_head
706 Specify a Xinerama head.
707
709 To configure what Conky displays, you must supply some variables in the
710 conky.text section of your configuration. In this secton you’ll find a
711 listing of the available variables. Some of them may require build op‐
712 tions to be enabled at compile time for them to work.
713 Colours are parsed using XParseColor(), there might be a list of them:
715 /usr/share/X11/rgb.txt. Colour can be also in #rrggbb format (hex).
716 Some objects may create threads, and sometimes these threads will not
718 be destroyed until Conky terminates. There is no way to destroy or
719 clean up threads while Conky is running. For example, if you use an
720 MPD variable, the MPD thread will keep running until Conky dies. Some
721 threaded objects will use one of the parameters as a key, so that you
722 only have 1 relevant thread running (for example, the $curl, and $rss
723 objects launch one thread per URI).
724 Optional arguments are generally denoted with paretheses (i.e., (op‐
726 tional)).
727 acpiacadapter (adapter)
729 ACPI AC adapter state. On linux, the adapter option specifies
730 the subfolder of /sys/class/power_supply containing the state
731 information (tries AC and ADP1 if there is no argument given).
732 Non-linux systems ignore it.
733 acpifan
735 ACPI fan state.
736 acpitemp
738 ACPI temperature in C.
739 addr (interface)
741 IP address for an interface, or “No Address” if no address is
742 assigned.
743 addrs (interface)
745 IP addresses for an interface (if one - works like addr). Linux
746 only.
747 adt746xcpu
749 CPU temperature from therm_adt746x.
750 adt746xfan
752 Fan speed from therm_adt746x.
753 alignc (num)
755 Align text to centre.
756 alignr (num)
758 Right-justify text, with space of N.
759 apcupsd host port
761 Sets up the connection to apcupsd daemon. Prints nothing.
762 Default: localhost:3551
764 apcupsd_cable
766 Prints the UPS connection type.
767 apcupsd_charge
769 Current battery capacity in percent.
770 apcupsd_lastxfer
772 Reason for last transfer from line to battery.
773 apcupsd_linev
775 Nominal input voltage.
776 apcupsd_load
778 Current load in percent.
779 apcupsd_loadbar
781 Bar showing current load.
782 apcupsd_loadgauge (height),(width)
784 Gauge that shows current load.
785 apcupsd_loadgraph (height),(width) (gradient colour 1) (gradient colour
787 2) (scale) (-t) (-l)
788 History graph of current load.
789 apcupsd_model
791 Prints the model of the UPS.
792 apcupsd_name
794 Prints the UPS user-defined name.
795 apcupsd_status
797 Prints current status (on-line, on-battery).
798 apcupsd_temp
800 Current internal temperature.
801 apcupsd_timeleft
803 Time left to run on battery.
804 apcupsd_upsmode
806 Prints the UPS mode (e.g. standalone).
807 apm_adapter
809 Display APM AC adapter status. FreeBSD, OpenBSD only.
810 apm_battery_life
812 Display APM battery life in percent. FreeBSD, OpenBSD only.
813 apm_battery_time
815 Display remaining APM battery life in hh:mm:ss or “unknown” if
816 AC adapterstatus is on-line or charging. FreeBSD, OpenBSD only.
817 audacious_bar (height),(width)
819 Progress bar.
820 audacious_bitrate
822 Bitrate of current tune.
823 audacious_channels
825 Number of audio channels of current tune.
826 audacious_filename
828 Full path and filename of current tune.
829 audacious_frequency
831 Sampling frequency of current tune.
832 audacious_length
834 Total length of current tune as MM:SS.
835 audacious_length_seconds
837 Total length of current tune in seconds.
838 audacious_main_volume
840 The current volume fetched from Audacious.
841 audacious_playlist_length
843 Number of tunes in playlist.
844 audacious_playlist_position
846 Playlist position of current tune.
847 audacious_position
849 Position of current tune (MM:SS).
850 audacious_position_seconds
852 Position of current tune in seconds.
853 audacious_status
855 Player status (Playing/Paused/Stopped/Not running).
856 audacious_title (max length)
858 Title of current tune with optional maximum length specifier.
859 battery (num)
861 Battery status and remaining percentage capacity of ACPI or APM
862 battery. ACPI battery number can be given as argument.
863 Default: BAT0
865 battery_bar (height),(width) (num)
867 Battery percentage remaining of ACPI battery in a bar. ACPI
868 battery number can be given as argument (use all to get the mean
869 percentage remaining for all batteries).
870 Default: BAT0
872 battery_percent (num)
874 Battery percentage remaining for ACPI battery. ACPI battery
875 number can be given as argument (use all to get the mean per‐
876 centage remaining for all batteries).
877 Default: BAT0
879 battery_power_draw (num)
881 Battery power draw in watts
882 Default: BAT0
884 battery_short (num)
886 Battery status and remaining percentage capacity of ACPI or APM
887 battery. ACPI battery number can be given as argument. This
888 mode display a short status, which means that C is displayed in‐
889 stead of charging, D for discharging, F for full, N for not
890 present, E for empty and U for unknown.
891 Default: BAT0
893 battery_status (num)
895 Battery status for ACPI battery. ACPI battery number can be
896 given as arguments.
897 Default: BAT0
899 battery_time (num)
901 Battery charge/discharge time remaining of ACPI battery. ACPI
902 battery number can be given as argument.
903 Default: BAT0
905 blink text_and_other_conky_vars
907 Let `text_and_other_conky_vars' blink on and off.
908 buffers
910 Amount of memory buffered.
911 cached Amount of memory cached.
913 cat file
915 Reads a file and displays the contents in conky. This is useful
916 if you have an independent process generating output that you
917 want to include in conky.
918 catp file
920 Reads a file and displays the contents in conky. This is useful
921 if you have an independent process generating output that you
922 want to include in conky. This differs from $cat in that it
923 parses the contents of the file, so you can insert things like
924 `${color red}hi!${color}` in your file and have it correctly
925 parsed by Conky.
926 cmdline_to_pid string
928 PID of the first process that has string in its commandline.
929 cmus_aaa
931 Print aaa status of cmus (all/artist/album).
932 cmus_album
934 Prints the album of the current cmus song.
935 cmus_artist
937 Prints the artist of the current cmus song.
938 cmus_curtime
940 Current time of the current cmus song.
941 cmus_date
943 Print the date of the current cmus song.
944 cmus_file
946 Print the file name of the current cmus song.
947 cmus_genre
949 Print the genre name of the current cmus song.
950 cmus_percent
952 Percent of song’s progress.
953 cmus_progress (height),(width)
955 cmus’ progress bar.
956 cmus_random
958 Random status of cmus (on/off).
959 cmus_repeat
961 Repeat status of cmus (song/all/off).
962 cmus_state
964 Current state of cmus (playing, paused, stopped etc).
965 cmus_timeleft
967 Time left of the current cmus song.
968 cmus_title
970 Prints the title of the current cmus song.
971 cmus_totaltime
973 Total length of the current cmus song.
974 cmus_track
976 Print track number of current cmus song.
977 color (color)
979 Change drawing color to color which is a name of a color or a
980 hexcode preceded with #, e.g. #0A1B2C. If you use ncurses only
981 the following colors are supported: red, green, yellow, blue,
982 magenta, cyan, black, and white.
983 colorN Change drawing color to colorN configuration option, where N is
985 a digit between 0 and 9, inclusively.
986 combine var1 var2
988 Places the lines of var2 to the right of the lines of var1 sepa‐
989 rated by the chars that are put between var1 and var2. For ex‐
990 ample: ${combine ${head /proc/cpuinfo 2} - ${head /proc/meminfo
991 1}} gives as output cpuinfo_line1 - meminfo_line1 on line 1 and
992 cpuinfo_line2 - on line 2. $combine vars can also be nested to
993 place more vars next to each other.
994 conky_build_arch
996 CPU architecture Conky was built for.
997 conky_build_date
999 Date Conky was built.
1000 conky_version
1002 Conky version.
1003 cpu (cpuN)
1005 CPU usage in percents. For SMP machines, the CPU number can be
1006 provided as an argument. ${cpu cpu0} is the total usage, and
1007 ${cpu cpuX} (X >= 1) are individual CPUs.
1008 cpubar (cpuN) (height),(width)
1010 Bar that shows CPU usage, height is bar’s height in pixels. See
1011 $cpu for more info on SMP.
1012 cpugauge (cpuN) (height),(width)
1014 Elliptical gauge that shows CPU usage, height and width are
1015 gauge’s vertical and horizontal axis respectively. See $cpu for
1016 more info on SMP.
1017 cpugovernor (cpuN)
1019 The active CPU scaling governor, defaulting to the first core.
1020 See $cpu for more info on SMP. Linux only.
1021 cpugraph (cpuN) (height),(width) (gradient colour 1) (gradient colour
1023 2) (scale) (-t) (-l)
1024 CPU usage graph, with optional colours in hex, minus the #. See
1025 $cpu for more info on SMP. Uses a logarithmic scale (to see
1026 small numbers) when you use the -l switch. Takes the switch
1027 `-t' to use a temperature gradient, which makes the gradient
1028 values change depending on the amplitude of a particular graph
1029 value (try it and see).
1030 curl url (interval_in_minutes)
1032 Download data from URI using Curl at the specified interval.
1033 The interval may be a positive floating point value (0 is al‐
1034 lowed), otherwise defaults to 15 minutes. Most useful when used
1035 in conjunction with Lua and the Lua API. This object is thread‐
1036 ed, and once a thread is created it can’t be explicitly de‐
1037 stroyed. One thread will run for each URI specified. You can
1038 use any protocol that Curl supports.
1039 desktop
1041 Number of the desktop on which conky is running or the message
1042 “Not running in X” if this is the case.
1043 desktop_name
1045 Name of the desktop on which conky is running or the message
1046 “Not running in X” if this is the case.
1047 desktop_number
1049 Number of desktops or the message “Not running in X” if this is
1050 the case.
1051 disk_protect device
1053 Disk protection status, if supported (needs kernel-patch).
1054 Prints either “frozen” or “free” (note the padding).
1055 diskio (device)
1057 Displays current disk IO. Device is optional, and takes the
1058 form of sda for /dev/sda. A block device label can be specified
1059 with label:foo and a block device partuuid can be specified with
1060 partuuid:40000000-01.
1061 diskio_read (device)
1063 Displays current disk IO for reads. Device as in diskio.
1064 diskio_write (device)
1066 Displays current disk IO for writes. Device as in diskio.
1067 diskiograph (device) (height),(width) (gradient colour 1) (gradient
1069 colour 2) (scale) (-t) (-l)
1070 Disk IO graph, colours defined in hex, minus the #. If scale is
1071 non-zero, it becomes the scale for the graph. Uses a logarith‐
1072 mic scale (to see small numbers) when you use -l switch. Takes
1073 the switch `-t' to use a temperature gradient, which makes the
1074 gradient values change depending on the amplitude of a particu‐
1075 lar graph value (try it and see).
1076 diskiograph_read (device) (height),(width) (gradient colour 1) (gradi‐
1078 ent colour 2) (scale) (-t) (-l)
1079 Disk IO graph for reads, colours defined in hex, minus the #.
1080 If scale is non-zero, it becomes the scale for the graph. De‐
1081 vice as in diskio. Uses a logarithmic scale (to see small num‐
1082 bers) when you use -l switch. Takes the switch `-t' to use a
1083 temperature gradient, which makes the gradient values change de‐
1084 pending on the amplitude of a particular graph value (try it and
1085 see).
1086 diskiograph_write (device) (height),(width) (gradient colour 1) (gradi‐
1088 ent colour 2) (scale) (-t) (-l)
1089 Disk IO graph for writes, colours defined in hex, minus the #.
1090 If scale is non-zero, it becomes the scale for the graph. De‐
1091 vice as in diskio. Uses a logarithmic scale (to see small num‐
1092 bers) when you use -l switch. Takes the switch `-t' to use a
1093 temperature gradient, which makes the gradient values change de‐
1094 pending on the amplitude of a particular graph value (try it and
1095 see).
1096 distribution
1098 The name of the distribution. It could be that some of the
1099 untested distributions will show up wrong or as “unknown”, if
1100 that’s the case post a bug on sourceforge, make sure it contains
1101 the name of your distribution, the contents of and if there is a
1102 file that only exists on your distribution, also add the path of
1103 that file in the bug. If there is no such file, please add an‐
1104 other way which we can use to identify your distribution.
1105 downspeed (net)
1107 Download speed in suitable IEC units.
1108 downspeedf (net)
1110 Download speed in KiB with one decimal.
1111 downspeedgraph (netdev) (height),(width) (gradient colour 1) (gradient
1113 colour 2) (scale) (-t) (-l)
1114 Download speed graph, colours defined in hex, minus the #. If
1115 scale is non-zero, it becomes the scale for the graph. Uses a
1116 logarithmic scale (to see small numbers) when you use -l switch.
1117 Takes the switch `-t' to use a temperature gradient, which makes
1118 the gradient values change depending on the amplitude of a par‐
1119 ticular graph value (try it and see).
1120 draft_mails (maildir) (interval)
1122 Number of mails marked as draft in the specified mailbox or mail
1123 spool if not. Only maildir type mailboxes are supported, mbox
1124 type will return -1.
1125 else Text to show if any of the above are not true.
1127 endif Ends an $if block.
1129 entropy_avail
1131 Current entropy available for crypto freaks.
1132 entropy_bar (height),(width)
1134 Normalized bar of available entropy for crypto freaks.
1135 entropy_perc
1137 Percentage of entropy available in comparison to the poolsize.
1138 entropy_poolsize
1140 Total size of system entropy pool for crypto freaks.
1141 eval string
1143 Evaluates given string according to the rules of conky.text in‐
1144 terpretation, i.e. parsing any contained text object specifica‐
1145 tions into their output, any occurring `$′intoasingle′' and so
1146 on. The output is then being parsed again.
1147 exec command
1149 Executes a shell command and displays the output in conky.
1150 Warning: this takes a lot more resources than other variables.
1151 I’d recommend coding wanted behaviour in C/C++ and posting a
1152 patch.
1153 execbar (height),(width) command
1155 Same as exec, except if the first value returned is a value be‐
1156 tween 0-100, it will use that number to draw a horizontal bar.
1157 The height and width parameters are optional, and default to the
1158 default_bar_height and default_bar_width config settings, re‐
1159 spectively.
1160 execgauge (height),(width) command
1162 Same as exec, except if the first value returned is a value be‐
1163 tween 0-100, it will use that number to draw a round gauge (much
1164 like a vehicle speedometer). The height and width parameters
1165 are optional, and default to the default_gauge_height and de‐
1166 fault_gauge_width config settings, respectively.
1167 execgraph command (height),(width) (gradient color 1) (gradient color
1169 2) (scale) (-t) (-l)
1170 Draws a horizontally scrolling graph with values from 0-100
1171 plotted on the vertical axis. All parameters following the com‐
1172 mand are optional. Gradient colors can be specified as hexadec‐
1173 imal values with no 0x or # prefix. Use the -t switch to enable
1174 a temperature gradient, so that small values are “cold” with
1175 color 1 and large values are “hot” with color 2. Without the -t
1176 switch, the colors produce a horizontal gradient spanning the
1177 width of the graph. The scale parameter defines the maximum
1178 value of the graph. Use the -l switch to enable a logarithmic
1179 scale, which helps to see small values. The default size for
1180 graphs can be controlled via the default_graph_height and de‐
1181 fault_graph_width config settings.
1182 If you need to execute a command with spaces, you have a couple
1184 options:
1185 1. wrap your command in double-quotes, or
1187 2. put your command into a separate file, such as
1189 ~/bin/myscript.sh, and use that as your execgraph command.
1190 Remember to make your script executable!
1192 In the following example, we set up execgraph to display seconds
1194 (0-59) on a graph that is 50px high and 200px wide, using a tem‐
1195 perature gradient with colors ranging from red for small values
1196 (FF0000) to yellow for large values (FFFF00). We set the scale
1197 to 60.
1198 ${execgraph ~/seconds.sh 50,200 FF0000 FFFF00 60 -t}
1200 execi interval command
1202 Same as exec, but with a specific interval in seconds. The in‐
1203 terval can’t be less than the update_interval in your configura‐
1204 tion. See also $texeci.
1205 execibar interval (height),(width) command
1207 Same as execbar, but with an interval.
1208 execigauge interval (height),(width) command
1210 Same as execgauge, but with an interval.
1211 execigraph interval command (height),(width) (gradient color 1) (gradi‐
1213 ent color 2) (scale) (-t) (-l)
1214 Same as execgraph, but with an interval.
1215 execp command
1217 Executes a shell command and displays the output in conky.
1218 Warning: this takes a lot more resources than other variables.
1219 I’d recommend coding wanted behaviour in C/C++ and posting a
1220 patch. This differs from $exec in that it parses the output of
1221 the command, so you can insert things like `${color
1222 red}hi!${color}` in your script and have it correctly parsed by
1223 Conky. Caveats: Conky parses and evaluates the output of $execp
1224 every time Conky loops, and then destroys all the objects. If
1225 you try to use anything like $execi within an $execp statement,
1226 it will functionally run at the same interval that the $execp
1227 statement runs, as it is created and destroyed at every inter‐
1228 val.
1229 execpi interval command
1231 Same as execp, but with an interval. Note that the output from
1232 the $execpi command is still parsed and evaluated at every in‐
1233 terval.
1234 flagged_mails (maildir) (interval)
1236 Number of mails marked as flagged in the specified mailbox or
1237 mail spool if not. Only maildir type mailboxes are supported,
1238 mbox type will return -1.
1239 font (font)
1241 Specify a different font. This new font will apply to the cur‐
1242 rent line and everything following. You can use a $font with no
1243 arguments to change back to the default font (much like with
1244 $color).
1245 fontN Change font to fontN configuration option, where N is a digit
1247 between 0 and 9, inclusively.
1248 format_time seconds format
1250 Format time given in seconds. This var only works when the
1251 times_in_seconds configuration setting is on. Format is a
1252 string that should start and end with a double quote " charac‐
1253 ter. The quote characters are not part of the output, ,,,(,)
1254 and \ are replaced by weeks,days,hours,minutes,seconds,(,) and .
1255 If you leave out a unit, it’s value will be expressed in the
1256 highest unit lower than the one left out. Text between ()-chars
1257 will not be visible if a replaced unit in this text is 0. If
1258 seconds is a decimal number then you can see the numbers behind
1259 the point by using followed by a number that specifies the
1260 amount of digits behind the point that you want to see (maximum
1261 9). You can also place a `x' behind so you have all digits be‐
1262 hind the point and no trailing zero’s. (also maximum 9).
1263 forwarded_mails (maildir) (interval)
1265 Number of mails marked as forwarded in the specified mailbox or
1266 mail spool if not. Only maildir type mailboxes are supported,
1267 mbox type will return -1.
1268 free_bufcache
1270 Amount of memory cached or buffered, as reported by free. Linux
1271 only.
1272 freq (n)
1274 Returns CPU #n’s frequency in MHz. CPUs are counted from 1.
1275 Default: 1
1277 freq2 (n)
1279 Returns CPU #n’s clock speed from assembly in MHz. CPUs are
1280 counted from 1.
1281 Default: 1
1283 freq_g (n)
1285 Returns CPU #n’s frequency in GHz. CPUs are counted from 1.
1286 Default: 1
1288 fs_bar (height),(width) fs
1290 Bar that shows how much space is used on a file system. height
1291 is the height in pixels. fs is any file on that file system.
1292 fs_bar_free (height),(width) fs
1294 Bar that shows how much space is free on a file system. height
1295 is the height in pixels. fs is any file on that file system.
1296 fs_free (fs)
1298 Free space on a file system available for users.
1299 fs_free_perc (fs)
1301 Free percentage of space on a file system available for users.
1302 fs_size (fs)
1304 File system size.
1305 fs_type (fs)
1307 File system type.
1308 fs_used (fs)
1310 File system used space.
1311 fs_used_perc (fs)
1313 Percent of file system used space.
1314 gid_name gid
1316 Name of group with this gid.
1317 github_notifications
1319 Number of GitHub notifications.
1320 goto x The next element will be printed at position `x'.
1322 gw_iface
1324 Displays the default route’s interface or “multiple”/“none” ac‐
1325 cordingly.
1326 gw_ip Displays the default gateway’s IP or “multiple”/“none” accord‐
1328 ingly.
1329 hddtemp (dev)
1331 Displays temperature of a selected hard disk drive as reported
1332 by the hddtemp daemon. Use hddtemp_host and hddtemp_port to
1333 specify a host and port for all hddtemp objects. If no dev pa‐
1334 rameter is given, the first disk returned by the hddtemp daemon
1335 is used.
1336 head logfile lines (next_check)
1338 Displays first N lines of supplied text file. The file is
1339 checked every `next_check' update. If next_check is not sup‐
1340 plied, Conky defaults to 2. Max of 30 lines can be displayed,
1341 or until the text buffer is filled.
1342 hr (height)
1344 Horizontal line, height is the height in pixels.
1345 hwmon (dev) type n (factor offset)
1347 Hwmon sensor from sysfs (Linux 2.6). Parameter dev can be: 1.
1348 Number. e.g 1 means hwmon1. 2. Module name. e.g. k10temp
1349 means the first hwmon device whose module name is `k10temp. 3.
1350 Omitted. Then the first hwmon device (hwmon0) will be used.
1351 Parameter type is either in or vol meaning voltage; fan meaning
1353 fan; temp meaning temperature. Parameter n is number of the
1354 sensor. See /sys/class/hwmon/ on your local computer. The op‐
1355 tional arguments factor and offset allow precalculation of the
1356 raw input, which is being modified as follows: input = input *
1357 factor + offset. Note that they have to be given as decimal
1358 values (i.e. contain at least one decimal place).
1359 i2c (dev) type n (factor offset)
1361 I2C sensor from sysfs (Linux 2.6). Parameter dev may be omitted
1362 if you have only one I2C device. Parameter type is either in or
1363 vol meaning voltage; fan meaning fan; temp meaning temperature.
1364 Parameter n is number of the sensor. See /sys/bus/i2c/devices/
1365 on your local computer. The optional arguments factor and off‐
1366 set allow precalculation of the raw input, which is being modi‐
1367 fied as follows: input = input * factor + offset. Note that
1368 they have to be given as decimal values (i.e. contain at least
1369 one decimal place).
1370 i8k_ac_status
1372 If running the i8k kernel driver for Inspiron laptops, displays
1373 whether ac power is on, as listed in /proc/i8k (translated to
1374 human-readable). Beware that this is by default not enabled by
1375 i8k itself.
1376 i8k_bios
1378 If running the i8k kernel driver for Inspiron laptops, displays
1379 the bios version as listed in /proc/i8k.
1380 i8k_buttons_status
1382 If running the i8k kernel driver for Inspiron laptops, displays
1383 the volume buttons status as listed in /proc/i8k.
1384 i8k_cpu_temp
1386 If running the i8k kernel driver for Inspiron laptops, displays
1387 the cpu temperature in Celsius, as reported by /proc/i8k.
1388 i8k_left_fan_rpm
1390 If running the i8k kernel driver for Inspiron laptops, displays
1391 the left fan’s rate of rotation, in revolutions per minute as
1392 listed in /proc/i8k. Beware, some laptops i8k reports these
1393 fans in reverse order.
1394 i8k_left_fan_status
1396 If running the i8k kernel driver for Inspiron laptops, displays
1397 the left fan status as listed in /proc/i8k (translated to human-
1398 readable). Beware, some laptops i8k reports these fans in re‐
1399 verse order.
1400 i8k_right_fan_rpm
1402 If running the i8k kernel driver for Inspiron laptops, displays
1403 the right fan’s rate of rotation, in revolutions per minute as
1404 listed in /proc/i8k. Beware, some laptops i8k reports these
1405 fans in reverse order.
1406 i8k_right_fan_status
1408 If running the i8k kernel driver for Inspiron laptops, displays
1409 the right fan status as listed in /proc/i8k (translated to hu‐
1410 man-readable). Beware, some laptops i8k reports these fans in
1411 reverse order.
1412 i8k_serial
1414 If running the i8k kernel driver for Inspiron laptops, displays
1415 your laptop serial number as listed in /proc/i8k.
1416 i8k_version
1418 If running the i8k kernel driver for Inspiron laptops, displays
1419 the version formatting of /proc/i8k.
1420 ibm_brightness
1422 If running the IBM ACPI, displays the brigtness of the laptops’s
1423 LCD (0-7).
1424 ibm_fan
1426 If running the IBM ACPI, displays the fan speed.
1427 ibm_temps N
1429 If running the IBM ACPI, displays the temperatures from the IBM
1430 temperature sensors (N=0..7) Sensor 0 is on the CPU, 3 is on the
1431 GPU.
1432 ibm_thinklight
1434 If running the IBM ACPI, displays the status of your Think‐
1435 Light™. Value is either `on', `off' or `unknown'.
1436 ibm_volume
1438 If running the IBM ACPI, displays the “master” volume, con‐
1439 trolled by the volume keys (0-14).
1440 ical number file
1442 Shows title of event number `number' in the ical (RFC 5545) file
1443 `file'. The events are first ordered by starting time, events
1444 that started in the past are ignored. The events that are shown
1445 are the VEVENTS, the title that is shown is the SUMMARY and the
1446 starting time used for sorting is DTSTART.
1447 iconv_start codeset_from codeset_to
1449 Convert text from one codeset to another using GNU iconv. Needs
1450 to be stopped with iconv_stop.
1451 iconv_stop
1453 Stop iconv codeset conversion.
1454 if_empty (var)
1456 if conky variable VAR is empty, display everything between
1457 $if_empty and the matching $endif.
1458 if_existing file (string)
1460 if FILE exists, display everything between if_existing and the
1461 matching $endif. The optional second parameter checks for FILE
1462 containing the specified string and prints everything between
1463 $if_existing and the matching $endif.
1464 if_gw if there is at least one default gateway, display everything be‐
1466 tween $if_gw and the matching $endif.
1467 if_match expression
1469 Evaluates the given boolean expression, printing everything be‐
1470 tween $if_match and the matching $endif depending on whether the
1471 evaluation returns true or not. Valid expressions consist of a
1472 left side, an operator and a right side. Left and right sides
1473 are being parsed for contained text objects before evaluation.
1474 Recognised left and right side types are:
1476 • double: Argument consists of only digits and a single dot.
1478 • long: Argument consists of only digits.
1480 • string: Argument is enclosed in quotation marks (").
1482 Valid operands are:
1484 • < or >
1486 • <= or >=
1488 • == or !=
1490 if_mixer_mute (mixer)
1492 If mixer exists, display everything between $if_mixer_mute and
1493 the matching $endif. If no mixer is specified, “Vol” is used.
1494 if_mounted (mountpoint)
1496 if MOUNTPOINT is mounted, display everything between $if_mounted
1497 and the matching $endif.
1498 if_mpd_playing
1500 if mpd is playing or paused, display everything between
1501 $if_mpd_playing and the matching $endif.
1502 if_pa_sink_muted
1504 If Pulseaudio’s default sink is muted, display everything be‐
1505 tween $if_pa_sink_muted and the corresponding $else or $endif.
1506 if_running (process)
1508 If PROCESS is running, display everything between $if_running
1509 and the corresponding $else or $endif. Note that PROCESS may be
1510 either a full command line with arguments (without the directory
1511 prefix), or simply the name of an executable. For example, ei‐
1512 ther of the following will be true if there is a running process
1513 with the command line /usr/bin/conky -u 5:
1514 • ${if_running conky -u 5} or
1516 • ${if_running conky}
1518 It is important not to include trailing spaces. For example,
1520 ${if_running conky } will be false.
1521 if_smapi_bat_installed (INDEX)
1523 when using smapi, if the battery with index INDEX is installed,
1524 display everything between $if_smapi_bat_installed and the
1525 matching $endif.
1526 if_up (interface)
1528 if INTERFACE exists and is up, display everything between $if_up
1529 and the matching $endif.
1530 if_updatenr (updatenr)
1532 If it’s the UPDATENR-th time that conky updates, display every‐
1533 thing between $if_updatenr and the matching $endif. The counter
1534 resets when the highest UPDATENR is reached.
1535 Example: {$if_updatenr 1}foo$endif{$if_updatenr 2}bar$en‐
1537 dif{$if_updatenr 4}$endif shows foo 25% of the time followed by
1538 bar 25% of the time followed by nothing the other half of the
1539 time.
1540 if_xmms2_connected
1542 Display everything between $if_xmms2_connected and the matching
1543 $endif if xmms2 is running.
1544 iface (number)
1546 Display interface names starting from 1, eg ${iface 1}.
1547 image (-p x,y) (-s WxH) (-n) (-f interval)
1549 Renders an image from the path specified using Imlib2. Takes 4
1550 optional arguments: a position, a size, a no-cache switch, and a
1551 cache flush interval. Changing the x,y position will move the
1552 position of the image, and changing the WxH will scale the im‐
1553 age. If you specify the no-cache flag (-n), the image will not
1554 be cached. Alternately, you can specify the -f int switch to
1555 specify a cache flush interval for a particular image. Example:
1556 ${image /home/brenden/cheeseburger.jpg -p 20,20 -s 200x200} will
1557 render `cheeseburger.jpg' at (20,20) scaled to 200x200 pixels.
1558 Conky does not make any attempt to adjust the position (or any
1559 other formatting) of images, they are just rendered as per the
1560 arguments passed. The only reason $image is part of the
1561 conky.text section, is to allow for runtime modifications,
1562 through $execp $lua_parse, or some other method.
1563 imap_messages (args)
1565 Displays the number of messages in your global IMAP inbox by de‐
1566 fault. You can define individual IMAP inboxes separately by
1567 passing arguments to this object. Arguments are: “host user
1568 pass [-i interval (in seconds)] [-f `folder'] [-p port] [-e
1569 `command'] [-r retries]”. Default port is 143, default folder
1570 is `INBOX', default interval is 5 minutes, and default number of
1571 retries before giving up is 5. If the password is supplied as
1572 ’*’, you will be prompted to enter the password when Conky
1573 starts.
1574 imap_unseen (args)
1576 Displays the number of unseen messages in your global IMAP inbox
1577 by default. You can define individual IMAP inboxes separately
1578 by passing arguments to this object. Arguments are: “host user
1579 pass [-i interval (in seconds)] [-f `folder'] [-p port] [-e
1580 `command'] [-r retries]”. Default port is 143, default folder
1581 is `INBOX', default interval is 5 minutes, and default number of
1582 retries before giving up is 5. If the password is supplied as
1583 ’*’, you will be prompted to enter the password when Conky
1584 starts.
1585 intel_backlight
1587 Display the brightness of your Intel backlight in percent.
1588 ioscheduler disk
1590 Prints the current ioscheduler used for the given disk name
1591 (i.e. e.g. “hda” or “sdb”).
1592 irc server(:port) #channel (max_msg_lines)
1594 Shows everything that’s being told in #channel on IRCserver
1595 `server'. TCP-port 6667 is used for the connection unless
1596 `port' is specified. Shows everything since the last time or
1597 the last `max_msg_lines' entries if specified.
1598 journal lines (type)
1600 Displays last N lines of the systemd journal. The optional type
1601 can be `user' or `system' which will show only the user or sys‐
1602 tem journal respectively. By default, all journal lines visible
1603 to the user are shown. A maximum of 200 lines can be displayed,
1604 or until the text buffer is filled.
1605 kernel Kernel version.
1607 key_caps_lock
1609 An indicator for Capital Lock key.
1610 key_num_lock
1612 An indicator for Number Lock key.
1613 key_scroll_lock
1615 An indicator for Scrolling Lock key.
1616 keyboard_layout
1618 Display keyboard layout.
1619 laptop_mode
1621 The value of /proc/sys/vm/laptop_mode.
1622 legacymem
1624 Amount of memory used, calculated the same way as in the free
1625 program.
1626 lines textfile
1628 Displays the number of lines in the given file.
1629 loadavg (1|2|3)
1631 System load average, 1 is for past 1 minute, 2 for past 5 min‐
1632 utes and 3 for past 15 minutes. Without argument, prints all
1633 three values separated by whitespace.
1634 loadgraph (height),(width) (gradient colour 1) (gradient colour 2)
1636 (scale) (-t) (-l)
1637 Load1 average graph, similar to xload, with optional colours in
1638 hex, minus the #. Uses a logarithmic scale (to see small num‐
1639 bers) when you use the -l switch. Takes the switch `-t' to use
1640 a temperature gradient, which makes the gradient values change
1641 depending on the amplitude of a particular graph value (try it
1642 and see).
1643 lowercase text
1645 Converts all letters into lowercase.
1646 lua function_name (function parameters)
1648 Executes a Lua function with given parameters, then prints the
1649 returned string. See also `lua_load' on how to load scripts.
1650 Conky puts `conky_' in front of function_name to prevent acci‐
1651 dental calls to the wrong function unless you place `conky_' in
1652 front of it yourself.
1653 lua_bar (height,width) function_name (function parameters)
1655 Executes a Lua function with given parameters and draws a bar.
1656 Expects result value to be an integer between 0 and 100. See
1657 also `lua_load' on how to load scripts. Conky puts `conky_' in
1658 front of function_name to prevent accidental calls to the wrong
1659 function unless you place `conky_' in front of it yourself.
1660 lua_gauge (height,width) function_name (function parameters)
1662 Executes a Lua function with given parameters and draws a gauge.
1663 Expects result value to be an integer between 0 and 100. See
1664 also `lua_load' on how to load scripts. Conky puts `conky_' in
1665 front of function_name to prevent accidental calls to the wrong
1666 function unless you place `conky_' in front of it yourself.
1667 lua_graph function_name (height),(width) (gradient colour 1) (gradient
1669 colour 2) (scale) (-t) (-l)
1670 Executes a Lua function with and draws a graph. Expects result
1671 value to be any number, and by default will scale to show the
1672 full range. See also `lua_load' on how to load scripts. Takes
1673 the switch `-t' to use a temperature gradient, which makes the
1674 gradient values change depending on the amplitude of a particu‐
1675 lar graph value (try it and see). Conky puts `conky_' in front
1676 of function_name to prevent accidental calls to the wrong func‐
1677 tion unless you put you place `conky_' in front of it yourself.
1678 lua_parse function_name (function parameters)
1680 Executes a Lua function with given parameters as per $lua, then
1681 parses and prints the result value as per the syntax for the
1682 conky.text section. See also `lua_load' on how to load scripts.
1683 Conky puts `conky_' in front of function_name to prevent acci‐
1684 dental calls to the wrong function unless you place `conky_' in
1685 front of it yourself.
1686 machine
1688 Machine, e.g. i686, x86_64.
1689 mails (mailbox) (interval)
1691 Mail count in the specified mailbox or your mail spool if not.
1692 Both mbox and maildir type mailboxes are supported. You can use
1693 a program like fetchmail to get mails from some server using
1694 your favourite protocol. See also new_mails.
1695 mboxscan (-n number of messages to print) (-fw from width) (-sw subject
1697 width) mbox
1698 Print a summary of recent messages in an mbox format mailbox.
1699 mbox parameter is the filename of the mailbox (can be encapsu‐
1700 lated using ’“’, ie. ${mboxscan -n 10”/home/brenden/some box”}
1701 mem Amount of memory in use.
1703 memactive
1705 Amount of active memory. FreeBSD only.
1706 memavail
1708 Amount of available memory as recorded in /proc/meminfo. Linux
1709 3.14+ only.
1710 membar (height),(width)
1712 Bar that shows amount of memory in use.
1713 memdirty
1715 Amount of “dirty” memory. Linux only.
1716 memeasyfree
1718 Amount of free memory including the memory that is very easily
1719 freed (buffers/cache).
1720 memfree
1722 Amount of free memory.
1723 memgauge (height),(width)
1725 Gauge that shows amount of memory in use (see cpugauge).
1726 memgraph (height),(width) (gradient colour 1) (gradient colour 2)
1728 (scale) (-t) (-l)
1729 Memory usage graph. Uses a logarithmic scale (to see small num‐
1730 bers) when you use the -l switch. Takes the switch `-t' to use
1731 a temperature gradient, which makes the gradient values change
1732 depending on the amplitude of a particular graph value (try it
1733 and see).
1734 meminactive
1736 Amount of inactive memory. FreeBSD only.
1737 memlaundry
1739 Amount of memory in the laundry queue. FreeBSD only.
1740 memmax Total amount of memory.
1742 memperc
1744 Percentage of memory in use.
1745 memwired
1747 Amount of wired memory. FreeBSD only.
1748 memwithbuffers
1750 Amount of memory in use, including that used by system buffers
1751 and caches.
1752 memwithbuffersbar (height),(width)
1754 Bar that shows amount of memory in use (including memory used by
1755 system buffers and caches).
1756 memwithbuffersgraph (height),(width) (gradient colour 1) (gradient
1758 colour 2) (scale) (-t) (-l)
1759 Memory usage graph including memory used by system buffers and
1760 cache. Uses a logarithmic scale (to see small numbers) when you
1761 use the -l switch. Takes the switch `-t' to use a temperature
1762 gradient, which makes the gradient values change depending on
1763 the amplitude of a particular graph value (try it and see).
1764 mixer (device)
1766 Prints the mixer value as reported by the OS. On Linux, this
1767 variable uses the OSS emulation, so you need the proper kernel
1768 module loaded. Default mixer is “Vol”, but you can specify one
1769 of the available OSS controls: “Vol”, “Bass”, “Trebl”, “Synth”,
1770 “Pcm”, “Spkr”, “Line”, “Mic”, “CD”, “Mix”, “Pcm2”, “Rec”,
1771 “IGain”, “OGain”, “Line1”, “Line2”, “Line3”, “Digital1”, “Digi‐
1772 tal2”, “Digital3”, “PhoneIn”, “PhoneOut”, “Video”, “Radio” and
1773 “Monitor”.
1774 Default: Vol
1776 mixerbar (device)
1778 Displays mixer value in a bar as reported by the OS. See docs
1779 for $mixer for details on arguments.
1780 mixerl (device)
1782 Prints the left channel mixer value as reported by the OS. See
1783 docs for $mixer for details on arguments.
1784 mixerlbar (device)
1786 Displays the left channel mixer value in a bar as reported by
1787 the OS. See docs for $mixer for details on arguments.
1788 mixerr (device)
1790 Prints the right channel mixer value as reported by the OS. See
1791 docs for $mixer for details on arguments.
1792 mixerrbar (device)
1794 Displays the right channel mixer value in a bar as reported by
1795 the OS. See docs for $mixer for details on arguments.
1796 moc_album
1798 Album of the current MOC song.
1799 moc_artist
1801 Artist of the current MOC song.
1802 moc_bitrate
1804 Bitrate in the current MOC song.
1805 moc_curtime
1807 Current time of the current MOC song.
1808 moc_file
1810 File name of the current MOC song.
1811 moc_rate
1813 Rate of the current MOC song.
1814 moc_song
1816 The current song name being played in MOC.
1817 moc_state
1819 Current state of MOC; playing, stopped etc.
1820 moc_timeleft
1822 Time left in the current MOC song.
1823 moc_title
1825 Title of the current MOC song.
1826 moc_totaltime
1828 Total length of the current MOC song.
1829 monitor
1831 Number of the monitor on which conky is running or the message
1832 “Not running in X” if this is the case.
1833 monitor_number
1835 Number of monitors or the message “Not running in X” if this is
1836 the case.
1837 mouse_speed
1839 Display mouse speed.
1840 mpd_album
1842 Album in current MPD song.
1843 mpd_albumartist
1845 Artist of the album of the current MPD song.
1846 mpd_artist
1848 Artist in current MPD song must be enabled at compile.
1849 mpd_bar (height),(width)
1851 Bar of mpd’s progress.
1852 mpd_bitrate
1854 Bitrate of current song.
1855 mpd_comment (max length)
1857 Comment of current MPD song.
1858 mpd_date
1860 Date of current song.
1861 mpd_elapsed
1863 Song’s elapsed time.
1864 mpd_file
1866 Prints the file name of the current MPD song.
1867 mpd_length
1869 Song’s length.
1870 mpd_name
1872 Prints the MPD name field.
1873 mpd_percent
1875 Percent of song’s progress.
1876 mpd_random
1878 Random status (On/Off).
1879 mpd_repeat
1881 Repeat status (On/Off).
1882 mpd_smart (max length)
1884 Prints the song name in either the form “artist - title” or file
1885 name, depending on whats available.
1886 mpd_status
1888 Playing, stopped, et cetera.
1889 mpd_title (max length)
1891 Title of current MPD song.
1892 mpd_track
1894 Prints the MPD track field.
1895 mpd_vol
1897 MPD’s volume.
1898 mysql query
1900 Shows the first field of the first row of the result of the
1901 query.
1902 nameserver (index)
1904 Print a nameserver from /etc/resolv.conf.
1905 new_mails (mailbox) (interval)
1907 Unread mail count in the specified mailbox or mail spool if not.
1908 Both mbox and maildir type mailboxes are supported.
1909 no_update text
1911 Shows text and parses the vars in it, but doesn’t update them.
1912 Use this for things that do not change while conky is running,
1913 like $machine, $conky_version,... By not updating this you can
1914 save some resources.
1915 nodename
1917 Hostname.
1918 nodename_short
1920 Short hostname (same as `hostname -s' shell command).
1921 nvidia argument (GPU_ID)
1923 Nvidia graphics card information via the XNVCtrl library.
1924 Temperatures are printed as float, all other values as integers.
1926 GPU_ID: Optional parameter to choose the GPU to be used as
1928 0,1,2,3,.. Default parameter is 0
1929 Possible arguments:
1931 Argument Alias Description
1933 ─────────────────────────────────────────────────────────────────────────────
1934 gputemp temp GPU temperature
1935 gputempthresh‐ threshold Temperature threshold where the GPU will re‐
1936 old duce its clock speed
1937 ambienttemp ambient Ambient temperature outside the graphics card
1938 gpufreqcur gpufreq Current GPU clock speed
1939 gpufreqmin Minimum GPU clock speed
1940 gpufreqmax Maximum GPU clock speed
1941 memfreqcur memfreq Current memory clock speed
1942 memfreqmin Minimum memory clock speed
1943 memfreqmax Maximum memory clock speed
1944 mtrfreqcur mtrfreq Current memory transfer rate clock speed
1945 mtrfreqmin Minimum memory transfer rate clock speed
1946 mtrfreqmax Maximum memory transfer rate clock speed
1947 perflevelcur perflevel Current performance level
1948 perflevelmin Lowest performance level
1949 perflevelmax Highest performance level
1950 perfmode Performance mode
1951 gpuutil GPU utilization %
1952 membwutil Memory bandwidth utilization %
1953 videoutil Video engine utilization %
1954 pcieutil PCIe bandwidth utilization %
1955 memused mem Amount of used memory
1956 memfree memavail Amount of free memory
1957 memmax memtotal Total amount of memory
1958 memutil memperc Memory utilization %
1959 fanspeed Fan speed
1960 fanlevel Fan level %
1961 imagequality Image quality
1962 modelname Model name of the GPU card
1963 driverversion Driver version
1964 nvidiabar (height),(width) argument (GPU_ID)
1966 Same as nvidia, except it draws its output in a horizontal bar.
1967 The height and width parameters are optional, and default to the
1968 default_bar_height and default_bar_width config settings, re‐
1969 spectively.
1970 GPU_ID: Optional parameter to choose the GPU to be used as
1972 0,1,2,3,.. Default parameter is 0
1973 Note the following arguments are incompatible:
1975 • gputempthreshold (threshold)
1977 • gpufreqmin
1979 • gpufreqmax
1981 • memfreqmin
1983 • memfreqmax
1985 • mtrfreqmin
1987 • mtrfreqmax
1989 • perflevelmin
1991 • perflevelmax
1993 • perfmode
1995 • memtotal (memmax)
1997 • fanspeed
1999 nvidiagauge (height),(width) argument (GPU_ID)
2001 Same as nvidiabar, except a round gauge (much like a vehicle
2002 speedometer). The height and width parameters are optional, and
2003 default to the default_gauge_height and default_gauge_width con‐
2004 fig settings, respectively.
2005 GPU_ID: Optional parameter to choose the GPU to be used as
2007 0,1,2,3,.. Default parameter is 0
2008 For possible arguments see nvidia and nvidiabar.
2010 nvidiagraph argument (height),(width) (gradient color 1) (gradient col‐
2012 or 2) (scale) (-t) (-l) GPU_ID
2013 Same as nvidiabar, except a horizontally scrolling graph with
2014 values from 0-100 plotted on the vertical axis. The height and
2015 width parameters are optional, and default to the de‐
2016 fault_graph_height and default_graph_width config settings, re‐
2017 spectively.
2018 GPU_ID: NOT optional. This parameter allows to choose the GPU
2020 to be used as 0,1,2,3,..
2021 For possible arguments see nvidia and nvidiabar. To learn more
2023 about the -t -l and gradient color options, see execgraph.
2024 offset (pixels)
2026 Move text over by N pixels. See also $voffset.
2027 outlinecolor (color)
2029 Change outline color.
2030 pa_card_active_profile
2032 Pulseaudio’s default card active profile.
2033 pa_card_name
2035 Pulseaudio’s default card name.
2036 pa_sink_active_port_description
2038 Pulseaudio’s default sink active port description.
2039 pa_sink_active_port_name
2041 Pulseaudio’s default sink active port name.
2042 pa_sink_description
2044 Pulseaudio’s default sink description.
2045 pa_sink_volume
2047 Pulseaudio’s default sink volume percentage.
2048 pa_sink_volumebar
2050 Pulseaudio’s default sink volume bar.
2051 password (length)
2053 Generate random passwords.
2054 pb_battery item
2056 If running on Apple powerbook/ibook, display information on bat‐
2057 tery status. The item parameter specifies, what information to
2058 display. Exactly one item must be specified. Valid items are:
2059 Item Description
2061 ──────────────────────────────────────────────────────────────────────────
2062 sta‐ Display if battery is fully charged, charging, discharging or ab‐
2063 tus sent (running on AC)
2064 per‐ Display charge of battery in percent, if charging or discharging.
2065 cent Nothing will be displayed, if battery is fully charged or absent.
2066 time Display the time remaining until the battery will be fully charged
2067 or discharged at current rate. Nothing is displayed, if battery
2068 is absent or if it’s present but fully charged and not discharg‐
2069 ing.
2070 pid_chroot pid
2072 Directory used as rootdirectory by the process (this will be “/”
2073 unless the process did a chroot syscall).
2074 pid_cmdline pid
2076 Command line this process was invoked with.
2077 pid_cwd pid
2079 Current working directory of the process.
2080 pid_egid pid
2082 The effective gid of the process.
2083 pid_environ pid varname
2085 Contents of a environment-var of the process.
2086 pid_environ_list pid
2088 List of environment-vars that the process can see.
2089 pid_euid pid
2091 The effective uid of the process.
2092 pid_exe pid
2094 Path to executed command that started the process.
2095 pid_fsgid pid
2097 The file system gid of the process.
2098 pid_fsuid pid
2100 The file system uid of the process.
2101 pid_gid pid
2103 The real gid of the process.
2104 pid_nice pid
2106 The nice value of the process.
2107 pid_openfiles pid
2109 List of files that the process has open.
2110 pid_parent pid
2112 The pid of the parent of the process.
2113 pid_priority pid
2115 The priority of the process (see `priority' in “man 5 proc”).
2116 pid_read pid
2118 Total number of bytes read by the process.
2119 pid_sgid pid
2121 The saved set gid of the process.
2122 pid_state pid
2124 State of the process.
2125 pid_state_short pid
2127 One of the chars in “RSDZTW” representing the state of the
2128 process where R is running, S is sleeping in an interruptible
2129 wait, D is waiting in uninterruptible disk sleep, Z is zombie, T
2130 is traced or stopped (on a signal), and W is paging.
2131 pid_stderr pid
2133 Filedescriptor binded to the STDERR of the process.
2134 pid_stdin pid
2136 Filedescriptor binded to the STDIN of the process.
2137 pid_stdout pid
2139 Filedescriptor binded to the STDOUT of the process.
2140 pid_suid pid
2142 The saved set uid of the process.
2143 pid_thread_list pid
2145 List with pid’s from threads from this process.
2146 pid_threads pid
2148 Number of threads in process containing this thread.
2149 pid_time pid
2151 Sum of $pid_time_kernelmode and $pid_time_usermode.
2152 pid_time_kernelmode pid
2154 Amount of time that the process has been scheduled in kernel
2155 mode in seconds.
2156 pid_time_usermode pid
2158 Amount of time that the process has been scheduled in user mode
2159 in seconds.
2160 pid_uid pid
2162 The real uid of the process.
2163 pid_vmdata pid
2165 Data segment size of the process.
2166 pid_vmexe pid
2168 Text segment size of the process.
2169 pid_vmhwm pid
2171 Peak resident set size (“high water mark”) of the process.
2172 pid_vmlck pid
2174 Locked memory size of the process.
2175 pid_vmlib pid
2177 Shared library code size of the process.
2178 pid_vmpeak pid
2180 Peak virtual memory size of the process.
2181 pid_vmpte pid
2183 Page table entries size of the process.
2184 pid_vmrss pid
2186 Resident set size of the process.
2187 pid_vmsize pid
2189 Virtual memory size of the process.
2190 pid_vmstk pid
2192 Stack segment size of the process.
2193 pid_write pid
2195 Total number of bytes written by the process.
2196 platform (dev) type n (factor offset)
2198 Platform sensor from sysfs (Linux 2.6). Parameter dev may be
2199 omitted if you have only one platform device. Platform type is
2200 either in or vol meaning voltage; fan meaning fan; temp meaning
2201 temperature. Parameter n is number of the sensor. See
2202 /sys/bus/platform/devices/ on your local computer. The optional
2203 arguments factor and offset allow precalculation of the raw in‐
2204 put, which is being modified as follows: input = input * factor
2205 + offset. Note that they have to be given as decimal values
2206 (i.e. contain at least one decimal place).
2207 pop3_unseen (args)
2209 Displays the number of unseen messages in your global POP3 inbox
2210 by default. You can define individual POP3 inboxes separately
2211 by passing arguments to this object. Arguments are: “host user
2212 pass [-i interval (in seconds)] [-p port] [-e `command'] [-r re‐
2213 tries]”. Default port is 110, default interval is 5 minutes,
2214 and default number of retries before giving up is 5. If the
2215 password is supplied as ’*’, you will be prompted to enter the
2216 password when Conky starts.
2217 pop3_used (args)
2219 Displays the amount of space (in MiB, 2^20) used in your global
2220 POP3 inbox by default. You can define individual POP3 inboxes
2221 separately by passing arguments to this object. Arguments are:
2222 “host user pass [-i interval (in seconds)] [-p port] [-e `com‐
2223 mand'] [-r retries]”. Default port is 110, default interval is
2224 5 minutes, and default number of retries before giving up is 5.
2225 If the password is supplied as ’*’, you will be prompted to en‐
2226 ter the password when Conky starts.
2227 processes
2229 Total processes (sleeping and running).
2230 read_tcp (host) port
2232 Connects to a tcp port on a host (default is localhost), reads
2233 every char available at the moment and shows them.
2234 read_udp (host) port
2236 Connects to a udp port on a host (default is localhost), reads
2237 every char available at the moment and shows them.
2238 replied_mails (maildir) (interval)
2240 Number of mails marked as replied in the specified mailbox or
2241 mail spool if not. Only maildir type mailboxes are supported,
2242 mbox type will return -1.
2243 rss uri interval_in_seconds action (num_par (spaces_in_front))
2245 Download and parse RSS feeds. The interval may be a (floating
2246 point) value greater than 0. Action may be one of the follow‐
2247 ing: feed_title, item_title (with num par), item_desc (with num
2248 par) and item_titles (when using this action and spaces_in_front
2249 is given conky places that many spaces in front of each item).
2250 This object is threaded, and once a thread is created it can’t
2251 be explicitly destroyed. One thread will run for each URI spec‐
2252 ified. You can use any protocol that Curl supports.
2253 rstrip text
2255 Strips all trailing whitespace from input.
2256 running_processes
2258 Running processes (not sleeping). Requires Linux 2.6.
2259 running_threads
2261 Number of running (runnable) threads. Linux only.
2262 scroll (direction) length (step) (interval) text
2264 Scroll `text' by `step' characters to the left or right (set
2265 `direction' to `left' or `right' or `wait') showing `length'
2266 number of characters at the same time. The text may also con‐
2267 tain variables. `step' is optional and defaults to 1 if not
2268 set. `direction' is optional and defaults to left if not set.
2269 When direction is `wait' then text will scroll left and wait for
2270 `interval' itertations at the beginning and end of the text. If
2271 a var creates output on multiple lines then the lines are placed
2272 behind each other separated with a `|'-sign. If you change the
2273 textcolor inside $scroll it will automatically have it’s old
2274 value back at the end of $scroll. The end and the start of text
2275 will be separated by `length' number of spaces unless direction
2276 is `wait'.
2277 seen_mails (maildir) (interval)
2279 Number of mails marked as seen in the specified mailbox or mail
2280 spool if not. Only maildir type mailboxes are supported, mbox
2281 type will return -1.
2282 shadecolor (color)
2284 Change shading color.
2285 shmem Amount of shared memory. Linux only.
2287 sip_status (switch)
2289 Prints info regarding System Integrity Protection (SIP) on mac‐
2290 OS. If no switch is provided, prints SIP status (enabled / dis‐
2291 abled), else, status of the specific SIP feature corresponding
2292 to the switch provided.
2293 Below are shown the available switches:
2295 SWITCH RESULT STATUS
2297 ──────────────────────────────────────
2298 0 apple internal YES/NO
2299 1 forbid untrusted YES/NO
2300 kexts
2301 2 forbid task-for-pid YES/NO
2302 3 restrict filesystem YES/NO
2303 4 forbid kernel-de‐ YES/NO
2305 bugger
2306 5 restrict dtrace YES/NO
2307 6 restrict nvram YES/NO
2308 7 forbid device-con‐ YES/NO
2309 figuration
2310 8 forbid any-recov‐ YES/NO
2311 ery-os
2312 9 forbid user-ap‐ YES/NO
2313 proved-kexts
2314 uses unsupported configuration?: If yes, prints “unsupported
2316 configuration, beware!” Else, prints “configuration is ok”.
2317 USAGE:
2319 $ conky -t '${sip_status}'
2321 # print SIP status
2322 $ conky -t '${sip_status 0}'
2323 # print allows apple-internal? Yes or No?
2324 NOTES:
2326 • Available for all macOS versions (even the ones prior El Capi‐
2328 tan where SIP was first introduced)
2329 • If run on versions prior El Capitan SIP is unavailable, so all
2331 you will get is “unsupported”.
2332 smapi (ARGS)
2334 When using smapi, display contents of the /sys/devices/plat‐
2335 form/smapi directory. ARGS are either (FILENAME) or bat (INDEX)
2336 (FILENAME) to display the corresponding files’ content. This is
2337 a very raw method of accessing the smapi values. When avail‐
2338 able, better use one of the smapi_* variables instead.
2339 smapi_bat_bar (INDEX),(height),(width)
2341 when using smapi, display the remaining capacity of the battery
2342 with index INDEX as a bar.
2343 smapi_bat_perc (INDEX)
2345 when using smapi, display the remaining capacity in percent of
2346 the battery with index INDEX. This is a separate variable be‐
2347 cause it supports the `use_spacer' configuration option.
2348 smapi_bat_power INDEX
2350 when using smapi, display the current power of the battery with
2351 index INDEX in watt. This is a separate variable because the
2352 original read out value is being converted from mW. The sign of
2353 the output reflects charging (positive) or discharging (nega‐
2354 tive) state.
2355 smapi_bat_temp INDEX
2357 when using smapi, display the current temperature of the battery
2358 with index INDEX in degree Celsius. This is a separate variable
2359 because the original read out value is being converted from mil‐
2360 li degree Celsius.
2361 sony_fanspeed
2363 Displays the Sony VAIO fanspeed information if sony-laptop ker‐
2364 nel support is enabled. Linux only.
2365 startcase text
2367 Capitalises the start of each word.
2368 stippled_hr (space)
2370 Stippled (dashed) horizontal line.
2371 stock symbol data
2373 Displays the data of a stock symbol. The following data is sup‐
2374 ported:
2375 Name Description
2377 ─────────────────────────────────────────
2378 1ytp 1 yr Target Price
2379 200ma 200-day Moving Average
2380 50ma 50-day Moving Average
2381 52weekhigh
2382 52weeklow
2383 52weekrange
2384 adv Average Daily Volume
2385 ag Annualized Gain
2386 ahcrt After Hours Change real‐
2388 time
2389 ask
2390 askrt ask realtime
2391 asksize
2392 bid
2393 bidrt bid realtime
2394 bidsize
2395 bookvalue
2396 c200ma Change From 200-day Moving
2397 Average
2398 c50ma Change From 50-day Moving
2399 Average
2400 c52whigh Change from 52-week high
2401 c52wlow Change From 52-week Low
2402 change
2403 changert change realtime
2404 cip change in percent
2405 commission
2406 cprt change percent realtime
2407 dayshigh
2408 dayslow
2409 dpd Dividend Pay Date
2410 dr day’s range
2411 drrt day’s range realtime
2412 ds dividend/share
2413 dvc Day’s Value Change
2414 dvcrt Day’s Value Change real‐
2415 time
2416 dy Dividend Yield
2417 ebitda
2418 edv Ex-Dividend Date
2419 ei error indication
2420 epsecy EPS Estimate Current Year
2421 epsenq EPS Estimate Next Quarter
2422 epseny EPS Estimate Next Year
2423 es earnings/share
2424 floatshares
2425 hg Holdings Gain
2426 hgp Holdings Gain Percent
2427 hgprt Holdings Gain Percent re‐
2428 altime
2429 hgrt Holdings Gain realtime
2430 hl high limit
2431 hv Holdings Value
2432 hvrt Holdings Value realtime
2433 ll low limit
2434 ltd Last Trade Date
2435 ltp last trade price
2436 lts Last Trade Size
2437 ltt Last Trade Time
2438 mc Market Capitalization
2439 mcrt Market Cap realtime
2440 moreinfo
2441 name
2442 notes
2443 obrt Order Book realtime
2444 open
2445 pb price/book
2446 pc previous close
2447 pc200ma Percent Change From
2448 200-day Moving Average
2449 pc50ma Percent Change From 50-day
2450 Moving Average
2451 pc52whigh percent change from
2452 52-week high
2453 pc52wlow Percent Change From
2454 52-week Low
2455 pegr PEG Ratio
2456 pepsecy Price/EPS Estimate Current
2457 Year
2458 pepseny Price/EPS Estimate Next
2459 Year
2460 per P/E Ratio
2461 perrt P/E Ratio realtime
2462 pricepaid
2463 ps price/sales
2464 se Stock Exchange
2465 sharesowned
2466 shortratio
2467 symbol
2468 tradedate
2469 tradelinks
2471 tt Ticker Trend
2472 volume
2473 swap Amount of swap in use.
2475 swapbar (height),(width)
2477 Bar that shows amount of swap in use.
2478 swapfree
2480 Amount of free swap.
2481 swapmax
2483 Total amount of swap.
2484 swapperc
2486 Percentage of swap in use.
2487 sysctlbyname (name)
2489 Print sysctl value by name. FreeBSD only.
2490 sysname
2492 System name, e.g. Linux.
2493 tab (width, (start))
2495 Puts a tab of the specified width, starting from column `start'.
2496 The unit is pixels for both arguments.
2497 tail logfile lines (next_check)
2499 Displays last N lines of supplied text file. The file is
2500 checked every `next_check' update. If next_check is not sup‐
2501 plied, Conky defaults to 2. Max of 30 lines can be displayed,
2502 or until the text buffer is filled.
2503 tcp_ping host (port)
2505 Displays the number of microseconds it takes to get a reply on a
2506 ping to to tcp `port' on `host'. `port' is optional and has 80
2507 as default. This works on both open and closed ports, just make
2508 sure that the port is not behind a firewall or you will get
2509 `down' as answer. It’s best to test a closed port instead of an
2510 open port, you will get a quicker response.
2511 tcp_portmon port_begin port_end item (index)
2513 TCP port (both IPv6 and IPv4) monitor for specified local ports.
2514 Port numbers must be in the range 1 to 65535. Valid items are:
2515 Item Description
2517 ──────────────────────────────────────
2518 count Total number of connec‐
2519 tions in the range
2520 rip Remote ip address
2521 rhost Remote host name
2522 rport Remote port number
2523 rservice Remote service name from
2524 /etc/services
2525 lip Local ip address
2526 lhost Local host name
2527 lport Local port number
2528 lservice Local service name from
2529 /etc/services
2530 The connection index provides you with access to each connection
2532 in the port monitor. The monitor will return information for
2533 index values from 0 to n-1 connections. Values higher than n-1
2534 are simply ignored. For the count item, the connection index
2535 must be omitted. It is required for all other items.
2536 Examples:
2538 Example Description
2540 ──────────────────────────────────────────────────────────────────────────
2541 ${tcp_portmon 6881 Displays the number of connections in the bittor‐
2542 6999 count} rent port range
2543 ${tcp_portmon 22 22 Displays the remote host ip of the first sshd
2544 rip 0} connection
2545 ${tcp_portmon 22 22 Displays the remote host ip of the tenth sshd
2546 rip 9} connection
2547 ${tcp_portmon 1 1024 Displays the remote host name of the first con‐
2548 rhost 0} nection on a privileged port
2549 ${tcp_portmon 1 1024 Displays the remote host port of the fifth con‐
2550 rport 4} nection on a privileged port
2551 ${tcp_portmon 1 65535 Displays the local service name of the fifteenth
2554 lservice 14} connection in the range of all ports
2555 Note that port monitor variables which share the same port range
2557 actually refer to the same monitor, so many references to a sin‐
2558 gle port range for different items and different indexes all use
2559 the same monitor internally. In other words, the program avoids
2560 creating redundant monitors.
2561 templateN (arg1) (arg2) (arg3 ...)
2563 Evaluate the content of the templateN configuration variable
2564 (where N is a value between 0 and 9, inclusively), applying sub‐
2565 stitutions as described in the documentation of the correspond‐
2566 ing configuration variable. The number of arguments is option‐
2567 al, but must match the highest referred index in the template.
2568 You can use the same special sequences in each argument as the
2569 ones valid for a template definition, e.g. to allow an argument
2570 to contain a whitespace. Also simple nesting of templates is
2571 possible this way.
2572 Here are some examples of template definitions, note they are
2574 placed between [[ ... ]] instead of ...:
2575 template0 = [[$12]]
2577 template1 = [[1: ${fs_used 2} / ${fs_size 2}]]
2578 template2 = [[1 2]]
2579 The following list shows sample usage of the templates defined
2581 above, with the equivalent syntax when not using any template at
2582 all:
2583 Using template Same without template
2585 ──────────────────────────────────────────────────────────────────────────
2586 ${template0 node name} $nodename
2587 ${template1 root /} root: ${fs_free /} / ${fs_size /}
2588 ${template1 ${template2 disk root} disk root: ${fs_free /} /
2589 /} ${fs_size /}
2590 ——————————————— ——————————————
2591 texeci interval command
2593 Runs a command at an interval inside a thread and displays the
2594 output. Same as $execi, except the command is run inside a
2595 thread. Use this if you have a slow script to keep Conky updat‐
2596 ing. You should make the interval slightly longer than the time
2597 it takes your script to execute. For example, if you have a
2598 script that take 5 seconds to execute, you should make the in‐
2599 terval at least 6 seconds. See also $execi. This object will
2600 clean up the thread when it is destroyed, so it can safely be
2601 used in a nested fashion, though it may not produce the desired
2602 behaviour if used this way.
2603 texecpi interval command
2605 Same as execpi, except the command is run inside a thread.
2606 threads
2608 Total threads.
2609 time (format)
2611 Local time, see “man strftime” to get more information about
2612 format.
2613 to_bytes size
2615 If `size' is a number followed by a size-unit (kilo‐
2616 byte,mb,GiB,...) then it converts the size to bytes and shows
2617 it without unit, otherwise it just shows `size'.
2618 top type num
2620 This takes arguments in the form:top (name) (number) Basically,
2621 processes are ranked from highest to lowest in terms of cpu us‐
2622 age, which is what (num) represents. The types are: “name”,
2623 “pid”, “cpu”, “mem”, “mem_res”, “mem_vsize”, “time”, “uid”, “us‐
2624 er”, “io_perc”, “io_read” and “io_write”. There can be a max of
2625 10 processes listed.
2626 top_io type num
2628 Same as top, except sorted by the amount of I/O the process has
2629 done during the update interval.
2630 top_mem type num
2632 Same as top, except sorted by mem usage instead of cpu.
2633 top_time type num
2635 Same as top, except sorted by total CPU time instead of current
2636 CPU usage.
2637 totaldown (net)
2639 Total download, overflows at 4 GB on Linux with 32-bit arch and
2640 there doesn’t seem to be a way to know how many times it has al‐
2641 ready done that before conky has started.
2642 totalup (net)
2644 Total upload, this one too, may overflow.
2645 trashed_mails (maildir) (interval)
2647 Number of mails marked as trashed in the specified mailbox or
2648 mail spool if not. Only maildir type mailboxes are supported,
2649 mbox type will return -1.
2650 tztime (timezone (format))
2652 Local time for specified timezone, see man strftime to get more
2653 information about format. The timezone argument is specified in
2654 similar fashion as TZ environment variable. For hints, look in
2655 /usr/share/zoneinfo. e.g. US/Pacific, Europe/Zurich, etc.
2656 uid_name uid
2658 Username of user with this uid.
2659 unflagged_mails (maildir) (interval)
2661 Number of mails not marked as flagged in the specified mailbox
2662 or mail spool if not. Only maildir type mailboxes are support‐
2663 ed, mbox type will return -1.
2664 unforwarded_mails (maildir) (interval)
2666 Number of mails not marked as forwarded in the specified mailbox
2667 or mail spool if not. Only maildir type mailboxes are support‐
2668 ed, mbox type will return -1.
2669 unreplied_mails (maildir) (interval)
2671 Number of mails not marked as replied in the specified mailbox
2672 or mail spool if not. Only maildir type mailboxes are support‐
2673 ed, mbox type will return -1.
2674 unseen_mails (maildir) (interval)
2676 Number of new or unseen mails in the specified mailbox or mail
2677 spool if not. Only maildir type mailboxes are supported, mbox
2678 type will return -1.
2679 updates Number of updates
2681 for debugging.
2682 uppercase text
2684 Converts all letters into uppercase.
2685 upspeed (net)
2687 Upload speed in suitable IEC units.
2688 upspeedf (net)
2690 Upload speed in KiB with one decimal.
2691 upspeedgraph (netdev) (height),(width) (gradient colour 1) (gradient
2693 colour 2) (scale) (-t) (-l)
2694 Upload speed graph, colours defined in hex, minus the #. If
2695 scale is non-zero, it becomes the scale for the graph. Uses a
2696 logarithmic scale (to see small numbers) when you use the -l
2697 switch. Takes the switch `-t' to use a temperature gradient,
2698 which makes the gradient values change depending on the ampli‐
2699 tude of a particular graph value (try it and see).
2700 uptime Uptime.
2702 uptime_short
2704 Uptime in a shorter format.
2705 user_names
2707 Lists the names of the users logged in.
2708 user_number
2710 Number of users logged in.
2711 user_terms
2713 Lists the consoles in use.
2714 user_time console
2716 Lists how long the user for the given console has been logged in
2717 for.
2718 user_times
2720 Lists how long users have been logged in for.
2721 utime (format)
2723 Display time in UTC (universal coordinate time).
2724 v6addrs (-n) (-s) (interface)
2726 IPv6 addresses for an interface, followed by netmask if -n is
2727 specified and scope with -s. Scopes are Global(G), Host-lo‐
2728 cal(H), Link-local(L), Site-local(S), Compat(C) and Unspeci‐
2729 fied(/). Linux only.
2730 version
2732 Git version number. DragonFly only.
2733 voffset (pixels)
2735 Change vertical offset by N pixels. Negative values will cause
2736 text to overlap. See also $offset.
2737 voltage_mv (n)
2739 Returns CPU #n’s voltage in mV. CPUs are counted from 1.
2740 Default: 1
2742 voltage_v (n)
2744 Returns CPU #n’s voltage in V. CPUs are counted from 1.
2745 Default: 1
2747 wireless_ap (net)
2749 Wireless access point MAC address. Linux only.
2750 wireless_bitrate (net)
2752 Wireless bitrate (ie 11 Mb/s). Linux only.
2753 wireless_channel (net)
2755 WLAN channel on which device `net' is listening.
2756 wireless_essid (net)
2758 Wireless access point ESSID. Linux only.
2759 wireless_freq (net)
2761 Frequency on which device `net' is listening.
2762 wireless_link_bar (height),(width) (net)
2764 Wireless link quality bar. Linux only.
2765 wireless_link_qual (net)
2767 Wireless link quality. Linux only.
2768 wireless_link_qual_max (net)
2770 Wireless link quality maximum value. Linux only.
2771 wireless_link_qual_perc (net)
2773 Wireless link quality in percents. Linux only.
2774 wireless_mode (net)
2776 Wireless mode (Managed/Ad-Hoc/Master). Linux only.
2777 words textfile
2779 Displays the number of words in the given file.
2780 xmms2_album
2782 Album in current XMMS2 song.
2783 xmms2_artist
2785 Artist in current XMMS2 song.
2786 xmms2_bar (height),(width)
2788 Bar of XMMS2’s progress.
2789 xmms2_bitrate
2791 Bitrate of current song.
2792 xmms2_comment
2794 Comment in current XMMS2 song.
2795 xmms2_date
2797 Returns song’s date.
2798 xmms2_duration
2800 Duration of current song.
2801 xmms2_elapsed
2803 Song’s elapsed time.
2804 xmms2_genre
2806 Genre in current XMMS2 song.
2807 xmms2_id
2809 XMMS2 id of current song.
2810 xmms2_percent
2812 Percent of song’s progress.
2813 xmms2_playlist
2815 Returns the XMMS2 playlist.
2816 xmms2_size
2818 Size of current song.
2819 xmms2_smart
2821 Prints the song name in either the form “artist - title” or file
2822 name, depending on whats available.
2823 xmms2_status
2825 XMMS2 status (Playing, Paused, Stopped, or Disconnected).
2826 xmms2_timesplayed
2828 Number of times a song was played (presumably).
2829 xmms2_title
2831 Title in current XMMS2 song.
2832 xmms2_tracknr
2834 Track number in current XMMS2 song.
2835 xmms2_url
2837 Full path to current song.
2838
2840 Conky features a Lua Programming API, and also ships with Lua bindings
2841 for some useful libraries. Note that the bindings require tolua++,
2842 which currently only compiles against Lua 5.1.
2843 To use Lua Conky, you first need to make sure you have a version of
2845 Conky with Lua support enabled (conky -v will report this). Conky de‐
2846 fines certain global functions and variables which can be accessed from
2847 Lua code running in Conky. Scripts must first be loaded using the
2848 lua_load configuration option. You then call functions in Lua via
2849 Conky’s $lua, $lua_read, and Lua hooks.
2850 Be careful when creating threaded objects through the Lua API. You
2852 could wind up with a whole bunch of threads running if a thread is cre‐
2853 ated with each iteration.
2854 NOTE: In order to accommodate certain features in the cairo library’s
2856 API, Conky will export a few additional functions for the creation of
2857 certain structures. These are documented below.
2858 cairo_font_extents_t:create()
2860 Call this function to return a new cairo_font_extents_t struc‐
2861 ture. A creation function for this structure is not provided by
2862 the cairo API.
2863 After calling this, you should use tolua.takeownership(cfe) on
2865 the return value to ensure ownership is passed properly.
2866 cairo_font_extents_t:destroy(structure)
2868 Call this function to free memory allocated by cairo_font_ex‐
2869 tents_t:create.
2870 You should call tolua.releaseownership(cfe) before calling this
2872 function to avoid double-frees, but only if you previously
2873 called tolua.takeownership(cfe)
2874 cairo_matrix_t:create()
2876 Call this function to return a new cairo_matrix_t structure. A
2877 creation function for this structure is not provided by the
2878 cairo API.
2879 After calling this, you should use tolua.takeownership(cm) on
2881 the return value to ensure ownership is passed properly.
2882 cairo_matrix_t:destroy(structure)
2884 Call this function to free memory allocated by cairo_ma‐
2885 trix_t:create.
2886 You should call tolua.releaseownership(cm) before calling this
2888 function to avoid double-frees, but only if you previously
2889 called tolua.takeownership(cm)
2890 cairo_text_extents_t:create()
2892 Call this function to return a new cairo_text_extents_t struc‐
2893 ture. A creation function for this structure is not provided by
2894 the cairo API.
2895 After calling this, you should use tolua.takeownership(cte) on
2897 the return value to ensure ownership is passed properly.
2898 cairo_text_extents_t:destroy(structure)
2900 Call this function to free memory allocated by cairo_text_ex‐
2901 tents_t:create.
2902 You should call tolua.releaseownership(cte) before calling this
2904 function to avoid double-frees, but only if you previously
2905 called tolua.takeownership(cte)
2906 conky_build_arch
2908 A string containing the build architecture for this particular
2909 instance of Conky.
2910 conky_build_date
2912 A string containing the build date for this particular instance
2913 of Conky.
2914 conky_build_info
2916 A string containing the build info for this particular instance
2917 of Conky, including the version, build date, and architecture.
2918 conky_config
2920 A string containing the path of the current Conky configuration
2921 file.
2922 conky_info
2924 This table contains some information about Conky’s internal da‐
2925 ta. The following table describes the values contained:
2926 Key Value
2928 ─────────────────────────────────────────────
2929 update_interval Conky’s update interval
2930 (in seconds).
2931 conky_parse(string)
2933 This function takes a string that is evaluated as per Conky’s
2934 TEXT section, and then returns a string with the result.
2935 conky_set_update_interval(number)
2937 Sets Conky’s update interval (in seconds) to `number'.
2938 conky_version
2940 A string containing the version of the current instance of
2941 Conky.
2942 conky_window
2944 This table contains some information about Conky’s window. The
2945 following table describes the values contained:
2946 Key Value
2948 ──────────────────────────────────────────────────────────────────────────
2949 drawable Window’s drawable (Xlib Drawable), requires Lua extras
2950 enabled at compile time.
2951 visual Window’s visual (Xlib Visual), requires Lua extras en‐
2952 abled at compile time.
2953 display Window’s display (Xlib Display), requires Lua extras en‐
2954 abled at compile time.
2955 width Window width (in pixels).
2956 height Window height (in pixels).
2957 border_in‐ Window’s inner border margin (in pixels).
2958 ner_margin
2959 border_out‐ Window’s outer border margin (in pixels).
2960 er_margin
2961 border_width Window’s border width (in pixels).
2962 text_start_x The x component of the starting coordinate of text draw‐
2963 ing.
2964 text_start_y The y component of the starting coordinate of text draw‐
2965 ing.
2966 text_width The width of the text drawing region.
2967 text_height The height of the text drawing region.
2968 NOTE: This table is only defined when X support is enabled.
2970 RsvgRectangle:create()
2972 Call this method to return a new RsvgRectangle structure. A
2973 creation function for this structure is not provided by the Rsvg
2974 API.
2975 After calling this, you should use tolua.takeownership(rect) on
2977 the return value to ensure ownership is passed properly.
2978 RsvgRectangle:destroy()
2980 Call this method to free memory allocated by RsvgRectangle:cre‐
2981 ate.
2982 You should call tolua.releaseownership(rect) before calling this
2984 function to avoid double-frees, but only if you previously
2985 called tolua.takeownership(rect)
2986 RsvgRectangle:set(x, y, width, height)
2988 Sets the values of an existing RsvgRectangle.
2989 RsvgRectangle:get()
2991 Gets the values of an existing RsvgRectangle.
2992 RsvgDimensionData:create()
2994 Call this method to return a new RsvgDimensionData structure. A
2995 creation function for this structure is not provided by the Rsvg
2996 API.
2997 After calling this, you should use tolua.takeownership(rect) on
2999 the return value to ensure ownership is passed properly.
3000 RsvgDimensionData:destroy()
3002 Call this method to free memory allocated by RsvgDimensionDa‐
3003 ta:create.
3004 You should call tolua.releaseownership(dd) before calling this
3006 function to avoid double-frees, but only if you previously
3007 called tolua.takeownership(dd)
3008 RsvgDimensionData:set(x, y, width, height)
3010 Sets the values of an existing RsvgDimensionData.
3011 RsvgDimensionData:get()
3013 Gets the values of an existing RsvgDimensionData.
3014
3016 conky -t '${time %D %H:%M}' -o -u 30
3017 Start Conky in its own window with date and clock as text and 30
3018 sec update interval.
3019 conky -a top_left -x 5 -y 500 -d
3021 Start Conky to background at coordinates (5, 500).
3022 conky -C > ~/.config/conky/conky.conf
3024 Do not start Conky, but have it output the builtin default con‐
3025 fig file to ~/.config/conky/conky.conf for later customising.
3026
3028 ${sysconfdir}/conky/conky.conf
3029 Default system-wide configuration file. The value of
3030 ${sysconfdir} depends on the compile-time options (most likely
3031 /etc).
3032 ~/.config/conky/conky.conf
3034 Default personal configuration file.
3035
3037 Drawing to root or some other desktop window directly doesn't work with
3038 all window managers. Especially doesn't work well with Gnome and it
3039 has been reported that it doesn't work with KDE either. Nautilus can
3040 be disabled from drawing to desktop with program gconf-editor. Uncheck
3041 show_desktop in /apps/nautilus/preferences/. There is -w switch in
3042 Conky to set some specific window id. You might find xwininfo -tree
3043 useful to find the window to draw to. You can also use -o argument
3044 which makes Conky to create its own window. If you do try running
3045 Conky in its own window, be sure to read up on the own_window_type set‐
3046 tings and experiment.
3047
3049 https://github.com/brndnmtthws/conky
3050
3052 Copyright (c) 2005-2023 Brenden Matthews, Philip Kovacs, et. al. Any
3053 original torsmo code is licensed under the BSD license (see LICENSE.BSD
3054 for a copy). All code written since the fork of torsmo is licensed un‐
3055 der the GPL (see LICENSE.GPL for a copy), except where noted different‐
3056 ly (such as in portmon and audacious code which are LGPL, and prss
3057 which is an MIT-style license).
3058
3060 The Conky dev team (see AUTHORS for a full list of contributors).
3061 2023-07-03 conky(1)