Общие принципы настройки

Опции командной строки

Все программы Emonoda (кроме хуков) поддерживают общий набор базовых опций:

  • -h, --help

    • Выводит краткую справку.
  • -c, --config <path/to/file>

    • Устанавливает путь к конфигурационному файлу, по умолчанию - ~/.config/emonoda.yaml.
  • -o, --set-options <sec/sub/opt=value ...>

    • Переопределяет параметры из конфига для единичного запуска команды. Вложенные ямловые ключи разделяются слешем, значение устанавливается после знака равенства. Можно передавать несколько параметров через пробел.
  • -m, --dump-config

    • Выводит дамп конфигурации в виде YAML с комментариями.

Конфигурационный файл

Вся система настраивается через единственный файл ~/.config/emonoda.yaml. Его содержимое делится на секции, в которых описываются одиночные ключи, списки или пары вида ключ-значение. Для описания параметров в рамках одной секции используется отступ из четырех или двух пробелов. Комментарий отделяется символом #. Например:

core:  # Корневая секция
    client: rtorrent  # Параметр client в секции core со значением rtorrent

trackers:  # Другая корневая секция
    rutor.org:  # Подсекция
        timeout: 5  # Параметр

Для обозначения подобных вложенных параметров в этой документации часто будет использоваться такая запись: core/client=rtorrent или trackers/rutor.org/timeout=5.0.

Этот же синтаксис используется для передачи значения параметров в опцию -o/--set-options: --set-options core/client=rtorrent trackers/rutor.org/timeout=5. Через знак равенства указываются значения по умолчанию; null, [] или {} обозначают отключенную функцию.


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

Команды emfile и emdiff могут работать с конфигурацией по умолчанию, однако для всех остальных утилит вам потребуется настроить интеграцию с клиентом, а также указать пути к каталогам с торрент-файлами и данными.

Конфигурация делится на несколько секций. Одна их часть является общими параметрами, другия же относятся непосредственно к каждой отдельной программе. Ниже приведен минимальный пример файла ~/.config/emonoda.yaml, содержащий простые настройки для торрент-клиента и трех трекеров. С такой конфигурацией вы сможете пользоваться всеми программами Emonoda. Трекеры необходимы только для emupdate.

core:
    torrents_dir: /home/user/torrents  # Каталог с торрент-файлами
    data_root_dir: /home/user/Downloads  # Каталог, куда скачиваются данные
    client: rtorrent  # Имя плагина для клиента

trackers:
    rutracker.org:
        user: yourlogin
        passwd: 12345

    nnm-club.me:
        user: yourlogin
        passwd: 12345

    tr.anidub.com:
        user: yourlogin
        passwd: 12345

Info

Полный список всех секций и параметров (в том числе и для выбранных плагинов) вы всегда можете посмотреть с помощью команды emfile -m. Параметры секции core и client действуют на все программы.

  • core/client=""

  • core/torrents_dir=.

    • Путь к каталогу, где лежат торрент-файлы.
  • core/use_colors=true

    • Параметр разрешает использование цветов при выводе на терминал.
  • core/force_colors=false

    • При использовании core/use_colors программа будет раскрашивать свой вывод, если он направлен в терминал. При перенаправлении в файл раскрашивание отключается, однако при core/force_colors=true вывод будет раскрашиваться всегда.
  • core/data_root_dir=~/Downloads

    • Корневой каталог с данными торрентов. В его подкаталоги emload загружает новые данные, а emfind индексирует их.
  • core/another_data_root_dirs=[]

    • Дополнительный список каталогов, где находятся уже загруженные ранее торренты. Этот параметр полезен, если до установки Emonoda и использования emload данные качались по разным путям. Он добавляет указанные каталоги для поиска с помощью emfind.
Секция Описание
core Общие параметры системы - имя плагина торрент-клиента, пути к каталогам, настройки вывода на терминал.
client Специфические параметры клиента. Содержимое секции зависит от используемого плагина, указанного в core/client. Подробнее смотрите на странице clients.
trackers Список трекеров с логинами и паролями, использующийся в emupdate, чтобы обновлять торренты. Подробнее смотрите на странице trackers.
confetti Список плагинов для отправки оповещений о результатах работы emupdate (например, по почте).
emupdate Специфические параметры emupdate.
emfile Специфические параметры emfile.
emfind Специфические параметры emfind.
emload Специфические параметры emload.