yd-go

Panel indicator for Yandex-disk CLI daemon (linux)

This version of indicator uses B-Bus for communication to the status notification plugin. Therefore it's fully independent of the desktop environment of Linux distribution.

IMPORTANT:

Indicator responsible only for showing the synchronization status in the desktop panel. All the synchronization operations are performed by yandex-disk utility from Yandex.

WIKI:

Russian wiki: https://github.com/slytomcat/yd-go/wiki

STORY:

I've made it as it is rather well-known task for me: I've made the similar indicator (GTK+ version) in YD-tools project in Python language. And when I started to learn golang the rewriting the indicator were rather obvious task to practice a new language. Initially there was two versions of golang indicators: for GTK+ and for QT. But later I've adopted new version of indicator library that uses D-Bus for organizing user interface.

DESCRIPTION:

Indicator shows current status by different icons in the status notification area. During synchronization the icon is animated. Indicator supports dark and light themes. The current theme can be changed via menu.

Desktop notifications inform user when daemon started/stopped or synchronization started/stopped. Notifications can be switched off.

The status notification icon has a menu that allows to:

• see the current daemon status and cloud-disk properties (Used/Total/Free/Trash)
• see paths of the last synchronized files and open them (in default program)
• start/stop daemon
• see the original output of daemon in the current user language
• open local synchronized path into the default file-manager
• open Yandex.Disk in the default browser
• open help/support page
• change the indicator settings (see "Theme", "Notifications", "StartDaemon" and "StopDaemon" settings below)

Application uses settings from the configuration file. The default path to configuration file is ~/.config/yd-go/default.cfg. The path can be changed by the -config application option. The file is in JSON format and it contain following options:

• "Conf" - Path to daemon config file (default "~/.config/yandex-disk/config.cfg").
• "Theme" - Icons theme name (default "dark", may be set to "dark" or "light"). This setting can be changed via indicator menu.
• "Notifications" - Display or not the desktop notifications (default true). This setting can be changed via indicator menu.
• "StartDaemon" - Flag that shows that the daemon should be started on app start (default true). This setting can be changed via indicator menu.
• "StopDaemon" - Flag that shows that the daemon should be stopped on app closure (default false). This setting can be changed via indicator menu.

Get

Download linux-amd64 binary from releases, copy it to path in PATH (/usr/local/bin for example) and make it executable.

OR

Get source from master branch and unzip it or just clone repository build it and install as described below.

Build

You must have Golang v1.24+ installed to build the binary. There is no additional libraries/packages required for building except the optional upx utility. Just jump into project directory and run:

./build.sh

When upx is available then the binary will be additionally compressed. If upx is not installed then the binary will be uncompressed and a warning appears abut it. You can use both compressed and not compressed binary, the only difference is the used space on disk for binary (not soo much in both cases).

Installation

Run

sudo cp yd-go /usr/local/bin/

Usage

	yd-go [-debug] [-config=<Path to indicator config>]

-config string
	Path to the indicator configuration file (default "~/.config/yd.go/default.cfg")
-debug
	Alow debugging messages to be sent to stderr
-version
	Print out version information and exit

NOTE: the yandex-disk CLI utility must be installed and configured before starting of the yd-go.

Icons

All the indicator icons are embedded into binary during the build time. But You can change them and rebuild the indicator. See more details about icons into icons/img/readme.md