Skip to content

Latest commit

 

History

History
113 lines (69 loc) · 4.5 KB

README.md

File metadata and controls

113 lines (69 loc) · 4.5 KB

An application dock applet for the MATE panel

The applet works with both GTK2 and GTK3 versions of MATE and allows you to:

  • Place a dock on any MATE panel, of any size, on any side of the desktop you desire.
  • Pin and unpin apps to the dock
  • Rearrange application icons on the dock
  • Launch apps by clicking on their icons in the dock
  • Minimize/unminimize running app windows by clicking the app's dock icon
  • Detect changes in the current icon theme and update the dock accordingly
  • Use an indicator by each app to show when it is running
  • Optionally, use multiple indicators for each window an app has open
  • Use either a light or dark indicator that it can always be seen no matter what colour the panel is, or turn indicators off altogether
  • Change the colour of MATE panels to the dominant colour (i.e. the most common colour) of the desktop wallpaper. The colour can be applied to all panels or just the panel containing the dock.

Installation

Debian

The applet is available in Debian testing (currently GTK2 only):

apt-get install mate-dock-applet

Ubuntu MATE 16.04 and 16.10

The applet is included by default in Ubuntu MATE 16.04. It can be used by selecting the 'Mutiny' desktop layout in the MATE Tweak application, or by simply adding it to any panel.

Note: when upgrading from Ubuntu Mate 15.10 to 16.04 any previously installed version of the applet will be replaced with the one from the distribution's respositories.

Ubuntu MATE 15.10

Users of Ubuntu MATE 15.10 and earlier, or of Linux Mint, can install the applet from the PPA kindly provided by webupd8

Note: this is GTK2 only

Arch Linux

For Arch users there are two packages available in the AUR, a Gtk2 version of the applet, and a Gtk3 version.

Gentoo based distributions

An ebuild is available via the mate-de-gentoo

Other distributions

Users of other distros will need to install from source, so first install the required dependencies. Note, the package names below are for Ubuntu/Linux Mint/Debian - the name of the packages will vary on other distros.

  • Python3
  • Python wnck bindings (gir1.2-wnck-1.0 for Gtk2 versions of the applet, gir1.2-wnck-3.0 for Gtk3)
  • Python implementation of Xlib (python-xlib)
  • GLib development files (libglib2.0-dev)
  • Python Imaging Library (python3-pil)
  • Python 3 Cairo bindings (python3-cairo)

then cd to the directory containing all of the development files and run:

aclocal

automake --add-missing

autoreconf

To build a GTK2 version of the applet:

./configure --prefix=/usr

To build a GTK3 version:

./configure --prefix=/usr --with-gtk3

Then enter the following commands:

make

sudo make install

Installation on Ubuntu MATE on a Pi 2

This is a little more involved. First download gir1.2-wnck-1.0 for arm architechure from here and install it with sudo dpkg -i. Then install other dependencies - sudo apt-get install git autoreconf libglib2.0-dev

From this point the instructions above for compiling from source should be followed.

Note for Compiz Users

In order for window minimizing and maximizing to work correctly under Compiz, the Focus Prevention Level setting must be set to off in CompizConfig Settings Manager (General Options, Focus and Raise Behaviour)

Obligatory screen shots

V0.76 of the applet running on Ubuntu MATE 16.10, showing the new indicator style and active icon background. Note: the Gtk3 theme is Arc Darker (hence the blue indicators), and the icon theme is La Capitaine

New indicators and icon backgrounds

GTK3 version of the applet running on Ubuntu MATE 16.10 Alpha 1

GTK3 Ubunbtu Mate

Running on Arch with a Unity style layout

Arch screenshot

Running on Ubuntu with a Windows 7 style layout

Ubuntu screenshot

Running on a Raspberry Pi 2 with Ubuntu MATE

Pi2 screenshot