Установка

Для установки необходимо поставить одноимённый пакет через Synaptic или командой

sudo apt-get install conky

Запуск

В диалоге запуска программ или в терминале выполните команду:

conky

Если вы хотите, чтобы в Ubuntu автоматически запускать conky при загрузке системы, то просто добавьте вызов conky в «Система - Параметры - Запускаемые приложения».

Настройка

В сети полно готовых конфигурационных файлов для conky, так что можно взять любой приглянувшийся и скопировать с именем .conkyrc в домашнюю папку. Либо можно взять настройки по-умолчанию, выполнив команду:

cat /etc/conky/conky.conf > ~/.conkyrc

Теперь открываем конфигурацонный файл в любом текстовом редакторе (например gedit) и начинаем его изучать:

gedit ~/.conkyrc

Файл конфигурации делится на две части:

  • первая часть отвечает за внешний вид системного монитора.
  • вторая (та, что после тега TEXT) - что он, собственно, будет отображать.

Основные параметры

ПараметрОписание
TEXTДальше идет текст, выводимый на экран. Обратный слэш (\) обозначает новую строку
alignmentЗадает позицию на экране, может принимать значения
top_left вверху слева, top_right (вверху справа), top_middle (вверху посередине), bottom_left (внизу слева), bottom_right (внизу справа), bottom_middle (внизу посередине), middle_left (слева по центру), middle_middle (по цетру), middle_right (справа по центру), или none
так же возможны аббревиатуры tl, tr, tm, bl, br, bm, ml, mm, mr
append_fileПрикрепить файл для вывода
backgroundЕсли yes, Conky будет запущен в фоне
border_inner_marginОтступ между границей и текстом в пикселах
border_outer_marginОтступ между границей и краем окна в пикселах
border_widthТолщина границы в пикселах
colorNЦвет для использования внутри сегмента TEXT, применяется к последующим элементам. Замените N на цифру от 0 до 9 включительно. При указании цвета в шестнадцатеричном формате опустите '#'
cpu_avg_samplesКоличество замеров для усреднения значения нагрузки на процессор
default_bar_sizeШирина и высота баров. Например 'default_bar_size 0 6'
Особенно это полезно для execbar и execibar, поскольку у них отсутствует параметр размера
default_colorЦвет по умолчанию и цвет границы
default_gauge_sizeШирина и высота датчиковю. Например 'default_gauge_size 25 25'
Особенно это полезно для execgauge и execigauge, поскольку у них отсутствует параметр размера
default_graph_sizeШирина и высота графиков. Например 'default_graph_size 0 25'
Особенно это полезно для execgraph и execigraph, поскольку у них отсутствует параметр размера
default_outline_colorЦвет окантовки
default_shade_colorЦвет тени от текста и границы
disable_auto_reloadВключите для отключения автоматической перезагрузки при изменении файла настроек
diskio_avg_samplesКоличество замеров для усреднения значения операций ввода-вывода дисков
displayДисплей X для вывода
double_bufferИспользовать или нет расширение Xdbe (устраняет мерцание)
Рекомендуется установить 'own_window yes', тогда буфер будет занимать меньше памяти
draw_bordersВключает отображение границы вокруг текста
draw_graph_bordersВключает отображение границы вокруг графиков
draw_outlineВключает отображение окантовки
draw_shadesВключает отображение тени
extra_newlineДобавить еще одну строку в конец при выводе в stdout
fontНазвание шрифта в X
format_human_readableПри включении значения в байтах будут заменены на соответствующие значения в KiB, MiB и т. д.
gap_xОтступ в пикселах по горизонтали от края экрана, указанного в alignment
gap_yОтступ в пикселах по вертикали от края экрана, указанного в alignment
hddtemp_hostХост для подключения к hddtemp, по умолчанию '127.0.0.1'
hddtemp_portПорт для подключения к hddtemp, по умолчанию 7634
if_up_strictnessНасколько точен должен быть if_up при проверке интерфейса на доступность, возможные значения
up интерфейс доступен
link интерфейс доступен и есть связь
addres интерфейс доступен, есть связь и назначен IP аддрес
imapЗадает глобальный IMAP сервер, параметры:
хост имя пароль [-i интервал (в секундах)] [-f 'папка'] [-p порт] [-e 'команда'] [-r попыток]
По умолчанию порт 143, папка 'INBOX', интервал 5 минут, количество попыток 5. Если пароль задан как '*', то он будет запрошен при запуске Conky
imlib_cache_flush_intervalИнтервал (в секундах) сброса кэша Imlib2
imlib_cache_sizeРазмер кэша Imlib2 в байтах, по умолчанию 4MiB
Установите 0 чтобы отключить кэш изображений
lua_draw_hook_postЕсли задана, функция будет вызвана каждый раз после отрисовки окна. Требуется поддержка X. Принимает любые числа в качестве аргументов. Используйте этот hook для отрисовки вещей поверх того, что отображает Conky
Conky добавляет 'conky_' к названиям своих функций для предотвращения случайного вызовова неверной функции
lua_draw_hook_preЕсли задана, функция будет вызвана каждый раз перед отрисовкой окна. Требуется поддержка X. Принимает любые числа в качестве аргументов. Используйте этот hook для отрисовки вещей поверх того, что отображает Conky
Conky добавляет 'conky_' к названиям своих функций для предотвращения случайного вызовова неверной функции
lua_loadЗагрузить Lua скрипты, перечисленные через пробел
lua_shutdown_hookЕсли задана, функция будет вызвана при завершении Conky или при перезагрузке файла настроек. Используйте этот hook для уборки за собой, например освобождения памяти, которая была выделена внешними библиотеками через lua
Conky добавляет 'conky_' к названиям своих функций для предотвращения случайного вызовова неверной функции
lua_startup_hookЕсли задана, функция будет вызвана при старте Conky или при перезагрузке файла настроек. Используйте этот hook для инициализации переменных или для выполняемых только один раз приложений
Conky добавляет 'conky_' к названиям своих функций для предотвращения случайного вызовова неверной функции
mail_spoolПочтовый ящик для проверки
max_port_monitor_connectionsРазрешить каждому монитору портов отслеживать не более этого количества соединений, по умолчанию 256
max_specialsМаксимальное количество специальных вещей (fonts, offsets, aligns и т.д), по умолчанию 512
max_text_widthМаксимальное количество символов в строке, последующие символы будут расположены в новой строке
Если хотите убедиться, что строка не будет разорвана, установите 0
max_user_textМаксимальный размер пользовательского текста внутри сегмента TEXT, по умолчанию 16384B
maximum_widthМаксимальная ширина окна
minimum_sizeМинимальный размер окна
mpd_hostХост MPD
mpd_passwordПароль от MPD сервера
mpd_portПорт MPD сервера
music_player_intervalИнтервал обновления информации от аудиоплеера, по умолчанию - интервал обновления Conky
net_avg_samplesКоличество замеров для усреднения значения сетевой статистики
no_buffersВычитать буфер (file system) из используемой памяти?
nvidia_displayДисплей, который будет использовать переменная nvidia
out_to_consoleВыводить текст на stdout
out_to_ncursesВыводить текст в консоль, но использовать ncurses для вывода нового текста поверх старого
out_to_stderrВыводить текст на stderr
out_to_xПри отключении не будет вывода в X (полезно когда используется вывод в консоль), по умолчанию yes
При установке в no убедитесь, что установлено перед всеми X-зависимыми настройками (поместите первой строкой для надежности)
override_utf8_localeВключение UTF8 независимо от локали системы. Требует XFT
overwrite_fileПереписывать файл, заданный в append_file
own_windowСоздавать собственное окно или нет
own_window_classВручную задать WM_CLASS, по умолчанию «Conky»
own_window_colourПри 'own_window_transparent no' задает цвет фона, по умолчанию черный
Задается либо шестнадцатеричным значением без »#», либо именным цветом (см. /usr/lib/X11/rgb.txt)
own_window_hintsПри 'own_window yes' используется для изменения отображения окна: undecorated, below, sticky, skip_taskbar, skip_pager
При 'own_window_type override' этот параметр игнорируется
Используйте 'own_window_type desktop' как другой способ включить многие из этих функций
own_window_titleВручную задать имя окна, по умолчанию »<hostname> - conky»
own_window_argb_visualВключает полупрозрачность. Для корректной работы необходим композитный менеджер
При 'own_window_type override' этот параметр игнорируется
own_window_argb_valueПри 'own_window_argb_visual yes' задает уровень прозрачности фона, принимает значение от 0 (прозрачный) до 255 (непрозрачный)
own_window_transparentДелает фон полностью прозрачным
own_window_typeПри 'own_window yes' задает тип окна: normal, desktop, dock, panel или override, по умолчанию normal
desktop - окно без декораций, всегда видимо на рабочем столе, отсутствует в переключателе окон и панели задач
panel - так же как и панели резервирует место вдоль края рабочего стола, предотвращая перекрытие развернутыми на весь экран окнами. край выбирается на основании значения alignment
override - не управляется оконным менеджером. own_window_hints игнорируется. Полезно в некоторых ситуациях
pad_percentsPad percentages to this many decimals (0 = no padding)
pop3Задает глобальный POP3 сервер, параметры:
хост имя пароль [-i интервал (в секундах)] [-p порт] [-e 'команда'] [-r попыток]
По умолчанию порт 110, интервал 5 минут, количество попыток 5. Если пароль задан как '*', то он будет запрошен при запуске Conky
short_unitsСокращать единицы измерения до одной буквы (kiB→k, GiB→G и так далее), по умолчанию 'off'
show_graph_rangeПоказывать временной диапазон, охватываемый графиком
show_graph_scaleПоказывать максимальное значение в графике
stippled_bordersПрерывистость границы окна в пикселах
temperature_unitЕдиницы измерения температуры, значения «fahrenheit» или «celsius», по умолчанию «celsius»
templateNОпределяет шаблон для последующего использования внутри сегмента TEXT. Замените N на цифру от 0 до 9 включительно. Значения аргументов записываються в соответствующее положение при обьявлении переменной внутри сегмента TEXT
'\n' → новая строка
'\\' → обратный слэш
'\ ' → пробел
'\X' → аргумент шаблона X
text_buffer_sizeРазмер текстового буфера, по умолчанию 256 байт
Этот буфер используется для промежуточных текстовых данных, таких как вывод $exec или других переменных. Увеличение размера этого буфера может снизить производительность Conky, но позволит выводить больше текста от переменных
Размер буфера не может быть меньше значения по умолчанию
times_in_secondsПри включении переменные, выводящие время, будут выводить его в секундах одним числом
Не влияет на $time, $tztime и $utime
top_cpu_separateОтображать в $top нагрузку на один процессор (yes) или на все процессоры вместе (no)
top_name_widthКоличество символов в имени процесса в $top, по умолчанию 15
total_run_timesКоличество обновлений, после которых Conky выключится
0 - работать постоянно
update_intervalИнтервал обновления в секундах
update_interval_on_batteryИнтервал обновления при работе от аккумулятора
uppercaseВключите для отображения текста В ВЕРХНЕМ РЕГИСТРЕ
use_spacerДобавляет пробелы вокруг некоторых обьектов для предотвращения смещения ими соседних вещей, может принимать значения:
left, right или none, по умолчанию none
Помогает только при использовании моноширинного шрифта, например Bitstream Vera Sans Mono
use_xftВключите для использования Xft
xftalphaПрозрачность Xft шрифтов, принимает значение от 0 до 1 включительно
xftfontШрифт Xft для использования

