conky(1) General Commands Manual conky(1) (NAME) conky - X (SYNOPSIS) conky [ options ] (DESCRIPTION) Conky X torsmo . Conky . Conky (root desktop) . Conky . Conky ( : uname uptime "top" ) IMAP POP3 ( MPD XMMS2 Audacious) . Conky . (patches) . (GitHub) . Conky . (COMPILING) X ( X11 ). X11 "libx11-dev" "xorg-x11-dev" "-dev" ( ). `cmake' . `ccmake' `cmake-gui' . BUILD_MATH . Conky () . : Gentoo -- Conky (Portage) ... "emerge app-admin/conky" . -- Conky "aptitude install conky" . Conky ( ): cmake -D CMAKE_INSTALL_PREFIX:string=/usr . make make install # src/conky Conky C99 C C++0x C++ gcc . : `cmake' Conky `ccmake' `cmake-gui' . (YOU SHOULD KNOW) Conky . Conky . Conky ~/.config/conky/conky.conf: "killall -SIGUSR1 conky" . . (OPTIONS) . -a | --alignment= ALIGNMENT {top,bottom,middle}_{left,right,middle} none. tr top_right. BUILD_X11 . -b | --double-buffer (double buffering) ("flicker"). BUILD_X11 . -c | --config= FILE ~/.config/conky/conky.conf . -C | --print-config (stdout). EXAMPLES () . BUILD_BUILTIN_CONFIG . -d | --daemonize Conky ( ). -D | --debug -DD . -f | --font= FONT . BUILD_X11 . -h | --help . -i COUNT Conky ( ). -o | --own-window . BUILD_X11 . -p | --pause= SECONDS / ( ) Conky. -q | --quiet Conky << >> ('quiet mode' ). -t | --text= TEXT () -t ' $uptime '. -u | --interval= SECONDS ( ). -U | --unique Conky Conky . Linux FreeBSD NetBSD OpenBSD Haiku . -v | -V | --version . . -w | --window-id= WIN_ID (Window id) . BUILD_X11 . -x X_COORDINATE ( X). -X | --display= DISPLAY X11 . BUILD_X11 . -y Y_COORDINATE ( Y). (CONFIGURATION SETTINGS) Conky . conky.config conky.text . ~/.config/conky/conky.conf ${sysconfdir}/conky/conky.conf . $sysconfdir /etc /etc/conky/conky.conf . ~/.config/conky/conky.conf . : https://github.com/brndnmtthws/conky/wiki/Configs (optional). alignment . none : top_left ( tl) top_middle ( tm) top_right ( tr) middle_left ( middle_middle ( middle_right ( ml) mm) mr) bottom_left ( bottom_middle ( bottom_right ( bl) bm) br) panel dock : Alias Value ----------------------- top top_middle left middle_left right middle_right bottom bottom_middle center middle_middle gap_x gap_y . append_file . background (Boolean). true Conky (fork) . border_inner_margin ( ). border_outer_margin ( ). border_width . colorN conky.text. N 0 9 ( ) . (hex) # . console_bar_fill . : # console_bar_unfill . : . console_graph_ticks ( ) . ",_,=,#". cpu_avg_samples (CPU). default_bar_height . : 6 default_bar_width . 0 Conky . out_to_console = true 10 . default_color . default_gauge_height (gauges). : 25 default_gauge_width (gauges). : 40 default_graph_height . : 25 default_graph_width . 0 Conky . out_to_console = true . default_outline_color (outline) . default_shade_color . detect_battery update_interval_on_battery ( ). : BAT0 disable_auto_reload inotify . diskio_avg_samples / (I/O) . display X . double_buffer Xdbe ( ) (own window) . draw_blended (blend) ARGB . . : True draw_borders . draw_graph_borders . draw_outline (outlines). draw_shades . extra_newline wibox awesome . font X xfontsel . fontN conky.text . N 0 9 ( ) . font . forced_redraw true () Conky . . format_human_readable ( KiB MiB ). . gap_x ( ) -x gap_x 10. alignment . gap_y ( ) -y gap_y 10. alignment . github_token API (GitHub). API : https://github.com/settings/tokens/new?scopes=notifications&description=conky graph_gradient_mode (rgb|hcl|hsv) . hcl hsv rgb () . : rgb hddtemp_host hddtemp. : 127.0.0.1 hddtemp_port hddtemp. : 7634 http_port HTTP. 10080 Firefox Chrome . : 10080 http_refresh out_to_http . if_up_strictness if_up up () link address (up) (link) IP . : up imap host user pass [`-i interval (in seconds)'] ["-f `folder'"] [`-p port'] ["-e `command'"] [`-r retries'] IMAP. 143 `INBOX` 5 5 . '*' Conky . imlib_cache_flush_interval ( ) () Imlib2. imlib_cache_size () Imlib2 . $image . 0 . : 4194304 lowercase true . lua_draw_hook_post function_name [`function arguments'] Conky . (X11 Wayland) . . Conky . Conky `conky_` function_name `conky_` . conky_surface() . lua_draw_hook_pre function_name [`function arguments'] Conky . (X11 Wayland) . . Conky . Conky `conky_` function_name `conky_` . conky_surface() . lua_load Lua Lua . `lua_startup_hook` () ( ) (global scope) . `;` () . ' ' () `;` . `./example file.lua;` . lua_mouse_hook function_name X Wayland Conky . . . Conky `conky_` . lua_shutdown_hook function_name [`function arguments'] Conky . Lua . Conky `conky_` function_name `conky_` . lua_startup_hook function_name [`function arguments'] Conky . . Conky `conky_` function_name `conky_` . mail_spool (Mail spool) . max_port_monitor_connections . : 256 max_text_width integer_number `width` . `width` 0 . max_user_text integer_number conky.text . : 16384 maximum_width integer_number . minimum_height integer_number . minimum_width integer_number . mpd_host MPD. mpd_password MPD. mpd_port MPD. music_player_interval (thread) . : update interval mysql_db MySQL . : mysql mysql_host MySQL. : localhost mysql_password MySQL. " . . mysql_port MySQL. mysql_user MySQL . . net_avg_samples . no_buffers () . nvidia_display nvidia . : $DISPLAY out_to_console (stdout). out_to_http conky http . out_to_ncurses ncurses conky . ( ). out_to_stderr (stderr). out_to_wayland Wayland . out_to_x no X ( out_to_console ). no X ( ). : True override_utf8_locale UTF8. XFT . overwrite_file . own_window conky (root window). own_window_class WM_CLASS. : Conky own_window_colour color . ( '#fff' '#8000' '#8fff') RGB ( : /usr/lib/X11/rgb.txt). . '#0000' '#f000' . X11 . : black own_window_hints hint(,hint)* own_window X11 (hints) Conky . : o above conky . o below conky . o skip_pager conky (Pager) . own_window_type `dock` `panel` . o skip_taskbar conky (taskbar) . own_window_type `dock` `panel` . o sticky conky . o undecorated conky ( ) . own_window_type `dock` `panel` . : o own_window_type='desktop' . o own_window_type='override' . own_window_title conky . : conky () own_window_type (normal|desktop|dock|panel|utility|override) conky . X11 own_window Wayland wlr-layer-shell ( dock/panel ). : o normal conky . own_window_hints . o desktop . desktop normal conky . o dock . desktop desktop normal . Conky (struts) . o panel dock ( ) . conky . alignment . Wayland alignment (mm) ( tm bm ml mr). o utility ( ). ( ) normal . o override ( ) . conky . own_window_hints override . override override-redirect . ( 0) (pseudo-transparency) . conky own_window false . : normal pad_percents (0 = ). pop3 host user pass [`-i interval (in seconds)'] [`-p port'] ["-e `command'"] [`-r retries'] POP3. : host user pass [-i interval (in seconds)] [-p port] [-e 'command'] [-r retries]. 110 5 5 . '*' Conky . short_units ( kiB->k GiB->G ). show_graph_range . show_graph_scale . stippled_borders . temperature_unit . fahrenheit celsius . : celsius templateN conky.text. N 0 9 ( ) . conky.text : o \\n -> (newline) o \\ -> (backslash) o \\ -> (space) o \\N -> N ( 1) text_buffer_size integer_number . $exec . Conky . 256 . : 256 times_in_seconds true . $time $tztime $utime . top_cpu_separate true cpu top . false cpu top . top_name_verbose true top name ( ) . (basename) . : false top_name_width $top name . : 15 total_run_times Conky . Conky . units_spacer . : '' ( ) update_interval seconds . update_interval_on_battery seconds . uppercase true . use_spacer . none () left right . true/false right/none . ( Bitstream Vera Sans Mono) . : none use_xft Xft ( anti-aliased ). xftalpha Xft. 0 1 . xinerama_head (head) Xinerama. (OBJECTS/VARIABLES) Conky conky.text . . . XParseColor() . /usr/share/X11/rgb.txt . #rrggbb . (threads) Conky . Conky . MPD MPD Conky . key () ( $curl $rss URI ). (optional). acpiacadapter (adapter) (AC) ACPI. adapter /sys/class/power_supply . AC ADP1 . . acpifan ACPI. acpitemp ACPI (). addr (interface) IP "No Address" . addrs (interface) IP ( addr ). . adt746xcpu (CPU) therm_adt746x. adt746xfan therm_adt746x. alignc (num) (). alignr (num) N. apcupsd host port apcupsd. . : localhost:3551 apcupsd_cable UPS . apcupsd_charge . apcupsd_lastxfer . apcupsd_linev . apcupsd_load . apcupsd_loadbar . apcupsd_loadgauge (height),(width) () . apcupsd_loadgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value) . apcupsd_model UPS . apcupsd_name UPS . apcupsd_status (on-line on-battery). apcupsd_temp . apcupsd_timeleft . apcupsd_upsmode UPS ( standalone). apm_adapter APM. FreeBSD OpenBSD. apm_battery_life APM. FreeBSD OpenBSD. apm_battery_time APM hh:mm:ss "unknown" (online) . FreeBSD OpenBSD. audacious_bar (height),(width) . audacious_bitrate ( ) . audacious_channels . audacious_filename . audacious_frequency . audacious_length MM:SS. audacious_length_seconds . audacious_main_volume Audacious. audacious_playlist_length (playlist). audacious_playlist_position . audacious_position (MM:SS). audacious_position_seconds . audacious_status (Playing/Paused/Stopped/Not running). audacious_title (max length) . battery (num) ACPI APM. ACPI . : BAT0 battery_bar (height),(width) (num) ACPI . ACPI ( all ). : BAT0 battery_percent (num) ACPI. ACPI ( all ). : BAT0 battery_power_draw (num) . : BAT0 battery_short (num) ACPI APM. ACPI . : C (charging) D (discharging) F (full) N (not present) E (empty) U (unknown). : BAT0 battery_status (num) ACPI. ACPI . : BAT0 battery_time (num) ACPI. ACPI . : BAT0 blink text_and_other_conky_vars ( `text_and_other_conky_vars`). buffers (buffered). cached (cached). cat file Conky . Conky . catp file Conky . Conky . $cat (parse) ${color red}hi!${color} Conky . cmdline_to_pid string (PID) . cmus_aaa aaa cmus ( all/artist/album). cmus_album cmus . cmus_artist cmus . cmus_curtime cmus. cmus_date cmus . cmus_file cmus . cmus_genre () cmus . cmus_percent . cmus_progress (height),(width) cmus. cmus_random (Random) cmus (/ - on/off). cmus_repeat (Repeat) cmus ( song/all/off). cmus_state cmus ( playing paused stopped ). cmus_timeleft cmus. cmus_title cmus . cmus_totaltime cmus. cmus_track () cmus . color (color) color # #0A1B2C. ncurses : red green yellow blue magenta cyan black white. colorN colorN N 0 9 ( ) . combine var1 var2 var2 var1 var1 var2 . : ${combine ${head /proc/cpuinfo 2} - ${head /proc/meminfo 1}} cpuinfo_line1 - meminfo_line1 cpuinfo_line2 - . $combine . conky_build_arch (CPU) Conky . conky_version Conky. cpu (cpuN) (CPU) . (SMP) CPU . ${cpu cpu0} ${cpu cpuX} ( X >= 1) / . cpubar (cpuN) (height),(width) height . SMP $cpu . cpugauge (cpuN) (height),(width) () height width . SMP $cpu . cpugovernor (cpuN) (CPU scaling governor) . SMP $cpu . . cpugraph (cpuN) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value) ( #). SMP $cpu . -l ( ) . `-t' ( ). `-x' x `-y' y . `-m' / ( ). curl url (interval_in_minutes) URI Curl . (0 ) 15 . Lua API Lua . (threaded) . URI . Curl . desktop () Conky "Not running in X" X . desktop_name Conky "Not running in X" X . desktop_number "Not running in X" X . disk_protect device ( ). "frozen" "free" ( ). diskio (device) / (IO) . device /dev/sda sda . label:foo (partuuid) partuuid:40000000-01 . diskio_read (device) / (IO) . device diskio . diskio_write (device) / (IO) . device diskio . diskiograph (device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value) / ( #) . scale . -l ( ) . `-t' ( ). `-x' x `-y' y . `-m' / ( ). diskiograph_read (device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value) / (IO) # . 1. (scale) . (Device) diskio . -l ( ) . `-t' ( ). `-x' x `-y' y . `-m' / ( ). diskiograph_write (device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value) / (IO) # . 1. (scale) . (Device) diskio . -l ( ) . `-t' ( ). `-x' x `-y' y . `-m' / ( ). distribution . NAME /etc/os-release /proc/version . (issue) . downspeed (net) IEC. downspeedf (net) KiB . downspeedgraph (netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m) # . (scale) ( ) . -l ( ) . `-t' ( ). `-x' x `-y' y . `-m' / ( ). draft_mails (maildir) (interval) (draft) (mail spool). maildir mbox -1 . else . endif $if. entropy_avail . entropy_bar (height),(width) . entropy_perc (poolsize). entropy_poolsize . eval string conky.text `$'intoasingle^'^' . . exec command conky . : . C/C++ (patch) . execbar (height),(width) command exec 0-100 . (height) (width) default_bar_height default_bar_width . execgauge (height),(width) command exec 0-100 ( ) . default_gauge_height default_gauge_width . execgraph command (height),(width) (gradient color 1) (gradient color 2) (scale) (-t) (-l) (-x) (-y) (-m value) 0-100 . . 0x # . -t 1 <<>> ("cold") 2 <<>> ("hot") . -t . (scale) . -l . default_graph_height default_graph_width . `-x' x `-y' y . `-m' / ( ). : 1. (double-quotes) 2. ~/bin/myscript.sh execgraph . ! execgraph (0-59) 50 200 (FF0000) (FFFF00) . 60 . ${execgraph ~/seconds.sh 50,200 FF0000 FFFF00 60 -t} execi interval command exec . update_interval . $texeci . execibar interval (height),(width) command execbar . execigauge interval (height),(width) command execgauge . execigraph interval command (height),(width) (gradient color 1) (gradient color 2) (scale) (-t) (-l) (-x) (-y) (-m value) execgraph . execp command conky . : . C/C++ . $exec `${color red}hi!${color}` Conky . : Conky $execp Conky . $execi $execp $execp . execpi interval command execp . $execpi . flagged_mails (maildir) (interval) (flagged) (mail spool). maildir mbox -1 . font (font) . . $font ( $color). fontN fontN N 0 9 ( ) . format_time seconds format . times_in_seconds . " . ,,,(,) \ ( ) . . ()- 0 . ( 9) . `x' 's ( 9). forwarded_mails (maildir) (interval) (mail spool). maildir mbox -1 . free_bufcache free. . free_cached free. . freq (n) n . 1 . : 1 freq2 (n) n . 1 . : 1 freq_g (n) n . 1 . : 1 fs_bar (height),(width) fs . height . fs . fs_bar_free (height),(width) fs . height . fs . fs_free (fs) . fs_free_perc (fs) . fs_size (fs) . fs_type (fs) . fs_used (fs) . fs_used_perc (fs) . gid_name gid gid. github_notifications (GitHub). goto x `x' . gw_iface "multiple"/"none" . gw_ip IP "multiple"/"none" . hddtemp (dev) hddtemp . hddtemp_host hddtemp_port hddtemp . dev hddtemp . head logfile lines (next_check) N . `next_check' . next_check Conky 2 . 30 . hr (height) (width) height . width . hwmon (dev) type n (factor offset) Hwmon sysfs ( 2.6). dev : 1. . 1 hwmon1 . 2. . k10temp hwmon k10temp . 3. . hwmon (hwmon0) . type in vol fan temp . n . /sys/class/hwmon/ . factor offset : input = input * factor + offset. ( ). hwmonbar (height),(width) (dev) type n (factor offset) hwmon . factor offset hwmon 0-100 . . default_bar_height default_bar_width . i2c (dev) type n (factor offset) I2C sysfs ( 2.6). I2C dev . type in vol fan temp . n . /sys/bus/i2c/devices/ . factor offset : input = input * factor + offset. ( ). i2cbar (height),(width) (dev) type n (factor offset) i2c . factor offset i2c 0-100 . . default_bar_height default_bar_width . i8k_ac_status i8k Inspiron (AC) /proc/i8k ( ) . i8k . i8k_bios i8k Inspiron (BIOS) /proc/i8k . i8k_buttons_status i8k Inspiron /proc/i8k . i8k_cpu_temp i8k Inspiron /proc/i8k . i8k_left_fan_rpm i8k Inspiron (RPM) /proc/i8k . i8k . i8k_left_fan_status i8k Inspiron /proc/i8k ( ) . i8k . i8k_right_fan_rpm i8k Inspiron (RPM) /proc/i8k . i8k . i8k_right_fan_status i8k Inspiron /proc/i8k ( ) . i8k . i8k_serial i8k Inspiron /proc/i8k . i8k_version i8k Inspiron /proc/i8k . ibm_brightness IBM ACPI LCD (0-7). ibm_fan IBM ACPI . ibm_temps N IBM ACPI IBM (N=0..7). 0 CPU 3 GPU . ibm_thinklight IBM ACPI ThinkLighttm . `on' `off' `unknown' . ibm_volume IBM ACPI ("master") (0-14). ical number file `number' ical (RFC 5545) `file' . . VEVENT SUMMARY DTSTART . iconv_start codeset_from codeset_to GNU iconv. iconv_stop . iconv_stop (codeset) iconv. if_empty (var) VAR $if_empty $endif . if_existing file (string) FILE if_existing $endif . FILE $if_existing $endif . if_gw (default gateway) $if_gw $endif . if_match expression (true) $if_match $endif . . . : o double: . o long: . o string: (") . : o < > o <= >= o == != if_mixer_mute (mixer) [ ] $if_mixer_mute $endif . "Vol" . if_mounted (mountpoint) MOUNTPOINT () $if_mounted $endif . if_mpd_playing mpd $if_mpd_playing $endif . if_pa_sink_muted PulseAudio (muted) $if_pa_sink_muted $else $endif . if_pa_source_muted PulseAudio ( ) $if_pa_source_muted $else $endif . if_pa_source_running PulseAudio ( ) $if_pa_source_running $else $endif . if_running (process) PROCESS $if_running $else $endif . PROCESS ( ) . /usr/bin/conky -u 5, : o ${if_running conky -u 5} o ${if_running conky} . ${if_running conky } . if_smapi_bat_installed (INDEX) smapi INDEX $if_smapi_bat_installed $endif . if_up (interface) INTERFACE (up) $if_up $endif . if_updatenr (updatenr) UPDATENR- $if_updatenr $endif . UPDATENR . : {$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr 4}$endif foo bar . if_xmms2_connected xmms2 $if_xmms2_connected $endif . iface (number) ${iface 1}. image (-p x,y) (-s WxH) (-n) (-f interval) Imlib2 . : (no-cache) . x,y WxH . (-n) . -f int . : ${image /home/brenden/cheeseburger.jpg -p 20,20 -s 200x200} `cheeseburger.jpg' (20,20) x . ( ) . $image conky.text $execp $lua_parse . imap_messages (args) IMAP . IMAP . : "host user pass [-i interval (in seconds)] [-f `folder'] [-p port] [-e `command'] [-r retries]". `INBOX' . '*' . imap_unseen (args) IMAP . IMAP . : "host user pass [-i interval (in seconds)] [-f `folder'] [-p port] [-e `command'] [-r retries]". `INBOX' . '*' . intel_backlight (Intel backlight) . ioscheduler disk / (ioscheduler) ( "hda" "sdb") . irc server(:port) #channel (max_msg_lines) #channel IRC `server' . `port' TCP . `max_msg_lines' . journal (lines) (type) N systemd . N . . . type : `system' `user' `runtime' `local' ( type). . kernel (). key_caps_lock (Caps Lock). key_num_lock (Num Lock). key_scroll_lock (Scroll Lock). keyboard_layout . laptop_mode /proc/sys/vm/laptop_mode. legacymem free. lines textfile . loadavg (1|2|3) . . loadgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value) (Load1) xload #. -l ( ) . `-t' ( ). `-x' x `-y' y . `-m' / ( ). lowercase text . lua function_name (function parameters) Lua . `lua_load' . `conky_' function_name `conky_' . lua_bar (height,width) function_name (function parameters) Lua . . `lua_load' . `conky_' function_name `conky_' . lua_gauge (height,width) function_name (function parameters) Lua (gauge) . . `lua_load' . `conky_' function_name `conky_' . lua_graph function_name (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value) Lua . . `lua_load' . `-t' ( ). `conky_' function_name `conky_' . `-x' x `-y' y . `-m' / ( ). lua_parse function_name (function parameters) Lua $lua () conky.text . `lua_load' . `conky_' function_name `conky_' . machine i686 x86_64. mails (mailbox) (interval) (mail spool) . mbox maildir . fetchmail . new_mails . mboxscan (-n number of messages to print) (-fw from width) (-sw subject width) mbox mbox . mbox ( '"' ${mboxscan -n 10"/home/brenden/some box"} mem . memactive (active). FreeBSD. memavail /proc/meminfo . . . membar (height),(width) . memdirty ("dirty"). . memeasyfree (/). memfree . memgauge (height),(width) (cpugauge ). memgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value) . -l ( ) . `-t' ( ). `-x' x `-y' y . `-m' / ( ). meminactive (inactive). FreeBSD. memlaundry laundry. FreeBSD. memmax . memperc . memwired (wired). FreeBSD. memwithbuffers . memwithbuffersbar (height),(width) ( ). memwithbuffersgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value) . -l ( ) . `-t' ( ). `-x' x `-y' y . `-m' / ( ). mixer (device) . OSS . "Vol" OSS : "Vol" "Bass" "Trebl" "Synth" "Pcm" "Spkr" "Line" "Mic" "CD" "Mix" "Pcm2" "Rec" "IGain" "OGain" "Line1" "Line2" "Line3" "Digital1" "Digital2" "Digital3" "PhoneIn" "PhoneOut" "Video" "Radio" "Monitor". : Vol mixerbar (device) . $mixer . mixerl (device) . $mixer . mixerlbar (device) . $mixer . mixerr (device) . $mixer . mixerrbar (device) . $mixer . moc_album MOC. moc_artist () MOC. moc_bar (height),(width) MOC. moc_bitrate (bitrate) MOC. moc_avgbitrate MOC. moc_curtime MOC. moc_cursec MOC . moc_file MOC. moc_percent MOC. moc_rate MOC. moc_song MOC. moc_state MOC (playing) (stopped) . moc_timeleft MOC. moc_title MOC. moc_totaltime MOC. moc_totalsec MOC . monitor conky "Not running in X" . monitor_number "Not running in X" . mouse_speed . mpd_album MPD. mpd_albumartist MPD. mpd_artist MPD . mpd_bar (height),(width) MPD. mpd_bitrate () . mpd_comment (max-length) () MPD. mpd_date . mpd_elapsed . mpd_file MPD . mpd_length . mpd_name MPD . mpd_percent . mpd_random (/ - On/Off). mpd_repeat (/ - On/Off). mpd_smart (max length) "artist - title" . mpd_status . mpd_title (max length) MPD. mpd_track ( ) MPD . mpd_vol MPD. mysql query . nameserver (index) (nameserver) /etc/resolv.conf . new_mails (mailbox) (interval) mail spool. mbox maildir . no_update text . conky $machine $conky_version ... . nodename (Hostname). nodename_short ( `hostname -s'). nvidia argument (GPU_ID) Nvidia XNVCtrl NVML. (float) . GPU_ID: GPU 0,1,2,3,.. 0 : XNVCtrl NVML ------------------------------------------------------------------------------------------------------- gputemp temp (GPU) gputempthreshold threshold () ambienttemp ambient gpufreqcur gpufreq () GPU gpufreqmin GPU gpufreqmax GPU memfreqcur memfreq memfreqmin memfreqmax mtrfreqcur mtrfreq mtrfreqmin mtrfreqmax perflevelcur perflevel () perflevelmin perflevelmax perfmode (Performance mode) gpuutil (GPU) membwutil videoutil pcieutil PCIe memused mem memfree memavail memmax memtotal memutil memperc fanspeed fanlevel imagequality modelname driverversion arch (GPU) powerlimit powerinstant poweravg nvidiabar (height),(width) argument (GPU_ID) nvidia . default_bar_height default_bar_width . GPU_ID: (GPU) 0,1,2,3,.. 0 . : o gputempthreshold (threshold) o gpufreqmin o gpufreqmax o memfreqmin o memfreqmax o mtrfreqmin o mtrfreqmax o perflevelmin o perflevelmax o perfmode o memtotal (memmax) o fanspeed o powerlimit nvidiagauge (height),(width) argument (GPU_ID) nvidiabar ( ) . default_gauge_height default_gauge_width . GPU_ID: (GPU) 0,1,2,3,.. 0 . nvidia nvidiabar . nvidiagraph argument (height),(width) (gradient color 1) (gradient color 2) (scale) (-t) (-l) (-x) (-y) (-m) GPU_ID nvidiabar 0-100 . default_graph_height default_graph_width . GPU_ID: . 0,1,2,3,.. . nvidia nvidiabar . -t -l -x -y execgraph . offset (pixels) N . $voffset . outlinecolor (color) (outline). pa_card_active_profile PulseAudio. pa_card_name PulseAudio. pa_sink_active_port_description (sink) PulseAudio. pa_sink_active_port_name (sink) PulseAudio. pa_sink_description (sink) PulseAudio. pa_sink_volume (sink) PulseAudio. pa_sink_volumebar (sink) PulseAudio. password (length) . pb_battery item Apple powerbook/ibook . item . . : (Item) ---------------------------------------------------------------------------- status () ( AC). percent . . time . . pid_chroot pid ( "/" chroot ). pid_cmdline pid . pid_cwd pid . pid_egid pid (effective gid) . pid_environ pid varname . pid_environ_list pid . pid_euid pid (effective uid) . pid_exe pid . pid_fsgid pid (file system gid) . pid_fsuid pid (file system uid) . pid_gid pid (real gid) . pid_nice pid (nice) . pid_openfiles pid . pid_parent pid (parent pid) . pid_priority pid (`priority' "man 5 proc" ). pid_read pid . pid_sgid pid (saved set gid) . pid_state pid . pid_state_short pid "RSDZTW" R S D Z T ( ) W . pid_stderr pid STDERR . pid_stdin pid STDIN . pid_stdout pid STDOUT . pid_suid pid (saved set uid) . pid_thread_list pid (PID) . pid_threads pid . pid_time pid $pid_time_kernelmode $pid_time_usermode. pid_time_kernelmode pid (kernel mode) . pid_time_usermode pid (user mode) . pid_uid pid (real uid) . pid_vmdata pid (data segment) . pid_vmexe pid (text segment) . pid_vmhwm pid ("high water mark") . pid_vmlck pid . pid_vmlib pid . pid_vmpeak pid . pid_vmpte pid (PTE) . pid_vmrss pid (RSS) . pid_vmsize pid . pid_vmstk pid (stack segment) . pid_write pid . platform (dev) type n (factor offset) sysfs ( 2.6). dev . (Platform type) in vol fan temp . n . /sys/bus/platform/devices/ . factor offset : input = input * factor + offset. ( ). platformbar (height),(width) (dev) type n (factor offset) platform . factor offset platform 0-100 . . default_bar_height default_bar_width . pop3_unseen (args) POP3 . POP3 . : "host user pass [-i interval (in seconds)] [-p port] [-e `command'] [-r retries]". 110 5 5 . '*' Conky . pop3_used (args) ( 2^20) POP3 . POP3 . : "host user pass [-i interval (in seconds)] [-p port] [-e `command'] [-r retries]". 110 5 5 . '*' Conky . processes ( ). read_tcp (host) port () tcp ( localhost ) . read_udp (host) port () udp ( localhost ) . replied_mails (maildir) (interval) mail spool. maildir mbox -1 . rss uri interval_in_seconds action (num_par (spaces_in_front)) RSS. (interval) ( ) 0 . (action) : feed_title item_title ( num par) item_desc ( num par) item_titles ( spaces_in_front ). (threaded) . URI . Curl . rstrip text . running_processes ( ). 2.6 . running_threads ( - runnable). . scroll (direction) length (step) (interval) text `text' `step' ( `direction' `left' `right' `wait') `length' . . `step' 1 . `direction' left . direction `wait' `interval' . `|' . (textcolor) $scroll $scroll . `length' direction `wait' . seen_mails (maildir) (interval) mail spool. maildir mbox -1 . shadecolor (color) (shading color). shmem . . sip_status (switch) (System Integrity Protection SIP) macOS . SIP ( / ) SIP . : SWITCH RESULT STATUS --------------------------------------- 0 apple internal YES/NO 1 forbid untrusted YES/NO kexts 2 forbid task-for-pid YES/NO 3 restrict filesystem YES/NO 4 forbid YES/NO kernel-debugger 5 restrict dtrace YES/NO 6 restrict nvram YES/NO 7 forbid YES/NO device-configuration 8 forbid YES/NO any-recovery-os 9 forbid YES/NO user-approved-kexts : "unsupported configuration, beware!" "configuration is ok" . (USAGE): $ conky -t '${sip_status}' # SIP $ conky -t '${sip_status 0}' # apple-internal Yes No (NOTES): o macOS ( El Capitan SIP ) o El Capitan SIP "unsupported" . smapi (ARGS) smapi /sys/devices/platform/smapi . ARGS (FILENAME) bat (INDEX) (FILENAME) . smapi . smapi_* . smapi_bat_bar (INDEX),(height),(width) smapi INDEX . smapi_bat_perc (INDEX) smapi INDEX . `use_spacer' . smapi_bat_power INDEX smapi INDEX . mW . () () . smapi_bat_temp INDEX smapi INDEX . . sony_fanspeed sony-laptop Sony VAIO . . startcase text . stippled_hr (space) (height) (width) (). stock symbol data . : --------------------------------------------- 1ytp 200ma 50ma 52weekhigh 52weeklow 52weekrange adv ag ahcrt ask askrt (Ask) asksize bid bidrt (Bid) bidsize bookvalue c200ma c50ma c52whigh c52wlow change changert cip commission cprt dayshigh dayslow dpd dr drrt ds dvc dvcrt dy ebitda edv (Ex-Dividend) ei epsecy EPS epsenq EPS epseny EPS es (EPS) floatshares hg hgp hgprt hgrt hl hv hvrt ll ltd ltp lts ltt mc (Market Capitalization) mcrt moreinfo name notes obrt open pb (P/B) pc pc200ma pc50ma pc52whigh pc52wlow pegr PEG pepsecy EPS pepseny EPS per P/E perrt P/E pricepaid ps (P/S) se sharesowned shortratio symbol tradedate tradelinks tt (Ticker Trend) volume swap (swap) . swapbar (height),(width) . swapfree . swapmax . swapperc . sysctlbyname (name) sysctl . FreeBSD. sysname Linux. tab (width, (start)) `start` . . tail logfile lines (next_check) N . `next_check` . next_check Conky . . tcp_ping host (port) tcp `host` . `port` . `down` . . tcp_portmon port_begin port_end item (index) TCP ( IPv6 IPv4) . . : ----------------------------------------- count rip IP rhost rport rservice /etc/services lip IP lhost lport lservice /etc/services . n-1 . n-1 . count ( ). . : -------------------------------------------------------------------------- ${tcp_portmon 6881 6999 count} bittorrent ${tcp_portmon 22 22 IP rip 0} sshd ${tcp_portmon 22 22 IP rip 9} sshd ${tcp_portmon 1 1024 rhost 0} / (privileged) ${tcp_portmon 1 1024 rport 4} / ${tcp_portmon 1 65535 lservice 14} . . templateN (arg1) (arg2) (arg3 ...) templateN ( N ) . . . . ... [[ ... ]] : template0 = [[$12]] template1 = [[1: ${fs_used 2} / ${fs_size 2}]] template2 = [[1 2]] : -------------------------------------------------------------------------- ${template0 node name} $nodename ${template1 root /} root: ${fs_free /} / ${fs_size /} ${template1 ${template2 disk root} disk root: ${fs_free /} / /} ${fs_size /} ------------------------------ ---------------------------- texeci interval command . $execi . Conky . . . $execi . . texecpi interval command execpi . threads . time (format) "man strftime" . to_bytes size `size` (kilobyte mb GiB ...) `size` . top type num top (name) (number) . CPU (num) . (type) : "name" "pid" "cpu" "mem" "mem_res" "mem_vsize" "time" "uid" "user" "io_perc" "io_read" "io_write". . top_io type num top / (I/O) . top_mem type num top cpu . top_time type num top CPU CPU . totaldown (net) () conky . totalup (net) () . trashed_mails (maildir) (interval) (trashed) mail spool. maildir mbox -1 . tztime (timezone (format)) man strftime . TZ . /usr/share/zoneinfo . US/Pacific Europe/Zurich . uid_name uid uid. unflagged_mails (maildir) (interval) (flagged) mail spool . maildir mbox -1 . unforwarded_mails (maildir) (interval) (forwarded) mail spool . maildir mbox -1 . unreplied_mails (maildir) (interval) (replied) mail spool . maildir mbox -1 . unseen_mails (maildir) (interval) mail spool. maildir mbox -1 . updates Number of updates . uppercase text . upspeed (net) () IEC. upspeedf (net) KiB . upspeedgraph (netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m) # . (scale) ( ) . `-l` ( ) . `-t` ( ). `-x` x `-y` y . `-m` / ( ). uptime (Uptime). uptime_short . user_names . user_number . user_terms . user_time console . user_times . utime (format) (UTC). v6addrs (-n) (-s) (interface) IPv6 -n netmask -s (scope) . Global(G) Host-local(H) Link-local(L) Site-local(S) Compat(C) Unspecified(/). . version . DragonFly. voffset (pixels) N . . $offset . voltage_mv (n) n (mV) . . : 1 voltage_v (n) n (V) . . : 1 wireless_ap (net) MAC (Access Point). . wireless_bitrate (net) ( 11 Mb/s). . wireless_channel (net) WLAN `net` . wireless_essid (net) ESSID . . wireless_freq (net) `net` . wireless_link_bar (net) (height),(width) . . wireless_link_qual (net) . . wireless_link_qual_max (net) . . wireless_link_qual_perc (net) . . wireless_mode (net) (Managed/Ad-Hoc/Master). . words textfile . xmms2_album XMMS2. xmms2_artist XMMS2. xmms2_bar (height),(width) XMMS2. xmms2_bitrate (Bitrate) . xmms2_comment () XMMS2. xmms2_date . xmms2_duration . xmms2_elapsed . xmms2_genre () XMMS2. xmms2_id XMMS2 . xmms2_percent . xmms2_playlist (Playlist) XMMS2 . xmms2_size . xmms2_smart "artist - title" . xmms2_status XMMS2 ( Playing Paused Stopped Disconnected). xmms2_timesplayed (). xmms2_title XMMS2. xmms2_tracknr (Track) XMMS2. xmms2_url . (LUA API) (API) . tolua++ . ( conky -v ). . lua_load . $lua $lua_read . (threaded) . . : Cairo (export) . . RsvgDimensionData:create() RsvgDimensionData . Rsvg . tolua.takeownership(rect) . RsvgDimensionData:destroy() RsvgDimensionData:create . (double-free) tolua.releaseownership(dd) tolua.takeownership(dd) . RsvgDimensionData:get() RsvgDimensionData . RsvgDimensionData:set(x, y, width, height) RsvgDimensionData . RsvgRectangle:create() RsvgRectangle . Rsvg . tolua.takeownership(rect) . RsvgRectangle:destroy() RsvgRectangle:create . (double-free) tolua.releaseownership(rect) tolua.takeownership(rect) . RsvgRectangle:get() RsvgRectangle . RsvgRectangle:set(x, y, width, height) RsvgRectangle . cairo_font_extents_t:create() cairo_font_extents_t . cairo . tolua.takeownership(cfe) . cairo_font_extents_t:destroy(structure) cairo_font_extents_t:create . (double-free) tolua.releaseownership(cfe) tolua.takeownership(cfe) . cairo_matrix_t:create() cairo_matrix_t . cairo . tolua.takeownership(cm) . cairo_matrix_t:destroy(structure) cairo_matrix_t:create . (double-free) tolua.releaseownership(cm) tolua.takeownership(cm) . cairo_place_image(file, cr, x, y, width, height, alpha) imlib2 cairo_t . cairo_t . --------------------------------------------------------------------------------- file . cr cairo_t . x,y . width, height . alpha 1.0 0.0 . require(`cairo_imlib2_helper') . cairo_text_extents_t:create() cairo_text_extents_t . cairo . tolua.takeownership(cte) . cairo_text_extents_t:destroy(structure) cairo_text_extents_t:create . (double-free) tolua.releaseownership(cte) tolua.takeownership(cte) . conky_build_arch . conky_build_info . conky_config . conky_info . : ---------------------------------------------------- update_interval ( ). conky_parse(string) TEXT . conky_set_update_interval(number) ( ) `number' . conky_surface() cairo_surface_t nil . Cairo . . () conky_surface() . : require('cairo') function conky_draw() local surface = conky_surface() if not surface then return end local cr = cairo_create(surface) -- draw ... cairo_destroy(cr) end conky_version . conky_window . : ------------------------------------------------------------------------------- drawable . (Xlib Drawable). conky_surface() . visual . (Xlib Visual). conky_surface() . display . (Xlib Display). conky_surface() . width (pt ). height (pt ). pixel_size.x (px ). pixel_size.y (px ). scale (dpi pixel_size size). border_inner_margin ( ). border_outer_margin ( ). border_width ( ). text_start_x x . text_start_y y . text_width . text_height . : (GUI) . drawable visual display X11 . ret_scale_x,ret_scale_y:cairo_draw_image(file, cs, x, y, scale_x, scale_y) imlib2 cairo_surface_t . . --------------------------------------------------------------------------------- file . cs cairo_surface_t . x,y . scale_x, scale_y 1.0 2.0 0.5 . : (1.0,1.0) require(`cairo_imlib2_helper') . cairo_text_hp_show(cr, x, y, text, font, font_size, alignment, language, script, direction) HarfBuzz FreeType cairo_t . Cairo . --------------------------------------------------------------------------------- cr cairo_t . x,y . text . font () Fontconfig . font_size (). alignment CAIRO_TEXT_ALIGN_LEFT CAIRO_TEXT_ALIGN_RIGHT CAIRO_TEXT_ALIGN_CENTER. : CAIRO_TEXT_ALIGN_LEFT language BCP 47. : en script ISO 15924. : direction LTR RTL TTB. : LTR width,height:cairo_text_hp_text_size(text, font, font_size, language, script, direction) cairo_text_hp_show width height . --------------------------------------------------------------------------------- cr cairo_t . text . font () Fontconfig . font_size (). language BCP 47. : en script ISO 15924. : direction LTR RTL TTB. : LTR cairo_text_hp_delete_fonts() cairo_text_hp_show cairo_text_hp_text_size ( ) . (EXAMPLES) conky -t '${time %D %H:%M}' -o -u 30 Conky . conky -a top_left -x 5 -y 500 -d Conky (5, 500). conky -C > ~/.config/conky/conky.conf Conky ~/.config/conky/conky.conf . (FILES) ${sysconfdir}/conky/conky.conf . ${sysconfdir} ( /etc). ~/.config/conky/conky.conf . (BUGS) (root) . Gnome KDE . Nautilus gconf-editor . show_desktop /apps/nautilus/preferences/ . Conky -w . xwininfo -tree . -o Conky . Conky own_window_type . (SEE ALSO) https://github.com/brndnmtthws/conky (COPYING) (c) 2005-2026 Brenden Matthews Philip Kovacs . torsmo BSD ( LICENSE.BSD ). (fork) torsmo GPL ( LICENSE.GPL ) ( portmon audacious LGPL prss MIT ). (AUTHORS) Conky ( AUTHORS ). 2026-09-04 conky(1)