MATE

MATE (pronounced to rhyme with latte, not late) is a fork of the GNOME 2 desktop environment that is available through Portage. According to the MATE team's manifesto, they aim to keep a traditional desktop look and feel, maintain an open development model, have an open relationship with GNU/Linux distributions, and serve as a good alternative for lower-end hardware.

Keywording
MATE is available for and. As of October 2017, testing versions are available for. Adding support for is being considered. The status of MATE keywording can be tracked in.

USE flags
First enable or disable desired USE flags for.

Packages
To install the MATE desktop environment meta package run the following command:

Caja File Extensions
To install Caja extensions run the following command:

Caja extensions include the following:


 * : Open terminals in arbitrary local paths
 * : Integrate email clients and Pidgin into the Caja file manager
 * : Mass resize or rotate images
 * : Quickly share a folder from the Caja file manager

Usage
Either a display manager (SLiM, GDM, LightDM, etc.) or the startx command can be used to start MATE during system the system boot process.

Display manager (DM)
To make the display manager work specify a MATE session (mate-session) in the configuration of the display manager; some perform this action interactively, others will need to have a configuration file modified. The default session can also often be changed by setting  in :

The MATE team recommends LightDM as the display manager. Install :

OpenRC
Set LightDM as the default display manager:

To start LightDM on boot, add dbus & xdm to the default runlevel:

To start LightDM now:

systemd
To start LightDM on boot:

To start LightDM now:

Manual start
To start MATE manually create a file in a user's home directory. Make its contents as follows:

Note that a and/or  may be needed between  for ConsoleKit and/or DBUS communication to work, for example:

Compositing
Compositing is not enabled by default. To enable compositing run and click the tick box alongside Enable software compositing window manager in the  tab.

Window centering
Window centering is not enabled by default. To enable window centering run and click the tick box alongside Center new windows in the  tab.

Window snapping
Window snapping is not enabled by default. To enable window snapping run and click on the tick box alongside Enable side by side tiling in the  tab.

Change applications menu icon
The applications menu icon is set to by default. To use a different icon, copy your icon to a folder such as and execute the following:

Where  is the name of the icon without the file extension. Restart MATE panel.

Show or hide desktop icons
Desktop icons are enabled by default. They can be hidden or shown individually using.

Hide individual icons
To hide the computer icon:

To hide the user directory icon:

To hide the network icon:

To hide the trash icon:

To hide mounted volumes:

Alternatively, may be used to show or hide desktop icons. Navigate to.

Applications
This is a list of GNOME 2 applications that have been renamed and included in the MATE desktop environment.

Applets
This is a list of GNOME 2 panel applets that have been renamed and included in the MATE desktop environment.

Autostart
MATE is capable of automatically running binaries or scripts on a per-user basis.

Autostart entries can be added via.

From the command-line, entries can be added in the directory as XDG formatted  files. Be sure to include a line that says. For example:

Does MATE rely on a specific service manager or init system?
No, MATE has been tested to work with both OpenRC and systemd and might work on other service managers and init systems too (untested, but no known reason for it to break); systemd support was added in release 1.6.

Can MATE be installed side-by-side GNOME packages or do they block?
As the MATE packages use their own categories, it is possible to have MATE and GNOME 3 installed at the same time which allows you to test either; taking it even a step further, if you change MATE to not have a top panel (as it gets hidden under the GNOME 3 shell) you can even start mate-session within GNOME 3 and run MATE and GNOME 3 at the same time.

How do I enable the panel shadow?
Due to a race condition, the panel shadow does not appear after logging in to the MATE desktop, even with compositing enabled. You must first copy to. Then set to, and add a delay:

You may need to adjust the delay as needed. Finally, restart Marco with the following command:

Using MATE with dual screens
When using MATE desktop with multiple screens, it must be emerged with the  USE flag enabled. Specifically, the window manager that is powering mate-desktop, which is. This will solve issues like windows being maximized over both screens in MATE desktop.

Using MATE with Android phones
To connect Android devices and open them in you need to compile  with the   USE flag.

Can I replace the default screen-shot tool with X?
is provided in provides basic screenshot capabilities. If you don't like it and need a more advanced tool, like you can replace the default behavior of the  button by editing the following configurations option with dconf-edtior:

If you feel comfortable doing this with the command line you can do:

or with:

Suspend and Hibernate buttons are missing from the shutdown dialog
If only "Restart Cancel Shutdown" buttons appear in the dialog, make sure you compile with upower enabled,  with pm-utils flag.

Removal
To remove all packages with the name MATE ( required):

GLib-GObject-ERROR: object GsmAutostartApp 0x73ca40 finalized while still in-construction
When you get this error (see ), it is usually preceded by a warning, fixing the warning could fix the problem; for example, when I get to see:

In this case, you can resolve this by moving away the desktop file or fixing it up by adding the Name key. If you want a clean start, you can move those files out of the way by backing them up:

Failure to emerge due to conflicts with x11-libs/gtk+:3 and x11-themes/mate-themes{,-meta}
Unfortunately, due to some packaging requirements, there is the potential for users to have an issue with proper dependency resolution when installing mate-themes{,-meta}. Generally speaking, the simplest solution is to oneshot the appropriate mate-themes package, allowing subsequent emerges to happen without issue. For example, if you have x11-libs/gtk+-3.18 installed, you will want to or if you have gtk+-3.20 installed, you will want to

External resources

 * Arch wiki MATE article