Доступные переменные

Работа с conky

ПеременнаяПараметрОписание
alignc(num)Выровнять текст по центру
alignr(num)Выровнять текст по правому краю с отступом в N символов
blinkтекст_и_переменныеЗаставляет 'текст_и_переменные' мерцать
color(color)Меняет цвет последующего текста на 'color', заданный именным цветом или шестнадцатеричным кодом с # вначале (например #0A1B2C )
При использовании ncurses доступны следующие цвета: red, green, yellow, blue, magenta, cyan, black, white
colorN Меняет цвет последующего текста на предопределеный colorN, где N - цифра от 0 до 9 включительно
combinevar1 var2Поместить var2 справа от var1 разделив символом, помещенным между var1 и var2
Например ${combine ${head /proc/cpuinfo 2} - ${head /proc/meminfo 1}} даст на выходе «cpuinfo_line1 - meminfo_line1» в первой строке и «cpuinfo_line2 -» во второй. Возможно использование большее количество переменных
conky_build_arch архитектура CPU, для которого был скомпилирован Conky
conky_build_date Дата компиляции Conky
conky_version Версия Conky
evalstringEvaluates given string according to the rules of TEXT interpretation, i.e. parsing any contained text object specifications into their output, any occuring '$$' into a single '$' and so on. The output is then being parsed again
font(font)Задает шрифт для последующего текста.
Использование без аргументов возвращает стандартный шрифт
gotoxСледующий элемент будет выведен на позиции x
hr(height)Горизонтальная линия с указанной толщиной
image<path to image>
(-p x,y) (-s WxH)
(-n) (-f interval)
Выводит указанное изображение используя Imlib2.
-p меняет положение изображения
-s меняет размер
-n отключает кэширование
-f задает интервал кэширования изображения
includepathЗагружает файл конфигурации, заменяет настройки оригинальной конфигурации и вставляет переменные в место, где указан $include
luafunction_name
(function parameters)
Выполняет lua-функцию с заданными параметрами и выводит возвращаемую строку.
Смотри lua_load для загрузки скриптов.
Conky добавляет 'conky_' перед названием функции для предотвращения вызова не той функции (если только сами не добавите)
lua_bar(height, width)
function_name
(function parameters)
Выполняет lua-функцию с заданными параметрами и выводит бар на основе возвращаемого значения.
Результатом выполнения функции должно быть число от 0 до 100
lua_gauge(height, width)
function_name
(function parameters)
Выполняет lua-функцию с заданными параметрами и выводит круговой датчик на основе возвращаемого значения.
Результатом выполнения функции должно быть число от 0 до 100
lua_graphfunction_name
(height),(width)
(gradient colour 1)
(gradient colour 2)
(scale) (-t) (-l)
Выполняет lua-функцию и выводит график на основе возвращаемого значения.
Результатом выполнения функции может быть любое число, график масштабируется для отображения всего диапазона значений
lua_parsefunction_name
(function parameters)
Выполняет lua-функцию с заданными параметрами так же, как и $lua, но затем обрабатывает результат как часть секции TEXT
offset(pixels)Изменяет горизонтальное смещение текста. Возможны отрицательные значения.
Смотри так же $offset.
outlinecolor(color)Изменить цвет контура
scrolllength (step) textПрокручивает 'text' с шагом 'step', отображая за раз 'length' символов.
Текст может содержать переменные conky
step не обязателен и по умолчанию равен 1
shadecolor(color)Изменяет цвет тени
stippled_hr(space)Прерывистая горизонтальная линия
tab(width, (start))Puts a tab of the specified width, starting from column 'start'. The unit is pixels for both arguments.
templateN(arg1)Вычисляет значение templateN из настроек (N число от 0 до 9 включительно), подставляя соответствующие аргументы
to_bytessizeЕсли 'size' - число с указанными единицами (kilobyte,mb,GiB,…), тогда оно конвертируется в байты и выводится, иначе просто выводится как есть.
updates Количество обновлений окна. Для отладки
voffset(pixels)Изменяет вертикальное смещение текста. Возможны отрицательные значения.
Смотри так же $offset.

