Skip to content
Sly_tom_cat edited this page Jan 14, 2016 · 33 revisions

Welcome to the yandex-disk-indicator wiki!

Yandex.disk Indicator is python wrapper for yandex-disk CLI utility. It shows synchronization status in toolbar panel (within indicators plugin) and inform about synchronization status changes via desktop notification (notifications can be switched off). Indicator menu shows the Yandex-disk status and properties (total, used and available space) and list of last synchronized files. Raw output from 'yandex-disk status' call can be reviewed by click on current status. In settings you can tune indicator behavior and setting of yandex-disk daemon.

Initially it was developed partly based on code from grive-tools project created by Christiaan Diedericks (www.thefanclub.co.za). But now it is fully redesigned and rewritten within OOP model.

Yandex.disk Indicator supports all functionality of yandex-disk CLI utility.

It initially designed for Ubuntu Linux (with different DEs), but it was successfully installed on many other debian- and ubuntu-based distributions.

Last versions of Ubuntu deb packages available on LaunchPad PPA: https://launchpad.net/~slytomcat/+archive/ubuntu/ppa

Alternatively You can install Yandex-Disk Indicator manually from downloaded sources. Download last release, unzip it, and run build/install.sh script with root privileges.

Certainly you have to install yandex-disk CLI utility first.

DEB scripts will warn you if the CLI utility not installed before and it stop the Indicator installation. So, just go to Yandex support page and follow the instructions to install the CLI utility.

You can configure CLI utility in console or just run the Indicator and follow through the configuration (within GUI interface).

Interface languages: English, Russian, Greek

##Usage: yandex-disk-indicator [-l<n>]

Command line options:

-l<n> Set logging level to value <n>.

Logging level value can be:

  • 10 - to show all messages (DEBUG)
  • 20 - to show all messages except debugging messages (INFO)
  • 30 - to show all messages except debugging and info messages (WARNING) - default setting
  • 40 - to show only error and critical messages (ERROR)
  • 50 - to show critical messages only (CRITICAL)

##Developers notes:

This Git repository code assumes that:

  • yandex-disk-indicator.py is copied to /usr/bin/yandex-disk-indicator and marked as executable (chmod a+x ...)
  • fm-actions/ and icons/ folders, ya-setup files are located in /usr/share/yd-tools
  • *.desktop files should be placed in /usr/share/applications folder
  • compiled language files (translations/*.mo) are located in the system depended folders (i.e. usr/share/locale/{LANG}/LC_MESSAGES/ in Linux)
  • indicator settings are stored in ~/.config/yd-tools/yandex-disk-indicator.conf (file is automatically created on the first start).

The 'build' directory contains some useful scripts and settings for DEB package and DEB sources creation. install.sh script just copy all necessary files in to your system (without any package creation). Additional tools are required for building of DEB package: devscripts, debhelper and dput (if you want to upload package to launchpad PPA). Note that if you want to use scripts then you have to change the key ID (to your own) in build_deb.sh and make_source.changes.sh scripts.

Support

Don't hesitate to create an issue in case of any problem or question about the Yandex.Disk Indicator.

For getting debug information: run in the terminal: yandex-disk-indicator -l10 > logfile.log and attach the logging file to issue.