Команды и параметры

Команды

Для работы с клиентом используются следующие команды:

  • token — получить ключ авторизации (OAuth-токен) для вашего логина на Яндексе (USERNAME). При вводе команды вы можете указать ваш пароль на Яндексе (PASSWORD) и задать имя файла для хранения токена и путь к нему (FILE). Если дополнительные параметры не будут указаны, для хранения токена будет создан файл passwd в каталоге ~/.config/yandex-disk.
    $ yandex-disk token [-p, --password=PASSWORD] [OPTION] USERNAME [FILE]
  • start — запустить демон и синхронизировать все папки, кроме указанных в списке исключений exclude-dirs.
    $ yandex-disk start [OPTION]
  • status — отобразить статус работы демона (состояние синхронизации, ошибки синхронизации, список синхронизированных файлов, общее и свободное пространство на Диске).
    $ yandex-disk status [OPTION]
  • stop — остановить работу демона.
    $ yandex-disk stop [OPTION]
  • sync — синхронизировать все папки, кроме указанных в списке исключений exclude-dirs.
    $ yandex-disk sync [OPTION]
  • publish — получить публичную ссылку на указанный файл или папку (FILE).
    $ yandex-disk publish [OPTION] FILE
  • unpublish — отменить публикацию для указанного файла или папки (FILE).
    $ yandex-disk unpublish FILE

Дополнительные параметры [OPTION]

--config=FILE, -c FILE

Указать файл конфигурации. По умолчанию используется файл config.cfg в каталоге ~/.config/yandex-disk.

--dir=DIR, -d DIR

Указать каталог для хранения локальной копии Диска. Если его название не было задано при выполнении начальной настройки, по умолчанию будет использоваться каталог ~/Yandex.Disk.

--auth=FILE, -a FILE

Указать файл с данными авторизации. По умолчанию используется файл passwd, который создается с помощью команды token или мастера начальной настройки и хранится в каталоге ~/.config/yandex-disk.

--exclude-dirs=DIR1,DIR2,...

Не синхронизировать указанные каталоги. Чтобы настройка действовала всегда, каталоги необходимо добавить в список исключений exclude-dirs в файле config.cfg. Чтобы настройка действовала корректно, названия исключаемых директорий нужно перечислять через запятую, без пробелов.

--read-only

Запретить изменение файлов на сервере Диска и выполнить синхронизацию только в локальной копии. При возникновении конфликтов синхронизации локальные файлы будут переименованы. Если дополнительно указан параметр --overwrite, локальные файлы будут перезаписаны.

--overwrite

При синхронизации с сервером разрешить перезапись изменений, сделанных в локальной копии Диска. Используется вместе с параметром --read-only.

--no-daemon, -D

Запустить демон без возврата управления в консоль. Чтобы вернуть управление, демон необходимо остановить, запустив в другой консоли команду yandex-disk stop или закрыв текущую консоль.

--help, -h

Вывести справку.

--proxy=PARAM

Настроить прокси-сервер. Допустимые параметры:

  • auto — использовать системные настройки прокси-сервера (используется по умолчанию);
  • no — не использовать прокси-сервер;
  • protocol,address,port,login,password — настроить вручную.

Примеры использования команд

$ yandex-disk start -c ~/ydconfig/newconfig.cfg # запустить демон и синхронизацию с указанным файлом конфигурации 
$ yandex-disk start --exclude-dirs=Foto # не синхронизировать папку Foto
$ yandex-disk sync --read-only # синхронизировать папки в режиме read-only
$ yandex-disk publish Foto # получить публичную ссылку на папку Foto