Работа с файлами и дисками

ПеременнаяПараметрОписание
disk_protectdeviceСтатус защиты диска, если эта функция поддерживается (требуется патч для ядра)
Выводит «frozen» или «free»
diskio(device)Отображает текущую IO диска. Указание устройства не обязательно и принимает вид sda для /dev/sda
допускаются отдельные разделы
diskio_read(device)Отображает текущую IO диска для чтения
Устройства как в diskio
diskio_write(device)Отображает текущую IO диска для записи
Устройства как в diskio
diskiograph(device)
(height),(width)
(gradient colour 1)
(gradient colour 2)
(scale) (-t) (-l)
График IO диска
Цвета задаются шестнадцатеричным кодом без #
Масштаб используется для задания максимального значения графика
Для использования логарифмического масштабирования (для лучшего отображения небольших чисел) добавте -l
Добавление '-t' включает температурный градиент, который меняется в зависимости от значений
diskiograph_read(device)
(height),(width)
(gradient colour 1)
(gradient colour 2)
(scale) (-t) (-l)
График IO диска для чтения
Устройства как в diskio
Цвета задаются шестнадцатеричным кодом без #
Масштаб используется для задания максимального значения графика
Для использования логарифмического масштабирования (для лучшего отображения небольших чисел) добавте -l
Добавление '-t' включает температурный градиент, который меняется в зависимости от значений
diskiograph_write(device)
(height),(width)
(gradient colour 1)
(gradient colour 2)
(scale) (-t) (-l)
График IO диска для записи
Устройства как в diskio
Цвета задаются шестнадцатеричным кодом без #
Масштаб используется для задания максимального значения графика
Для использования логарифмического масштабирования (для лучшего отображения небольших чисел) добавте -l
Добавление '-t' включает температурный градиент, который меняется в зависимости от значений
execcommandВыполняет команду оболочки и отображает результат в conky.
Используйте двойные кавычки для комманд с пробелами.
Внимание: эта переменная потребляет довольно много ресурсов
execbarcommandТо же, что и $exec, но если результат - число от 0 до 100, то выводит бар.
Размеры задаются через настройку default_bar_size.
execgaugecommandТо же, что и $exec, но если результат - число от 0 до 100, то выводит круглый датчик.
Размеры задаются через настройку default_gauge_size.
execgraph(-t) (-l) commandТо же, что и $execbar, но выводит график.
execiinterval commandТо же, что и $exec, но с заданным интервалом выполнения.
Интервал не может быть меньше update_interval
execibarinterval commandТо же, что и $execbar, но с заданным интервалом выполнения.
execigaugeinterval commandТо же, что и $execgauge, но с заданным интервалом выполнения.
execigraphinterval
(-t) (-l) command
То же, что и $execgraph, но с заданным интервалом выполнения.
execpcommandТо же, что и $exec, но результат обрабатывается как текст после TEXT
execpiinterval commandТо же, что и $execp, но с заданным интервалом выполнения.
fs_bar(height),(width) fsБар использования места по пути 'fs'
fs_bar_free(height),(width) fsБар свободного места
fs_free(fs)Свободное место по пути 'fs', доступное пользователю
fs_free_perc(fs)Процент свободного места по пути 'fs', доступного пользователю
fs_size(fs)Размер ФС
fs_type(fs)Тип ФС
fs_used(fs)Использованное место ФС
fs_used_perc(fs)Процент использования места
headlogfile lines
(next_check)
Показывает первые N строк указанного файла. Файл проверяется через каждое 'next_check' обновление (по умолчанию 2)
Максимум 30 строк может быть показано
iconv_startcodeset_from
codeset_to
Конвертирует текст из одной кодировки в другую используя GNU iconv.
Необходима остановка с помощью $iconv_stop
iconv_stop Останавливает конвертирование текста
ioschedulerdiskPrints the current ioscheduler used for the given disk name (i.e. e.g. «hda» or «sdb»)
linestextfileПоказывает количество строк в указанном файле
pre_execshell commandExecutes a shell command one time before conky displays anything and puts output as text.
taillogfile lines
(next_check)
Показывает последние N строк указанного файла. Файл проверяется через каждое 'next_check' обновление (по умолчанию 2)
Максимум 30 строк может быть показано
texeciinterval commandТо же, что и $execi, но команда выполняется внутри потока.
Используйте это, если у вас «тяжелый» скрипт. Поставьте интервал выполнения чуть больше, чем выполняется ваш скрипт
wordstextfileВыводит количество слов в данном файле

Работа с процессами

