WhaleWatcher

WhaleWatcher is a native Linux Docker desktop client built in Vala and GTK for elementary OS.

Install from Source

You can install WhaleWatcher by compiling from source. Here's the list of
dependencies required:

granite (>= 0.6.0)
debhelper (>= 10.5.1)
gettext
libgtk-3-dev (>= 3.10)
meson
valac (>= 0.28.0)

An install-dev-dependencies.sh script is available to help developers get up and running.

Building and Running

$ meson build --prefix=/usr
$ sudo ninja -C build install
$ com.github.avojak.whalewatcher

Flatpak

To test the Flatpak build with Flatpak Builder:

$ flatpak-builder build com.github.avojak.whalewatcher.yml --user --install --force-clean
$ flatpak run --env=G_MESSAGES_DEBUG=all com.github.avojak.whalewatcher

Development Build

You can also install a development build alongside a stable version by specifying the dev profile:

$ meson build --prefix=/usr -Dprofile=dev
$ sudo ninja -C build install
$ G_MESSAGES_DEBUG=all com.github.avojak.whalewatcher-dev

Updating Translations

When new translatable strings are added, ensure that po/POTFILES contains a
reference to the file with the translatable string.

Update the .pot file which contains the translatable strings:

$ ninja -C build com.github.avojak.whalewatcher-pot

Generate translations for the languages listed in the po/LINGUAS files:

$ ninja -C build com.github.avojak.whalewatcher-update-po

Debugging

To test executing REST requests against the Docker engine manually, you can use curl:

$ curl --unix-socket /var/run/docker.sock -X GET "http:/v1.41/images/json"

To view all events:

$ curl --unix-socket /var/run/docker.sock -X GET "http:/v1.41/events"

To import an image:

$ curl --unix-socket /var/run/docker.sock -X POST -H "Content-Type: application/x-tar" --data-binary "@/path/to/file.tar" "http:/v1.41/images/load"

avojak/whalewatcher