Пакет yd-tools в формате DEB — это набор индикаторов для консольного клиента Яндекс.Диска в Linux: он добавляет значок в системный трей, показывает статус синхронизации и позволяет управлять демоном yandex-disk без командной строки. Если после установки пакета значок не появляется, а команда yandex-disk-indicator выдаёт ошибку, причина чаще всего в отсутствии самого консольного клиента или несовместимости с окружением рабочего стола.
В этой статье разберём, что входит в состав yd-tools, как корректно установить DEB-пакет на Debian, Ubuntu и производных системах, какие зависимости нужны и как диагностировать типичные ошибки запуска.
Что входит в состав yd-tools
Проект yd-tools — это набор утилит с графическим интерфейсом, написанных на Python и использующих библиотеки GTK. Пакет не заменяет консольный клиент Яндекс.Диска, а работает поверх него: все операции синхронизации выполняет демон yandex-disk, а индикатор лишь отображает его состояние и передаёт команды.
В состав набора обычно входят два компонента:
- 🖥️ yandex-disk-indicator — значок в трее с меню управления: запуск и остановка синхронизации, открытие папки диска, просмотр последних изменённых файлов.
- ⚙️ yandex-disk-setup — графический мастер первоначальной настройки: выбор папки синхронизации, авторизация, исключение каталогов.
- 🔔 Уведомления рабочего стола о завершении синхронизации и конфликтах файлов (если поддерживаются окружением).
- 🌍 Локализации интерфейса, включая русский язык.
Важно понимать: индикатор — сторонняя разработка сообщества, а не официальный продукт Яндекса. Официальным является только консольный клиент yandex-disk, который распространяется через репозиторий Яндекса.
Установка консольного клиента — обязательный первый шаг
Перед установкой DEB-пакета yd-tools необходимо поставить сам клиент Яндекс.Диска, иначе индикатору нечем будет управлять. Яндекс поддерживает собственный репозиторий для Debian-подобных систем. Подключение выполняется стандартными средствами пакетного менеджера: добавляется источник и ключ репозитория, после чего клиент ставится командой apt install yandex-disk.
Точные адреса репозитория и команды подключения периодически меняются, поэтому актуальную инструкцию стоит брать на официальной странице Яндекс.Диска для Linux. После установки проверьте работоспособность клиента:
yandex-disk --versionЕсли команда возвращает версию, можно запустить мастер настройки yandex-disk setup и пройти авторизацию. Только после того, как консольная синхронизация заработала, имеет смысл ставить индикатор.
⚠️ Внимание: не устанавливайте yd-tools, пока консольный клиент не настроен и не выполнил хотя бы одну успешную синхронизацию. Индикатор при отсутствии конфигурации демона может запускаться с пустым меню или сразу завершаться, что затрудняет диагностику.
Установка DEB-пакета yd-tools
Существует два пути: установка из PPA-репозитория (для Ubuntu и производных) или ручная установка скачанного DEB-файла. Вариант с репозиторием предпочтительнее, так как обновления будут приходить автоматически вместе с системными.
Для ручной установки скачанного пакета используйте apt, а не dpkg напрямую — так автоматически подтянутся зависимости:
sudo apt install ./yd-tools_*.debЕсли вы всё же установили через dpkg -i и получили ошибку зависимостей, исправить ситуацию поможет команда:
sudo apt --fix-broken install☑️ Проверка перед установкой yd-tools
После установки индикатор запускается командой yandex-disk-indicator или из меню приложений. Для автозапуска при входе в систему добавьте его в автозагрузку вашего окружения рабочего стола — во многих сборках пакет создаёт соответствующий desktop-файл автоматически.
Зависимости и совместимость с окружениями рабочего стола
Пакет требует наличия в системе Python 3 и графических библиотек GTK с привязками для Python, а также библиотеки индикаторов приложений (AppIndicator). При установке через apt всё это подтягивается автоматически, но при ручной распаковке пакета или в минимальных сборках системы зависимостей может не хватать.
Поведение индикатора заметно зависит от окружения рабочего стола:
| Окружение | Отображение значка | Что проверить |
|---|---|---|
| GNOME (современные версии) | Требуется расширение AppIndicator | Установлено ли расширение трея |
| KDE Plasma | Обычно работает из коробки | Статус-нотификатор включён в трее |
| XFCE | Работает через плагин Status Tray / Indicator | Наличие плагина на панели |
| Cinnamon | Обычно работает | Апплет системного лотка активен |
| MATE | Работает через Indicator Applet | Апплет добавлен на панель |
Если индикатор запущен (процесс виден в диспетчере задач), но значка нет — проблема почти наверняка в отображении трея, а не в самом пакете.
Типичные ошибки и их диагностика
Запустите индикатор из терминала — так вы увидите сообщения об ошибках, которые скрыты при запуске из меню. Это первое действие при любой проблеме.
Разберём частые сценарии. Ошибка импорта модулей Python указывает на отсутствие зависимостей: установите недостающие пакеты через apt, ориентируясь на имя модуля в тексте ошибки. Пустое меню или статус «не запущен» при работающем демоне чаще всего означает, что индикатор не может прочитать конфигурацию клиента — проверьте, что файл конфигурации существует в домашнем каталоге пользователя, под которым запущен индикатор, а не под root.
⚠️ Внимание: не запускайте индикатор и демон синхронизации через
sudo. Это создаст файлы конфигурации и кэш с владельцем root в домашнем каталоге, после чего обычный запуск начнёт падать с ошибками доступа. Если это уже произошло, верните владельца файлов конфигурации текущему пользователю.
Ещё одна возможная причина проблем — конфликт версий после обновления системы, когда пакет yd-tools собран под другую версию Python. В этом случае помогает переустановка пакета из репозитория, соответствующего текущему выпуску дистрибутива.
Как проверить, что демон синхронизации работает
Выполните в терминале команду yandex-disk status. Если клиент настроен и запущен, вы увидите статус синхронизации, объём диска и список последних операций. Если выводится сообщение о том, что демон не запущен, выполните yandex-disk start и повторите проверку. Индикатор отображает именно эту информацию, поэтому при ошибках в выводе status сначала решайте проблему консольного клиента.
Обновление и удаление пакета
При установке через репозиторий yd-tools обновляется вместе с системой штатной командой sudo apt update && sudo apt upgrade. При ручной установке из DEB-файла обновление выполняется повторной установкой новой версии пакета поверх старой — конфигурация индикатора при этом сохраняется.
Удаление выполняется стандартно:
sudo apt remove yd-toolsКоманда apt purge дополнительно удалит системные конфигурационные файлы пакета, но пользовательские настройки в домашнем каталоге обычно остаются — при необходимости их можно удалить вручную. Учтите, что удаление yd-tools не затрагивает консольный клиент yandex-disk и папку синхронизации: ваши файлы останутся на месте.
Часто задаваемые вопросы
Работает ли yd-tools без консольного клиента Яндекс.Диска?
Нет. Пакет является лишь графическим интерфейсом к демону yandex-disk. Без установленного и настроенного консольного клиента индикатор не сможет ни отобразить статус, ни управлять синхронизацией.
Можно ли установить DEB-пакет на Fedora или Arch?
DEB-пакеты предназначены для Debian, Ubuntu и производных систем. Для дистрибутивов с другими пакетными форматами нужно искать сборку под свой дистрибутив или устанавливать проект из исходного кода с учётом его зависимостей.
Почему значок индикатора не виден после установки?
Наиболее вероятные причины: отсутствие поддержки трея в окружении рабочего стола (в GNOME нужно расширение AppIndicator), индикатор просто не запущен либо демон синхронизации не настроен. Запустите yandex-disk-indicator из терминала и проверьте вывод на наличие ошибок.
Безопасно ли использовать сторонний индикатор с аккаунтом Яндекса?
Индикатор не обрабатывает пароль самостоятельно: авторизация происходит через штатный механизм консольного клиента с токеном. Тем не менее пакет является проектом сообщества, поэтому устанавливайте его только из известных репозиториев и проверяйте источник перед установкой.
Что делать, если после обновления системы индикатор перестал запускаться?
Запустите его из терминала и посмотрите текст ошибки. Часто помогает переустановка пакета версии, собранной под текущий выпуск дистрибутива, либо установка недостающих зависимостей Python. Если ошибка указывает на конкретный модуль, установите соответствующий системный пакет через apt.