ПеременнаяПараметрОписание
cmdline_to_pidstringPID первого процесса, содержащего строку
pid_chrootpidДиректория, используемая процессом как корень.
Будет '/' пока процесс не сделает системный вызов 'chroot'
pid_cmdlinepidКомандна, вызвавшая данный процесс
pid_cwdpidТекущий рабочий каталог процесса
pid_environpid varnameContents of a environment-var of the process
pid_environ_listpidList of environment-vars that the process can see
pid_exepidPath to executed command that started the process
pid_nicepidThe nice value of the process
pid_openfilespidСписок открытых процессом файлов
pid_parentpidPid родительского процесса
pid_prioritypidПриоритет процесса
pid_readpidКоличество байт прочитанных процессом
pid_statepidСостояние процесса
pid_state_shortpidОдна буква из «RSDZTW», отображающая состояние процесса
pid_stderrpidFiledescriptor binded to the STDERR of the process
pid_stdinpidFiledescriptor binded to the STDIN of the process
pid_stdoutpidFiledescriptor binded to the STDOUT of the process
pid_threadspidNumber of threads in process containing this thread
pid_thread_listpidList with pid's from threads from this process
pid_time_kernelmodepidAmount of time that the process has been scheduled in kernel mode in seconds
pid_time_usermodepidAmount of time that the process has been scheduled in user mode in seconds
pid_timepidSum of $pid_time_kernelmode and $pid_time_usermode
pid_uidpidThe real uid of the process
pid_euidpidThe effective uid of the process
pid_suidpidThe saved set uid of the process
pid_fsuidpidThe file system uid of the process
pid_gidpidThe real gid of the process
pid_egidpidThe effective gid of the process
pid_sgidpidThe saved set gid of the process
pid_fsgidpidThe file system gid of the process
pid_vmpeakpidPeak virtual memory size of the process
pid_vmsizepidVirtual memory size of the process
pid_vmlckpidLocked memory size of the process
pid_vmhwmpidPeak resident set size («high water mark») of the process
pid_vmrsspidResident set size of the process
pid_vmdatapidData segment size of the process
pid_vmstkpidStack segment size of the process
pid_vmexepidText segment size of the process
pid_vmlibpidShared library code size of the process
pid_vmptepidPage table entries size of the process
pid_writepidКоличество байт записанных процессом
processes Всего процессов (спящих и запущенных)
running_processes Запущенных процессов (не спящих), требуется ядро 2.6+
running_threads Количество запущенных потоков. Только для Linux
threads Всего потоков
toptype numThis takes arguments in the form:top (name) (number) Basically, processes are ranked from highest to lowest in terms of cpu usage, which is what (num) represents. The types are: «name», «pid», «cpu», «mem», «mem_res», «mem_vsize», «time», «io_perc», «io_read» and «io_write». There can be a max of 10 processes listed.
top_iotype numSame as top, except sorted by the amount of I/O the process has done during the update interval
top_memtype numSame as top, except sorted by mem usage instead of cpu
top_timetype numSame as top, except sorted by total CPU time instead of current CPU usage

Сетевое оборудование

ПеременнаяПараметрОписание
addr(interface)Выводит текущий IP адрес для заданного интерфейся или «No Address» если он не назначен
addrs(interface)Выводит текущие IP адреса для заданных интерфейсов. Если интерфейс один - работает как addr. Только для Linux
downspeed(net)Скорость загрузки в соответствующих единицах IEC
downspeedf(net)Скорость загрузки в KiB с одной цифрой после запятой
downspeedgraph(netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)График скорости загрузки
Цвета задаются шестнадцатеричным кодом без #
Масштаб используется для задания максимального значения графика
Для использования логарифмического масштабирования (для лучшего отображения небольших чисел) добавте -l
Добавление '-t' включает температурный градиент, который меняется в зависимости от значений
gw_iface Displays the default route's interface or «multiple»/«none» accordingly.
gw_ip Displays the default gateway's IP or «multiple»/«none» accordingly.
nameserver(index)Print a nameserver from /etc/resolv.conf. Index starts at and defaults to 0.
nodename Hostname
nodename_short Short hostname (same as 'hostname -s' shell command).
read_tcp(host) portConnects to a tcp port on a host (default is localhost), reads every char available at the moment and shows them.
tcp_portmonport_begin port_end
item (index)
TCP port (both IPv6 and IPv4) monitor for specified local ports. Port numbers must be in the range 1 to 65535. Valid items are:
count - Total number of connections in the range
rip - Remote ip address
rhost - Remote host name
rport - Remote port number
rservice - Remote service name from /etc/services
lip - Local ip address
lhost - Local host name
lport - Local port number
lservice - Local service name from /etc/services
The connection index provides you with access to each connection in the port monitor. The monitor will return information for index values from 0 to n-1 connections. Values higher than n-1 are simply ignored. For the «count» item, the connection index must be omitted. It is required for all other items.
Examples:
${tcp_portmon 6881 6999 count} - Displays the number of connections in the bittorrent port range
${tcp_portmon 22 22 rip 0} - Displays the remote host ip of the first sshd connection
${tcp_portmon 22 22 rip 9} - Displays the remote host ip of the tenth sshd connection
${tcp_portmon 1 1024 rhost 0} - Displays the remote host name of the first connection on a privileged port
${tcp_portmon 1 1024 rport 4} - Displays the remote host port of the fifth connection on a privileged port
${tcp_portmon 1 65535 lservice 14} - Displays the local service name of the fifteenth connection in the range of all ports
Note that port monitor variables which share the same port range actually refer to the same monitor, so many references to a single port range for different items and different indexes all use the same monitor internally. In other words, the program avoids creating redundant monitors.
totaldown(net)Всего входящего трафика. Обнуляется на 4 Гб на 32х битных системах.
totalup(net)Всего исходящего трафика. Обнуляется на 4 Гб на 32х битных системах.
upspeed(net)Скорость исходящего трафика в соответствующих единицах IEC
upspeedf(net)Скорость исходящего трафика в KiB с одной цифрой после запятой
upspeedgraph(netdev) (height),(width)
(gradient colour 1)
(gradient colour 2)
(scale) (-t) (-l)
График скорости исходящего трафика
wireless_ap(net)MAC адрес беспроводной точки доступа (только для Linux)
wireless_bitrate(net)Скорость передачи данных (например 11 Mb/s) (только для Linux)
wireless_essid(net)ESSID беспроводной точки доступа (только для Linux)
wireless_link_bar(height),(width) (net)Бар качества связи (только для Linux)
wireless_link_qual(net)Качество связи (только для Linux)
wireless_link_qual_max(net)Максимальное значение качества связи (только для Linux)
wireless_link_qual_perc(net)Качество связи в % (только для Linux)
wireless_mode(net)Тип беспроводного соединения (Managed/Ad-Hoc/Master) (только для Linux)

Получение данных из интернета

