Skip to content
Sly_tom_cat edited this page Feb 22, 2016 · 33 revisions

Welcome to the yandex-disk-indicator wiki!

Screenshot

Yandex.disk Indicator is python wrapper for yandex-disk CLI utility. It shows synchronization status in desktop 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 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 installation script 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 supported: English, Russian, Greek, Bulgarian.

##Usage: yandex-disk-indicator.py [-l {10,20,30,40,50}] [-c path] [-r path] [-h] [-v]

Options:
  -l {10,20,30,40,50}, --log {10,20,30,40,50}
                    Sets the logging level: 
                     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),
                     40 - to show only error and critical messages (ERROR),
                     50 - to show critical messages only (CRITICAL). 
                    Default: 30
  -c path, --config path
                    Path to configuration file of YandexDisk daemon.Daemon
                    This daemon will be added to daemons list if it is
                    not in the current configuration. Default: ''
  -r path, --remove path
                    Path to configuration file of daemon that should be
                    removed from daemos list. Default: ''

  -h, --help        Show this help message and exit
  -v, --version     Print version and exit

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