воскресенье, 29 сентября 2013 г.

Подробнее о Conky

Установка

Для установки необходимо поставить одноимённый пакет через 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)Change outline 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_ifaceDisplays the default route's interface or «multiple»/«none» accordingly.
gw_ipDisplays 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.
nodenameHostname
nodename_shortShort 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_uriURI текущего трека
moc_albumAlbum of the current MOC song
moc_artistArtist of the current MOC song
moc_bitrateBitrate in the current MOC song
moc_curtimeCurrent time of the current MOC song
moc_fileFile name of the current MOC song
moc_rateRate of the current MOC song
moc_songThe current song name being played in MOC.
moc_stateCurrent state of MOC; playing, stopped etc.
moc_timeleftTime left in the current MOC song
moc_titleTitle of the current MOC song
moc_totaltimeTotal length of the current MOC song
mpd_albumAlbum in current MPD song
mpd_artistArtist in current MPD song must be enabled at compile
mpd_bar(height),(width)Bar of mpd's progress
mpd_bitrateBitrate of current song
mpd_elapsedSong's elapsed time
mpd_filePrints the file name of the current MPD song
mpd_lengthSong's length
mpd_namePrints the MPD name field
mpd_percentPercent of song's progress
mpd_randomRandom status (On/Off)
mpd_repeatRepeat status (On/Off)
mpd_smart(max length)Prints the song name in either the form «artist - title» or file name, depending on whats available
mpd_statusPlaying, stopped, et cetera.
mpd_title(max length)Title of current MPD song
mpd_trackPrints the MPD track field
mpd_volMPD's volume
xmms2_albumАльбом текущего трека
xmms2_artistИсполнитель текущего трека
xmms2_bar(height),(width)Бар текущего трека
xmms2_bitrateБитрейт текущего трека
xmms2_commentКоментарий к текущему треку
xmms2_dateВозвращает дату ткущего трека
xmms2_durationПродолжительность трека
xmms2_elapsedSong's elapsed time
xmms2_genreЖанр
xmms2_idXMMS2 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_statusIf 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_biosIf running the i8k kernel driver for Inspiron laptops, displays the bios version as listed in /proc/i8k.
i8k_buttons_statusIf running the i8k kernel driver for Inspiron laptops, displays the volume buttons status as listed in /proc/i8k.
i8k_cpu_tempIf running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in Celsius, as reported by /proc/i8k.
i8k_left_fan_rpmIf 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_statusIf 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_rpmIf 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_statusIf 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_serialIf running the i8k kernel driver for Inspiron laptops, displays your laptop serial number as listed in /proc/i8k.
i8k_versionIf running the i8k kernel driver for Inspiron laptops, displays the version formatting of /proc/i8k.
ibm_brightnessIf running the IBM ACPI, displays the brigtness of the laptops's LCD (0-7).
ibm_fanIf 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_volumeIf running the IBM ACPI, displays the «master» volume, controlled by the volume keys (0-14).
freq(n)Returns CPU #n's frequency in MHz. CPUs are counted from 1. If omitted, the parameter defaults to 1.
freq_g(n)Returns CPU #n's frequency in GHz. CPUs are counted from 1. If omitted, the parameter defaults to 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_modeThe value of /proc/sys/vm/laptop_mode
machineMachine, i686 for example
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_batteryitemIf running on Apple powerbook/ibook, display information on battery status. 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_fanspeedDisplays the Sony VAIO fanspeed information if sony-laptop kernel support is enabled. Linux only.
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_gwif 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_playingif 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_connectedDisplay 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)
kernelKernel version
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)Bar that shows amount of memory in use
memeasyfreeAmount of free memory including the memory that is very easily freed (buffers/cache)
memfreeAmount of free memory
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% используемой (занятой) оперативной памяти
monitorNumber of the monitor on which conky is running or the message «Not running in X» if this is the case.
monitor_numberNumber of monitors or the message «Not running in X» if this is the case.
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

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

Conky мерцает

Только для Ubuntu 8.04 и более старых версий
Для того что бы решить проблему «мерцания» conky правим файл xorg.conf
sudo gedit /etc/X11/xorg.conf
Находим секцию “Modules” добавляем следующую строчку
Load “dbe”
а также в ~/.conkyrc
double_buffer yes
Сохраняем, закрываем. Перезагружаем X-Window (Ctrl+Alt+Backspace) и запускаем conky.
Если пользуетесь compiz, то в «general options» надо снять галочку в пункте «hide skip taskbar windows» и в ~/.conkyrc установить параметр
own_window_type normal
В этом случае conky остаются на рабочем столе при сворачивании окон.

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

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

Комментариев нет:

Отправить комментарий