ПеременнаяПараметрОписание
curlurl (interval_in_minutes)Download data from URI using Curl at the specified interval. The interval may be a floating point value greater than 0, otherwise defaults to 15 minutes. Most useful when used in conjunction with Lua and the Lua API. This object is threaded, and once a thread is created it can't be explicitly destroyed. One thread will run for each URI specified. You can use any protocol that Curl supports.
draft_mails(maildir)Number of mails marked as draft in the specified mailbox or mail spool if not. Only maildir type mailboxes are supported, mbox type will return -1
eveapi_userid api_key character_idПолучает ваш текущий скилл через api сервера Eve Online
отображает текущий скилл вместе со временем прокачивания
flagged_mails(maildir)Number of mails marked as flagged in the specified mailbox or mail spool if not. Only maildir type mailboxes are supported, mbox type will return -1.
forwarded_mails(maildir)Number of mails marked as forwarded in the specified mailbox or mail spool if not. Only maildir type mailboxes are supported, mbox type will return -1.
imap_messages(args)Displays the number of messages in your global IMAP inbox by default. You can define individual IMAP inboxes separately by passing arguments to this object. Arguments are: «host user pass [-i interval (in seconds)] [-f 'folder'] [-p port] [-e 'command'] [-r retries]». Default port is 143, default folder is 'INBOX', default interval is 5 minutes, and default number of retries before giving up is 5. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
imap_unseen(args)Displays the number of unseen messages in your global IMAP inbox by default. You can define individual IMAP inboxes separately by passing arguments to this object. Arguments are: «host user pass [-i interval (in seconds)] [-f 'folder'] [-p port] [-e 'command'] [-r retries]». Default port is 143, default folder is 'INBOX', default interval is 5 minutes, and default number of retries before giving up is 5. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
mails(mailbox)Mail count in the specified mailbox or your mail spool if not. Both mbox and maildir type mailboxes are supported. You can use a program like fetchmail to get mails from some server using your favourite protocol. See also new_mails.
mboxscan(-n number of messages to print) (-fw from width) (-sw subject width) mboxPrint a summary of recent messages in an mbox format mailbox. mbox parameter is the filename of the mailbox (can be encapsulated using '»', ie. ${mboxscan -n 10 »/home/brenden/some box»}
new_mails(mailbox)Unread mail count in the specified mailbox or mail spool if not. Both mbox and maildir type mailboxes are supported.
pop3_unseen(args)Displays the number of unseen messages in your global POP3 inbox by default. You can define individual POP3 inboxes separately by passing arguments to this object. Arguments are: «host user pass [-i interval (in seconds)] [-p port] [-e 'command'] [-r retries]». Default port is 110, default interval is 5 minutes, and default number of retries before giving up is 5. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
pop3_used(args)Displays the amount of space (in MiB) used in your global POP3 inbox by default. You can define individual POP3 inboxes separately by passing arguments to this object. Arguments are: «host user pass [-i interval (in seconds)] [-p port] [-e 'command'] [-r retries]». Default port is 110, default interval is 5 minutes, and default number of retries before giving up is 5. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
replied_mails(maildir)Number of mails marked as replied in the specified mailbox or mail spool if not. Only maildir type mailboxes are supported, mbox type will return -1.
rssuri interval_in_minutes action
(num_par (spaces_in_front))
Download and parse RSS feeds. The interval may be a floating point value greater than 0, otherwise defaults to 15 minutes. Action may be one of the following: feed_title, item_title (with num par), item_desc (with num par) and item_titles (when using this action and spaces_in_front is given conky places that many spaces in front of each item). This object is threaded, and once a thread is created it can't be explicitly destroyed. One thread will run for each URI specified. You can use any protocol that Curl supports.
seen_mails(maildir)Number of mails marked as seen in the specified mailbox or mail spool if not. Only maildir type mailboxes are supported, mbox type will return -1.
trashed_mails(maildir)Number of mails marked as trashed in the specified mailbox or mail spool if not. Only maildir type mailboxes are supported, mbox type will return -1.
unflagged_mails(maildir)Number of mails not marked as flagged in the specified mailbox or mail spool if not.
Only maildir type mailboxes are supported, mbox type will return -1.
unforwarded_mails(maildir)Number of mails not marked as forwarded in the specified mailbox or mail spool if not.
Only maildir type mailboxes are supported, mbox type will return -1.
unreplied_mails(maildir)Number of mails not marked as replied in the specified mailbox or mail spool if not.
Only maildir type mailboxes are supported, mbox type will return -1.
unseen_mails(maildir)Number of new or unseen mails in the specified mailbox or mail spool if not.
Only maildir type mailboxes are supported, mbox type will return -1.
weatherURI locID
data_type
(interval_in_minutes)
Download, parse and display METAR data.
Доступны два URI:
http://weather.noaa.gov/pub/data/observations/metar/stations/
http://xoap.weather.com/weather/local/
Первый свободен для использования, а второй требует регистрации и получения partner ID и license key, которые необходимо прописать через пробел в файл ~/.xoaprc
locID код города для выбранного URI:
Для NOAA https://pilotweb.nas.faa.gov/qryhtml/icao/
Для weather.com http://aspnetresources.com/tools/locid.aspx

data_type может принимать значения:
last_update Дата и время получения данных:
Для NOAA это дата в формате (yyyy/mm/dd) и время по UTC
Для weather.com это дата в формате ([m]m/[d]d/yy) и локальное время станции

temperature температура воздуха. Для изменения единиц измерения используйте temperature_unit
cloud_cover The highest cloud cover status

pressure давление в милибарах

wind_speed скорость ветра в км/ч

wind_dir направление ветра

wind_dir_DEG направление ветра по компасу

humidity Relative humidity in %

weather погодные условия (дождь, снег, пр.) Не используеться при запросе к weather.com

icon иконка погоды (только для www.weather.com). Can be used together with the icon kit provided upon registering to their service


delay_in_minutes время между запросами, по умолчанию 30 минут и не может быть меньше

This object is threaded, and once a thread is created it can't be explicitly destroyed. One thread will run for each URI specified.
Note that these variables are still EXPERIMENTAL and can be subject to many future changes.
weather_forecastURI locID day
data_type
(interval_in_minutes)
выводит погоду для заданного дня (только дневные температуры)
В качестве URI доступен только http://xoap.weather.com/weather/local/

locID смотри weather

day число от 0 (сегодня) до 4

data_type может принимать значения:
day день недели
date дата в формате МММ ДД (Jul 14)
low минимальная температура
hi макимальная температура
icon иконка погоды. Can be used together with the icon kit provided upon registering to the weather.com service
forecast погодные условия (солнечно, дождь, пр.)
wind_speed скорость ветра в км/ч
wind_dir направление ветра

wind_dir_DEG направление ветра по компасу

humidity - Relative humidity in %
precipitation - Probability of having a precipitation (in %)


delay_in_minutes время между запросами, по умолчанию 210 минут и не может быть меньше

This object is threaded, and once a thread is created it can't be explicitly destroyed. One thread will run for each URI specified. You can use any protocol that Curl supports.
Note that these variables are still EXPERIMENTAL and can be subject to many future changes.

Аудио плееры

ПеременнаяПараметрОписание
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 Количество треков в плейлисте
audacious_playlist_position Позиция трека в плейлисте
audacious_position Позиция текущего трека (MM:SS)
audacious_position_seconds Позиция текущего трека в секундах
audacious_status Статус плеера (Playing/Paused/Stopped/Not running)
audacious_title(max length)Заголовок текущего трека, параметр определяет максимальную длину
bmpx_album Альбом текущего трека
bmpx_artist Исполнитель текущего трека
bmpx_bitrate Битрейт текущего трека
bmpx_title Заголовок текущего трека
bmpx_track Номер текущего трека
bmpx_uri URI текущего трека
moc_album Альбом текущей MOC песни
moc_artist Исполнитель текущей MOC песни
moc_bitrate Битрейт в текущей MOC песни
moc_curtime Время текущей MOC песни
moc_file Имя файла текущей MOC песни
moc_rate Справка для текущей MOC песни
moc_song Имя текущей песни проигрываемой в MOC.
moc_state Текущее состояние MOC; Проигрывает, остановлен и т.д.
moc_timeleft Оставшееся время в текущей MOC песне
moc_title Заголовок текущей MOC песни
moc_totaltime Продолжительность текущей MOC песни
mpd_album Альбом в текущей MPD песне
mpd_artist Включить дорожку исполнителя MPD песни во время компиляции
mpd_bar(height),(width)Бар для процесса mpd's
mpd_bitrate Брейт текущей песни
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's
xmms2_album Альбом текущего трека
xmms2_artist Исполнитель текущего трека
xmms2_bar(height),(width)Бар текущего трека
xmms2_bitrate Битрейт текущего трека
xmms2_comment Коментарий к текущему треку
xmms2_date Возвращает дату ткущего трека
xmms2_duration Продолжительность трека
xmms2_elapsed Истекшее время песни
xmms2_genre Жанр
xmms2_id XMMS2 id трека
xmms2_percent Процент проигрывания
xmms2_playlist Возвращает плейлист
xmms2_size Размер трека
xmms2_smart Выводит название песни в виде «артист - название» или имя файла, если отсутствуют тэги
xmms2_status Статус XMMS2 (Playing/Paused/Stopped/Disconnected)
xmms2_timesplayed Количество раз, которое воспроизводился трек
xmms2_title Заголовок
xmms2_tracknr Номер трека
xmms2_url Полный путь до файла

Работа с датчиками

ПеременнаяПараметрОписание
acpiacadapter(adapter)Состояние ACPI AC адаптера. В линуксе параметр задает поддиректорию /sys/class/power_supply, содержащую информацию о состоянии (попробуйте «AC» и «ADP1» если переметр не задан)
Работает только в Linux
acpifan Состояние ACPI вентилятора
acpitemp Температура ACPI в °C
adt746xcpu Температура CPU из therm_adt746x
adt746xfan Скорость вентилятора из therm_adt746x
apcupsdhostУстанавливает адрес подключения к демону 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)
График загрузки UPS
Цвета задаются шестнадцатеричным кодом без #
Масштаб используется для задания максимального значения графика
Для использования логарифмического масштабирования (для лучшего отображения небольших чисел) добавте -l
Добавление '-t' включает температурный градиент, который меняется в зависимости от значений
apcupsd_model Выводит модель UPS
apcupsd_name Выводит заданное пользователем имя
apcupsd_status Выводит текущий статус (on-line, on-battery)
apcupsd_temp Текущая внутренняя температура
apcupsd_timeleft Оставшееся время работы от аккумулятора
apcupsd_upsmode Выводит тип UPS (например standalone)
apm_adapter Выводит статус APM AC адаптера. только для FreeBSD
apm_battery_life Выводит APM battery life в процентах. только для FreeBSD
apm_battery_time Выводит оставшееся время жизни аккумулятора в hh:mm:ss или «unknown» если адаптер подключен к сети или заряжается. только для FreeBSD
battery(num)Статус ACPI или APM аккумулятора и оставшийся заряд в процентах. Номер ACPI аккумулятора может быть передан как аргумент, по умолчанию BAT0
battery_bar(height),(width) (num)Бар оставшегося заряда аккумулятора
battery_percent(num)Оставшийся заряд аккумулятора в процентах
battery_short(num)Статус ACPI или APM аккумулятора и оставшийся заряд в процентах. Этот параметр отображает статус в коротком виде: C заряжается, D разряжается, F заряжена, N не для представления, E разряжена, U неизвестно
battery_time(num)Время до полной зарядки/разрядки аккумулятора
i2c(dev) type n (factor offset)I2C sensor from sysfs (Linux 2.6). Parameter dev may be omitted if you have only one I2C device. Parameter type is either 'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning temperature. Parameter n is number of the sensor. See /sys/bus/i2c/devices/ on your local computer. The optional arguments 'factor' and 'offset' allow precalculation of the raw input, which is being modified as follows: 'input = input * factor + offset'. Note that they have to be given as decimal values (i.e. contain at least one decimal place).
i8k_ac_status If running the i8k kernel driver for Inspiron laptops, displays whether ac power is on, as listed in /proc/i8k (translated to human-readable). Beware that this is by default not enabled by i8k itself.
i8k_bios If running the i8k kernel driver for Inspiron laptops, displays the bios version as listed in /proc/i8k.
i8k_buttons_status If running the i8k kernel driver for Inspiron laptops, displays the volume buttons status as listed in /proc/i8k.
i8k_cpu_temp If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in Celsius, as reported by /proc/i8k.
i8k_left_fan_rpm If running the i8k kernel driver for Inspiron laptops, displays the left fan's rate of rotation, in revolutions per minute as listed in /proc/i8k. Beware, some laptops i8k reports these fans in reverse order.
i8k_left_fan_status If running the i8k kernel driver for Inspiron laptops, displays the left fan status as listed in /proc/i8k (translated to human-readable). Beware, some laptops i8k reports these fans in reverse order.
i8k_right_fan_rpm If running the i8k kernel driver for Inspiron laptops, displays the right fan's rate of rotation, in revolutions per minute as listed in /proc/i8k. Beware, some laptops i8k reports these fans in reverse order.
i8k_right_fan_status If running the i8k kernel driver for Inspiron laptops, displays the right fan status as listed in /proc/i8k (translated to human-readable). Beware, some laptops i8k reports these fans in reverse order.
i8k_serial If running the i8k kernel driver for Inspiron laptops, displays your laptop serial number as listed in /proc/i8k.
i8k_version If running the i8k kernel driver for Inspiron laptops, displays the version formatting of /proc/i8k.
ibm_brightness If running the IBM ACPI, displays the brigtness of the laptops's LCD (0-7).
ibm_fan If running the IBM ACPI, displays the fan speed.
ibm_tempsNIf running the IBM ACPI, displays the temperatures from the IBM temperature sensors (N=0..7) Sensor 0 is on the CPU, 3 is on the GPU.
ibm_volume If running the IBM ACPI, displays the «master» volume, controlled by the volume keys (0-14).
freq(n)Возращает частоту CPU #n в MHz. CPU считаются от 1. Обычное значение 1.
freq_g(n)Возращает частоту CPU #n в GHz. CPU считаются от 1. Обычное значение 1.
hddtemp(dev)Displays temperature of a selected hard disk drive as reported by the hddtemp daemon. Use hddtemp_host and hddtemp_port to specify a host and port for all hddtemp objects. If no dev parameter is given, the first disk returned by the hddtemp daemon is used.
hwmon(dev) type n (factor offset)Hwmon sensor from sysfs (Linux 2.6). Parameter dev may be omitted if you have only one hwmon device. Parameter type is either 'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning temperature. Parameter n is number of the sensor. See /sys/class/hwmon/ on your local computer. The optional arguments 'factor' and 'offset' allow precalculation of the raw input, which is being modified as follows: 'input = input * factor + offset'. Note that they have to be given as decimal values (i.e. contain at least one decimal place).
laptop_mode Значение /proc/sys/vm/laptop_mode
machine Разрядность системы
nvidiathresholdNvidia graficcard support for the XNVCtrl library. Each option can be shortened to the least significant part. Temperatures are printed as float, all other values as integer.
threshold - The thresholdtemperature at which the gpu slows down
temp - Gives the gpu current temperature
ambient - Gives current air temperature near GPU case
gpufreq - Gives the current gpu frequency
memfreq - Gives the current mem frequency
imagequality - Which imagequality should be chosen by OpenGL applications
pb_batteryitemЕсли запущено на Apple powerbook/ibook, отображает информацию о батарее. The item parameter specifies, what information to display. Exactly one item must be specified. Valid items are:
status - Display if battery is fully charged, charging, discharging or absent (running on AC)
percent - Display charge of battery in percent, if charging or discharging. Nothing will be displayed, if battery is fully charged or absent.
time - Display the time remaining until the battery will be fully charged or discharged at current rate. Nothing is displayed, if battery is absent or if it's present but fully charged and not discharging.
platform(dev) type n (factor offset)Platform sensor from sysfs (Linux 2.6). Parameter dev may be omitted if you have only one platform device. Platform type is either 'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning temperature. Parameter n is number of the sensor. See /sys/bus/platform/devices/ on your local computer. The optional arguments 'factor' and 'offset' allow precalculation of the raw input, which is being modified as follows: 'input = input * factor + offset'. Note that they have to be given as decimal values (i.e. contain at least one decimal place).
smapi(ARGS)when using smapi, display contents of the /sys/devices/platform/smapi directory. ARGS are either '(FILENAME)' or 'bat (INDEX) (FILENAME)' to display the corresponding files' content. This is a very raw method of accessing the smapi values. When available, better use one of the smapi_* variables instead.
smapi_bat_bar(INDEX),(height),(width)when using smapi, display the remaining capacity of the battery with index INDEX as a bar.
smapi_bat_perc(INDEX)when using smapi, display the remaining capacity in percent of the battery with index INDEX. This is a separate variable because it supports the 'use_spacer' configuration option.
smapi_bat_powerINDEXwhen using smapi, display the current power of the battery with index INDEX in watt. This is a separate variable because the original read out value is being converted from mW. The sign of the output reflects charging (positive) or discharging (negative) state.
smapi_bat_tempINDEXwhen using smapi, display the current temperature of the battery with index INDEX in degree Celsius. This is a separate variable because the original read out value is being converted from milli degree Celsius.
sony_fanspeed Отображает скорость вентиляторов на Sony VAIO если поддержка sony-laptop включена в ядре. Только на Linux.
voltage_mv(n)Возвращает напряжение на n-ном процессоре в мВ.
Без параметра возвращает для первого
voltage_v(n)Возвращает напряжение на n-ном процессоре в В.
Без параметра возвращает для первого

