Установка
Для установки необходимо поставить одноимённый пакет через 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_percents | Pad 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 включительно | |
| combine | var1 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 | |
| eval | string | Evaluates 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) | Задает шрифт для последующего текста. Использование без аргументов возвращает стандартный шрифт |
| goto | x | Следующий элемент будет выведен на позиции x |
| hr | (height) | Горизонтальная линия с указанной толщиной |
| image | <path to image> (-p x,y) (-s WxH) (-n) (-f interval) | Выводит указанное изображение используя Imlib2. -p меняет положение изображения -s меняет размер -n отключает кэширование -f задает интервал кэширования изображения |
| include | path | Загружает файл конфигурации, заменяет настройки оригинальной конфигурации и вставляет переменные в место, где указан $include |
| lua | function_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_graph | function_name (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) | Выполняет lua-функцию и выводит график на основе возвращаемого значения. Результатом выполнения функции может быть любое число, график масштабируется для отображения всего диапазона значений |
| lua_parse | function_name (function parameters) | Выполняет lua-функцию с заданными параметрами так же, как и $lua, но затем обрабатывает результат как часть секции TEXT |
| offset | (pixels) | Изменяет горизонтальное смещение текста. Возможны отрицательные значения. Смотри так же $offset. |
| outlinecolor | (color) | Change outline color |
| scroll | length (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_bytes | size | Если 'size' - число с указанными единицами (kilobyte,mb,GiB,…), тогда оно конвертируется в байты и выводится, иначе просто выводится как есть. |
| updates | Количество обновлений окна. Для отладки | |
| voffset | (pixels) | Изменяет вертикальное смещение текста. Возможны отрицательные значения. Смотри так же $offset. |
Работа с файлами и дисками
| Переменная | Параметр | Описание |
|---|---|---|
| disk_protect | device | Статус защиты диска, если эта функция поддерживается (требуется патч для ядра) Выводит «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' включает температурный градиент, который меняется в зависимости от значений |
| exec | command | Выполняет команду оболочки и отображает результат в conky. Используйте двойные кавычки для комманд с пробелами. Внимание: эта переменная потребляет довольно много ресурсов |
| execbar | command | То же, что и $exec, но если результат - число от 0 до 100, то выводит бар. Размеры задаются через настройку default_bar_size. |
| execgauge | command | То же, что и $exec, но если результат - число от 0 до 100, то выводит круглый датчик. Размеры задаются через настройку default_gauge_size. |
| execgraph | (-t) (-l) command | То же, что и $execbar, но выводит график. |
| execi | interval command | То же, что и $exec, но с заданным интервалом выполнения. Интервал не может быть меньше update_interval |
| execibar | interval command | То же, что и $execbar, но с заданным интервалом выполнения. |
| execigauge | interval command | То же, что и $execgauge, но с заданным интервалом выполнения. |
| execigraph | interval (-t) (-l) command | То же, что и $execgraph, но с заданным интервалом выполнения. |
| execp | command | То же, что и $exec, но результат обрабатывается как текст после TEXT |
| execpi | interval 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) | Процент использования места |
| head | logfile lines (next_check) | Показывает первые N строк указанного файла. Файл проверяется через каждое 'next_check' обновление (по умолчанию 2) Максимум 30 строк может быть показано |
| iconv_start | codeset_from codeset_to | Конвертирует текст из одной кодировки в другую используя GNU iconv. Необходима остановка с помощью $iconv_stop |
| iconv_stop | Останавливает конвертирование текста | |
| ioscheduler | disk | Prints the current ioscheduler used for the given disk name (i.e. e.g. «hda» or «sdb») |
| lines | textfile | Показывает количество строк в указанном файле |
| pre_exec | shell command | Executes a shell command one time before conky displays anything and puts output as text. |
| tail | logfile lines (next_check) | Показывает последние N строк указанного файла. Файл проверяется через каждое 'next_check' обновление (по умолчанию 2) Максимум 30 строк может быть показано |
| texeci | interval command | То же, что и $execi, но команда выполняется внутри потока. Используйте это, если у вас «тяжелый» скрипт. Поставьте интервал выполнения чуть больше, чем выполняется ваш скрипт |
| words | textfile | Выводит количество слов в данном файле |
Работа с процессами
| Переменная | Параметр | Описание |
|---|---|---|
| cmdline_to_pid | string | PID первого процесса, содержащего строку |
| pid_chroot | pid | Директория, используемая процессом как корень. Будет '/' пока процесс не сделает системный вызов 'chroot' |
| pid_cmdline | pid | Командна, вызвавшая данный процесс |
| pid_cwd | pid | Текущий рабочий каталог процесса |
| pid_environ | pid varname | Contents of a environment-var of the process |
| pid_environ_list | pid | List of environment-vars that the process can see |
| pid_exe | pid | Path to executed command that started the process |
| pid_nice | pid | The nice value of the process |
| pid_openfiles | pid | Список открытых процессом файлов |
| pid_parent | pid | Pid родительского процесса |
| pid_priority | pid | Приоритет процесса |
| pid_read | pid | Количество байт прочитанных процессом |
| pid_state | pid | Состояние процесса |
| pid_state_short | pid | Одна буква из «RSDZTW», отображающая состояние процесса |
| pid_stderr | pid | Filedescriptor binded to the STDERR of the process |
| pid_stdin | pid | Filedescriptor binded to the STDIN of the process |
| pid_stdout | pid | Filedescriptor binded to the STDOUT of the process |
| pid_threads | pid | Number of threads in process containing this thread |
| pid_thread_list | pid | List with pid's from threads from this process |
| pid_time_kernelmode | pid | Amount of time that the process has been scheduled in kernel mode in seconds |
| pid_time_usermode | pid | Amount of time that the process has been scheduled in user mode in seconds |
| pid_time | pid | Sum of $pid_time_kernelmode and $pid_time_usermode |
| pid_uid | pid | The real uid of the process |
| pid_euid | pid | The effective uid of the process |
| pid_suid | pid | The saved set uid of the process |
| pid_fsuid | pid | The file system uid of the process |
| pid_gid | pid | The real gid of the process |
| pid_egid | pid | The effective gid of the process |
| pid_sgid | pid | The saved set gid of the process |
| pid_fsgid | pid | The file system gid of the process |
| pid_vmpeak | pid | Peak virtual memory size of the process |
| pid_vmsize | pid | Virtual memory size of the process |
| pid_vmlck | pid | Locked memory size of the process |
| pid_vmhwm | pid | Peak resident set size («high water mark») of the process |
| pid_vmrss | pid | Resident set size of the process |
| pid_vmdata | pid | Data segment size of the process |
| pid_vmstk | pid | Stack segment size of the process |
| pid_vmexe | pid | Text segment size of the process |
| pid_vmlib | pid | Shared library code size of the process |
| pid_vmpte | pid | Page table entries size of the process |
| pid_write | pid | Количество байт записанных процессом |
| processes | Всего процессов (спящих и запущенных) | |
| running_processes | Запущенных процессов (не спящих), требуется ядро 2.6+ | |
| running_threads | Количество запущенных потоков. Только для Linux | |
| threads | Всего потоков | |
| top | type num | This 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_io | type num | Same as top, except sorted by the amount of I/O the process has done during the update interval |
| top_mem | type num | Same as top, except sorted by mem usage instead of cpu |
| top_time | type num | Same 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) port | Connects to a tcp port on a host (default is localhost), reads every char available at the moment and shows them. |
| tcp_portmon | port_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) |
Получение данных из интернета
| Переменная | Параметр | Описание |
|---|---|---|
| curl | url (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 |
| eve | api_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) mbox | Print 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. |
| rss | uri 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. |
| weather | URI 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_forecast | URI 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 | Album of the current MOC song | |
| moc_artist | Artist of the current MOC song | |
| moc_bitrate | Bitrate in the current MOC song | |
| moc_curtime | Current time of the current MOC song | |
| moc_file | File name of the current MOC song | |
| moc_rate | Rate of the current MOC song | |
| moc_song | The current song name being played in MOC. | |
| moc_state | Current state of MOC; playing, stopped etc. | |
| moc_timeleft | Time left in the current MOC song | |
| moc_title | Title of the current MOC song | |
| moc_totaltime | Total length of the current MOC song | |
| mpd_album | Album in current MPD song | |
| mpd_artist | Artist in current MPD song must be enabled at compile | |
| mpd_bar | (height),(width) | Bar of mpd's progress |
| mpd_bitrate | Bitrate of current song | |
| mpd_elapsed | Song's elapsed time | |
| mpd_file | Prints the file name of the current MPD song | |
| mpd_length | Song's length | |
| mpd_name | Prints the MPD name field | |
| mpd_percent | Percent of song's progress | |
| mpd_random | Random status (On/Off) | |
| mpd_repeat | Repeat 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_status | Playing, stopped, et cetera. | |
| mpd_title | (max length) | Title of current MPD song |
| mpd_track | Prints the MPD track field | |
| mpd_vol | MPD's volume | |
| xmms2_album | Альбом текущего трека | |
| xmms2_artist | Исполнитель текущего трека | |
| xmms2_bar | (height),(width) | Бар текущего трека |
| xmms2_bitrate | Битрейт текущего трека | |
| xmms2_comment | Коментарий к текущему треку | |
| xmms2_date | Возвращает дату ткущего трека | |
| xmms2_duration | Продолжительность трека | |
| xmms2_elapsed | Song's elapsed time | |
| 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 | |
| apcupsd | host | Устанавливает адрес подключения к демону 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_temps | N | If 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) | 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_mode | The value of /proc/sys/vm/laptop_mode | |
| machine | Machine, i686 for example | |
| nvidia | threshold | Nvidia 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_battery | item | If 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_power | INDEX | when 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_temp | INDEX | when 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 | Displays the Sony VAIO fanspeed information if sony-laptop kernel support is enabled. Linux only. | |
| voltage_mv | (n) | Возвращает напряжение на n-ном процессоре в мВ. Без параметра возвращает для первого |
| voltage_v | (n) | Возвращает напряжение на n-ном процессоре в В. Без параметра возвращает для первого |
Работа с if
| Переменная | Параметр | Описание |
|---|---|---|
| else | Text 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_existing | file (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_match | expression | Evaluates 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_time | seconds format | Format 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 | Kernel 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 |
| memeasyfree | Amount of free memory including the memory that is very easily freed (buffers/cache) | |
| memfree | Amount 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 | % используемой (занятой) оперативной памяти | |
| monitor | Number of the monitor on which conky is running or the message «Not running in X» if this is the case. | |
| monitor_number | Number 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_name | gid | Имя группы с данным gid |
| uid_name | uid | Имя пользователя с данным uid |
| uptime | Аптайм | |
| uptime_short | Аптайм короткой строкой | |
| user_names | Список имен залогиненных пользователей | |
| user_number | Количество залогиненых пользователей | |
| user_terms | Список используемых консолей | |
| user_times | Сколько времени пользователь залогинен | |
| user_time | console | Сколько времени пользователь залогинен в указанной консоли |
| 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
Комментариев нет:
Отправить комментарий