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

Команды

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

token — получить ключ авторизации (OAuth-токен) для вашего логина на Яндексе.
При вводе команды вы можете задать имя файла для хранения токена и путь к нему (FILE). Если дополнительные параметры не будут указаны, для хранения токена будет создан файл passwd в каталоге ~/.config/yandex-disk.
```
$ yandex-disk token [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 или закрыв текущую консоль.

Если используется этот параметр, приложение не читает файл конфигурации. Поэтому все необходимые настройки нужно вводить через командную строку. Так, параметру exclude-dirs соответствует аргумент --exclude-dirs.

$ yandex-disk --no-daemon --dir=/root/Yandex.Disk --exclude-dirs=DO_NOT_SYNC,temp

Примечание. При использовании --no-daemon не нужно указывать команду start: в этом режиме все команды игнорируются.

--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