Работа с if

ПеременнаяПараметрОписание
elseText to show if any of the above are not true
endifЗакрывает блок $if
if_empty(var)if conky variable VAR is empty, display everything between $if_empty and the matching $endif
if_existingfile (string)if FILE exists, display everything between if_existing and the matching $endif. The optional second paramater checks for FILE containing the specified string and prints everything between $if_existing and the matching $endif.
if_gw if there is at least one default gateway, display everything between $if_gw and the matching $endif
if_matchexpressionEvaluates the given boolean expression, printing everything between $if_match and the matching $endif depending on whether the evaluation returns true or not. Valid expressions consist of a left side, an operator and a right side. Left and right sides are being parsed for contained text objects before evaluation. Recognised left and right side types are:
double - Argument consists of only digits and a single dot.
long - Argument consists of only digits.
string - Argument is enclosed in quotation marks (»)
Valid operands are: '>', '<', '>=', '⇐', '==', '!='.
if_mixer_mute(mixer)If mixer exists, display everything between $if_mixer_mute and the matching $endif. If no mixer is specified, «Master» is used.
if_mounted(mountpoint)if MOUNTPOINT is mounted, display everything between $if_mounted and the matching $endif
if_mpd_playing if mpd is playing or paused, display everything between $if_mpd_playing and the matching $endif
if_running(process)if PROCESS is running, display everything $if_running and the matching $endif. This uses the ``pidof'' command, so the -x switch is also supported.
if_smapi_bat_installed(INDEX)when using smapi, if the battery with index INDEX is installed, display everything between $if_smapi_bat_installed and the matching $endif
if_up(interface)if INTERFACE exists and is up, display everything between $if_up and the matching $endif
if_updatenr(updatenr)If it's the UPDATENR-th time that conky updates, display everything between $if_updatenr and the matching $endif. The counter resets when the highest UPDATENR is reached. Example : »{$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr 4}$endif» shows foo 25% of the time followed by bar 25% of the time followed by nothing the other half of the time.
if_xmms2_connected Display everything between $if_xmms2_connected and the matching $endif if xmms2 is running.

Различные системные параметры

ПеременнаяПараметрОписание
buffers Обьем буферизированной памяти
cached Обьем кэшированной памяти
cpu(cpuN)Использование CPU в процентах. Для SMP компьютеров номер CPU может быть задан как параметр
${cpu cpu0} показывает общее использование процессора, а ${cpu cpuX} (X >= 1) индивидуально по ядрам.
cpubar(cpuN)
(height),(width)
Бар использования CPU
cpugauge(cpuN)
(height),(width)
Датчик использования CPU
cpugraph(cpuN)
(height),(width)
(gradient colour 1)
(gradient colour 2)
(scale) (-t) (-l)
График использования CPU
Цвета задаются шестнадцатеричным кодом без #
Масштаб используется для задания максимального значения графика
Для использования логарифмического масштабирования (для лучшего отображения небольших чисел) добавте -l
Добавление '-t' включает температурный градиент, который меняется в зависимости от значений
desktop Номер рабочего стола, на котором запущены conky или «Not running in X», если запущены не в иксах
desktop_name Название рабочего стола, на котором запущены conky или «Not running in X», если запущены не в иксах
desktop_number Номер рабочего стола или «Not running in X», если запущены не в иксах
entropy_avail Текущая энтропия, доступная для крипто-фриков
entropy_bar(height),(width)Нормированный бар энтропии, доступной для крипто-фриков
entropy_perc Процент энтропии, доступной по сравнению с poolsize
entropy_poolsize Общий размер системного пула энтропии, доступной для крипто-фриков
format_timeseconds formatFormat time given in seconds. This var only works when the times_in_seconds configuration setting is on. Format is a string that should start and end with a »-char. The »-chars are not part of the output, \w,\d,\h,\m,\s,\(,\) and
are replaced by weeks,days,hours,minutes,seconds,(,) and \. If you leave out a unit, it's value will be expressed in the highest unite lower then the one left out. Text between ()-chars will not be visible if a replaced unit in this text is 0. If seconds is a decimal number then you can see the numbers behind the point by using \S followed by a number that specifies the amount of digits behind the point that you want to see (maximum 9). You can also place a 'x' behind \S so you have all digits behind the point and no trailing zero's. (also maximum 9)
kernel Версия ядра
loadavg(n)System load average, 1 is for past 1 minute, 2 for past 5 minutes and 3 for past 15 minutes. Without argument, prints all three values separated by whitespace.
loadgraph(height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)Load1 average graph, similar to xload, with optional colours in hex, minus the #. Uses a logarithmic scale (to see small numbers) when you use the -l switch. Takes the switch '-t' to use a temperature gradient, which makes the gradient values change depending on the amplitude of a particular graph value (try it and see).
mem Объем используемой (занятой) оперативной памяти
membar(height),(width)Бар, показывающий количество занятой памяти
memeasyfree Amount of free memory including the memory that is very easily freed (buffers/cache)
memfree Количество свободной памяти
memgauge(height),(width)Gauge that shows amount of memory in use (see cpugauge)
memgraph(height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)Memory usage graph. Uses a logarithmic scale (to see small numbers) when you use the -l switch. Takes the switch '-t' to use a temperature gradient, which makes the gradient values change depending on the amplitude of a particular graph value (try it and see).
memmax Объем доступной оперативной памяти (100%)
memperc % используемой (занятой) оперативной памяти
monitor Количество мониторов на которых запущен conky или вывод сообщения «Not running in X» если запущен не в X сервере.
monitor_number Количество мониторов или вывод сообщения «Not running in X» если запущен не в X сервере.
swap Объем использованного swap
swapbar(height),(width)Бар использования swap
swapfree Объем свободного swap
swapmax Общий объем swap
swapperc Процент использования swap
sysname Имя системы, например Linux
time(format)Локальное время (дата) по шаблону
tztime(timezone (format))Локальное время для указанной зоны (смотри man strftime для дополнительной информации).
Зона задается так же как переменная окружения TZ.
Смотри /usr/share/zoneinfo. Например US/Pacific, Europe/Zurich, etc.
gid_namegidИмя группы с данным gid
uid_nameuidИмя пользователя с данным uid
uptime Время работы компьютера(Аптайм)
uptime_short Аптайм короткой строкой
user_names Список имен залогиненных пользователей
user_number Количество залогиненых пользователей
user_terms Список используемых консолей
user_times Сколько времени пользователь залогинен
user_timeconsoleСколько времени пользователь залогинен в указанной консоли
utime(format)Выводит время по UTC

ConkyForecast

Получение погоды при помощи скрипта conkyForecast.

Установка

Для корректной работы необходимо установить пакет conkyforecast, доступный из стороннего ppa

sudo add-apt-repository ppa:conky-companions/ppa
sudo apt-get update && sudo apt-get install conkyforecast

Данный репозиторий содержит также некоторые пакеты для работы conky с основными распространенными приложениями. Полный список пакетов можно посмотреть на странице PPA. Перечень опций для каждого пакета можно узнать после установки набрав в терминале
man <имя_пакета>

Регистрация

Для работы conkyforecast необходимо зарегистрироваться на сайте www.weather.com.

Сайт весьма перегружен, поэтому страница регистрации иногда бывает недоступна, в случае проблем повторите попытку через 3-5 часов.

После завершения регистрации на указанный почтовый ящик придет последовательно два письма, первый со ссылкой для подтверждения регистрации, после перехода по которой придет второе письмо с ключом, необходимым для работы conky.

Определение кода города

Для определения кода Вашего города необходимо перейти на страницу вывода погоды сайта www.weather.com и в строке поиска Search ZIP, City or Place необходимо указать название города на английском языке (можно попробовать транслит). После перехода на страницу отображения погоды в адресной строке будет адрес подобный следующему:

http://www.weather.com/weather/right-now/RSXX0063:1

Здесь RSXX0063 код города Москва (для других государств сочетание первых двух букв будет иное)

Настройка

Пакет conkyforecast имеет файл конфигурации, ~/.conkyForecast.config который должен иметь вид(при отсутствии необходимо создать):

gedit ~/.conkyForecast.config
#=============================================#
# EXPERT SETTINGS, NOT REQUIRED TO BE ALTERED #
#=============================================#
BASE_XOAP_URL = http://xml.weather.com/weather/local/<код_города>?cc=*&dayf=10&link=xoap&prod=xoap&key=<полученный_ключ>9&unit=m
MAXIMUM_DAYS_FORECAST = 4

#===============================================#
# USER SETTINGS, EDIT BASED ON DOCUMENTED SETUP #
#===============================================#
CACHE_FOLDERPATH = /tmp/
CONNECTION_TIMEOUT = 5
EXPIRY_MINUTES = 30
TIME_FORMAT = %H:%M
DATE_FORMAT = %Y-%m-%d
LOCALE = ru
XOAP_LICENCE_KEY = <полученный_ключ>
DEFAULT_LOCATION = <код_города>
AUTO_NIGHT = False
PROXY_HOST = 
PROXY_PORT = 8080
PROXY_USERNAME = 
PROXY_PASSWORD = 

ConkyForecast в работе использует шрифт ConkyWeather.ttf, поэтому его необходимо скачать и положить в папку ~/.fonts Пример файла конфигурации .conkyrc отображающий погоду при помощи conkyforecast

${font Ubuntu:pixelsize=24}Погода${font} ${hr 1}   
${execi 3600 conkyForecast --datatype=CO}/${execi 3600 conkyForecast --datatype=CN}
${execi 3600 conkyForecast --datatype=CC}| Ветер:${execi 3600 conkyForecast --datatype=WS}
${font Ubuntu:pixelsize=24}${execi 3600 conkyForecast --datatype=HT}${font}$alignc${font ConkyWeather:size=48}${execi 3600 conkyForecast --datatype=WF}${font}
${font ConkyWeather:size=36}${execi 3600 conkyForecast --startday=1 --endday=3 --spaces=4 --location=RSXX0063 --datatype=WF}${font}
$alignc${execi 3600 conkyForecast --startday=1 --endday=3 --spaces=25 --datatype=HT}
$alignc${execi 3600 conkyForecast --startday=1 --endday=3 --spaces=30 --datatype=DW}

Русификация

Ошибка (null) при выводе погоды

С версией пакета conky 1.8, находящегося на 27.08.2012 в репозитории возникает ошибка получения погоды через conkyForecast (вместо погоды отображается «null», когда время работы компьютера после включения меньше, чем интервал обновления погоды) данная проблема решается добавлением репозитория с conky версии 1.9 и обновление пакета

sudo add-apt-repository ppa:vincent-c/conky
sudo apt-get update && sudo apt-get upgrade

Проверка обновлений

Для проверки наличия обновления используется команда /usr/lib/update-notifier/update-motd-updates-available . Она проверяет обновившиеся списки пакетов, и, если есть изменения, запускает команду /usr/lib/update-notifier/apt-check с параметром –human-readable, без параметров просто отображается количество обычных/важных обновлений.

Строчка для conky:

Обновлений:${execi 3600 /usr/lib/update-notifier/apt-check 2>&1 | sed 's/;/ Важных:/'}

Известные проблемы и их решение

Conky при автозагрузке оказывается поверх всех окон

Для решения данной проблемы достаточно изменить команду запуска conky, добавив параметр -p - пауза перед запуском:

conky -p 10

В Conky запущенных из KDE черный фон

Для решения данной проблемы добавьте в свой .conkyrc следующее:

own_window yes
own_window_title conky
own_window_hints undecorated,below,sticky,skip_taskbar,skip_pager
own_window_argb_visual yes
own_window_argb_value 0
own_window_type normal 

Причем строчка

own_window_transparent

должна отсутствовать

Conky исчезает в процессе работы/дублируется

Исправляется скриптом подобного рода

#!/bin/bash
 
restart_conky(){
 killall conky
 # Можно добавлять conky с ключами
 # сколько потребуется, после этого 
 # требуется редактирование conkyd()
 conky -d &
}
 
conkyd(){
 #1 если нет ниодного процесса, перезапустить
 [ -z "$1" ] && restart_conky
 # 2 если есть второй или больше, убить все
 # и перезапустить коньки
 [ ! -z "$2" ] && restart_conky 
 sleep 5
}
 
while true
 do
  # pidof conky возращает pid всех процессов
  # у которых в имени содержится conky
  conkyd $(pidof conky)
 done
 
exit 0

Ссылки