Difference between revisions of "MATE"

From ArchWiki
Jump to: navigation, search
(MATE unstable: remove old broken 1.14 repository)
(Starting MATE: remove dm recommendation altogether. all the dm has to do is execute 'mate-session' so it should work anywhere. it's misleading to 'recommend' this dm or that one.)
(32 intermediate revisions by 12 users not shown)
Line 5: Line 5:
 
[[ko:MATE]]
 
[[ko:MATE]]
 
[[ru:MATE]]
 
[[ru:MATE]]
[[zh-CN:MATE]]
+
[[zh-hans:MATE]]
 
{{Related articles start}}
 
{{Related articles start}}
 
{{Related|GNOME}}
 
{{Related|GNOME}}
Line 11: Line 11:
 
{{Related|Desktop environment}}
 
{{Related|Desktop environment}}
 
{{Related|Display manager}}
 
{{Related|Display manager}}
{{Related|Uniform Look for Qt and GTK Applications}}
+
{{Related|Uniform look for Qt and GTK applications}}
 
{{Related articles end}}
 
{{Related articles end}}
  
Line 29: Line 29:
 
| menu editor
 
| menu editor
 
| Alacarte
 
| Alacarte
| style="font-weight: bold;" | Mozo
+
| {{pkg|mozo}}
 
|-
 
|-
 
| file manager
 
| file manager
 
| Nautilus
 
| Nautilus
| style="font-weight: bold;" | Caja
+
| {{pkg|caja}}
 
|-
 
|-
 
| window manager
 
| window manager
 
| Metacity
 
| Metacity
| style="font-weight: bold;" | Marco
+
| {{pkg|marco}}
 
|-
 
|-
 
| text editor
 
| text editor
 
| Gedit
 
| Gedit
| style="font-weight: bold;" | Pluma
+
| {{pkg|pluma}}
 
|-
 
|-
 
| image viewer
 
| image viewer
 
| Eye of GNOME
 
| Eye of GNOME
| style="font-weight: bold;" | Eye of MATE
+
| Eye of MATE ({{pkg|eom}})
 
|-
 
|-
 
| document viewer
 
| document viewer
 
| Evince
 
| Evince
| style="font-weight: bold;" | Atril
+
| {{pkg|atril}}
 
|-
 
|-
 
| archive manager
 
| archive manager
 
| File Roller
 
| File Roller
| style="font-weight: bold;" | Engrampa
+
| {{pkg|engrampa}}
 
|}
 
|}
  
Line 71: Line 71:
 
There are a number of other unofficial MATE applications that are contributed to and maintained by the MATE community and therefore not included in the {{Grp|mate}} or {{Grp|mate-extra}} groups.
 
There are a number of other unofficial MATE applications that are contributed to and maintained by the MATE community and therefore not included in the {{Grp|mate}} or {{Grp|mate-extra}} groups.
  
* {{App|Caja Actions|An extension for Caja which allows arbitrary programs to be launched via context menu.|https://github.com/raveit65/caja-actions|{{Pkg|caja-actions}}}}
 
 
* {{App|Dock Applet|Application dock for the MATE panel.|https://github.com/robint99/dock-applet|{{Pkg|mate-applet-dock}}}}
 
* {{App|Dock Applet|Application dock for the MATE panel.|https://github.com/robint99/dock-applet|{{Pkg|mate-applet-dock}}}}
 
* {{App|Online Radio Applet|A MATE panel applet to let you play your favourite online radio station with a single click.|http://www.zavedil.com/online-radio-applet/|{{Pkg|mate-applet-streamer}}}}
 
* {{App|Online Radio Applet|A MATE panel applet to let you play your favourite online radio station with a single click.|http://www.zavedil.com/online-radio-applet/|{{Pkg|mate-applet-streamer}}}}
 
* {{App|MATE Menu|Advanced menu for MATE Panel, a fork of MintMenu.|https://bitbucket.org/ubuntu-mate/mate-menu|{{Pkg|mate-menu}}}}
 
* {{App|MATE Menu|Advanced menu for MATE Panel, a fork of MintMenu.|https://bitbucket.org/ubuntu-mate/mate-menu|{{Pkg|mate-menu}}}}
 
* {{App|MATE Tweak|Tweak tool for MATE, a fork of mintDesktop.|https://bitbucket.org/ubuntu-mate/mate-tweak|{{AUR|mate-tweak}}}}
 
* {{App|MATE Tweak|Tweak tool for MATE, a fork of mintDesktop.|https://bitbucket.org/ubuntu-mate/mate-tweak|{{AUR|mate-tweak}}}}
* {{App|TopMenu (GTK+)|MATE panel applet for a global menubar.|https://git.javispedro.com/cgit/topmenu-gtk.git/about/|{{AUR|topmenu-gtk}}}}
+
* {{App|BriskMenu|Modern, efficient menu for the MATE Desktop Environment from SolusOS distribution.|https://github.com/solus-project/brisk-menu|{{AUR|brisk-menu}}}}
  
 
Additional packages need to be installed to take advantage of some of Caja's advanced features - see [[File manager functionality]].
 
Additional packages need to be installed to take advantage of some of Caja's advanced features - see [[File manager functionality]].
 
=== GTK+ 3 version ===
 
 
An experimental GTK+ 3 build of MATE can be installed with {{Grp|mate-gtk3}} and {{Grp|mate-extra-gtk3}} groups. While it works mostly, there are some known issues with [https://github.com/mate-desktop/caja/milestones/Gtk+3 caja], [https://github.com/mate-desktop/eom/milestones/Gtk+3 eom], [https://github.com/mate-desktop/marco/milestones/Gtk+3 marco], [https://github.com/mate-desktop/mate-applets/milestones/Gtk+3 mate-applets], [https://github.com/mate-desktop/mate-control-center/milestones/Gtk+3 mate-control-center], [https://github.com/mate-desktop/mate-netbook/milestones/Gtk+3 mate-netbook], [https://github.com/mate-desktop/mate-notification-daemon/milestones/Gtk+3 mate-notification-daemon], [https://github.com/mate-desktop/mate-panel/milestones/Gtk+3 mate-panel] and [https://github.com/mate-desktop/pluma/milestones/Gtk+3 pluma].
 
  
 
=== MATE unstable ===
 
=== MATE unstable ===
Line 88: Line 83:
 
Consider the following community efforts, cf. [https://bbs.archlinux.org/viewtopic.php?pid=1624557#p1624557 forum]:
 
Consider the following community efforts, cf. [https://bbs.archlinux.org/viewtopic.php?pid=1624557#p1624557 forum]:
  
* {{AUR|mate-desktop-dev}}
+
* {{AUR|mate-desktop-dev}} (https://github.com/nicman23/arch_mate)
** https://github.com/nicman23/arch_mate
 
* https://github.com/xpander69/mate-archbuilds
 
  
 
== Starting MATE ==
 
== Starting MATE ==
  
Choose ''MATE'' from the menu in a [[display manager]] of choice. The MATE team recommends [[LightDM]] as the display manager.
+
Choose ''MATE'' from the menu in a [[display manager]] of choice.
  
 
Alternatively, to start MATE with ''startx'', append  {{ic|exec mate-session}} to your {{ic|~/.xinitrc}} file. See [[xinitrc]] for details, such as preserving the logind session.
 
Alternatively, to start MATE with ''startx'', append  {{ic|exec mate-session}} to your {{ic|~/.xinitrc}} file. See [[xinitrc]] for details, such as preserving the logind session.
Line 119: Line 112:
 
Before starting MATE for the first time, enter the following command as the user who needs accessibility features:
 
Before starting MATE for the first time, enter the following command as the user who needs accessibility features:
  
  gsettings set org.mate.interface accessibility true
+
  $ gsettings set org.mate.interface accessibility true
  
 
Once you start MATE, you can configure the accessibility applications via ''System > Preferences > Assistive Technologies'', although if you need Orca, you will need to run it from the {{ic|Alt-F2}} run window in order to start getting speech.
 
Once you start MATE, you can configure the accessibility applications via ''System > Preferences > Assistive Technologies'', although if you need Orca, you will need to run it from the {{ic|Alt-F2}} run window in order to start getting speech.
 +
 +
=== Notifications ===
 +
 +
;Battery discharge
 +
 +
To disable the notification on battery discharge, run:
 +
 +
$ gsettings set org.mate.power-manager.notify-discharging false
 +
 +
;Brightness
 +
 +
See [[Backlight#Kernel command-line options]].
  
 
== Tips and tricks ==
 
== Tips and tricks ==
Line 129: Line 134:
 
Compositing is not enabled by default. To enable it navigate to run {{ic|System -> Preferences -> Windows}} and click the tick box alongside '''Enable software compositing window manager''' in the {{ic|General}} tab. Alternatively, you can run the following from the terminal:
 
Compositing is not enabled by default. To enable it navigate to run {{ic|System -> Preferences -> Windows}} and click the tick box alongside '''Enable software compositing window manager''' in the {{ic|General}} tab. Alternatively, you can run the following from the terminal:
  
  $ dconf write /org/mate/marco/general/compositing-manager true
+
  $ gsettings set org.mate.Marco.general compositing-manager true
  
 
=== Enabling new window centering ===
 
=== Enabling new window centering ===
Line 135: Line 140:
 
By default, new windows are placed in the top-left corner. To center new windows on creation navigate to run {{ic|System -> Preferences -> Windows}} and click the tick box alongside '''Center new windows''' in the {{ic|Placement}} tab. Alternatively, you can run the following from the terminal:
 
By default, new windows are placed in the top-left corner. To center new windows on creation navigate to run {{ic|System -> Preferences -> Windows}} and click the tick box alongside '''Center new windows''' in the {{ic|Placement}} tab. Alternatively, you can run the following from the terminal:
  
  $ dconf write /org/mate/marco/general/center-new-windows true
+
  $ gsettings set org.mate.Marco.general center-new-windows true
  
 
=== Enabling window snapping ===
 
=== Enabling window snapping ===
Line 141: Line 146:
 
Window snapping is not be enabled by default, to enable it navigate to run {{ic|System -> Preferences -> Windows}} and click the tick box alongside '''Enable side by side tiling''' in the {{ic|Placement}} tab. Alternatively, you can run the following from the terminal:
 
Window snapping is not be enabled by default, to enable it navigate to run {{ic|System -> Preferences -> Windows}} and click the tick box alongside '''Enable side by side tiling''' in the {{ic|Placement}} tab. Alternatively, you can run the following from the terminal:
  
  $ dconf write /org/mate/marco/general/side-by-side-tiling true  
+
  $ gsettings set org.mate.Marco.general side-by-side-tiling true
  
 
=== Show or hide desktop icons ===
 
=== Show or hide desktop icons ===
  
By default, MATE shows multiple icons on the desktop: The content of your desktop directory, computer, home and network directories, the trash and mounted drives. You can show or hide them individually or all at once using {{ic|dconf}}.
+
By default, MATE shows multiple icons on the desktop: The content of your desktop directory, computer, home and network directories, the trash and mounted drives. You can show or hide them individually or all at once using {{ic|gsettings}}.
  
 
==== Hide all desktop icons ====
 
==== Hide all desktop icons ====
  
  $ dconf write /org/mate/desktop/background/show-desktop-icons false
+
  $ gsettings set org.mate.background show-desktop-icons false
  
 
==== Hide individual icons ====
 
==== Hide individual icons ====
Line 155: Line 160:
 
Hide computer icon:
 
Hide computer icon:
  
  $ dconf write /org/mate/caja/desktop/computer-icon-visible false
+
  $ gsettings set org.mate.caja.desktop computer-icon-visible false
  
 
Hide user directory icon:
 
Hide user directory icon:
  
  $ dconf write /org/mate/caja/desktop/home-icon-visible false
+
  $ gsettings set org.mate.caja.desktop home-icon-visible false
  
 
Hide network icon:
 
Hide network icon:
  
  $ dconf write /org/mate/caja/desktop/network-icon-visible false
+
  $ gsettings set org.mate.caja.desktop network-icon-visible false
  
 
Hide trash icon:
 
Hide trash icon:
  
  $ dconf write /org/mate/caja/desktop/trash-icon-visible false
+
  $ gsettings set org.mate.caja.desktop trash-icon-visible false
  
 
Hide mounted volumes:
 
Hide mounted volumes:
  
  $ dconf write /org/mate/caja/desktop/volumes-visible false
+
  $ gsettings set org.mate.caja.desktop volumes-visible false
  
 
Replace {{ic|false}} with {{ic|true}} for the icons to reappear.
 
Replace {{ic|false}} with {{ic|true}} for the icons to reappear.
Line 179: Line 184:
 
The ''marco'' window manager can be replaced with another window manager via either of the following methods:
 
The ''marco'' window manager can be replaced with another window manager via either of the following methods:
  
;Using DConf (recommended)
+
;Using gsettings (recommended)
 
Execute the following to specify a different window manager for MATE:
 
Execute the following to specify a different window manager for MATE:
  $ dconf write /org/mate/desktop/session/required-components/windowmanager ''wm-name''
+
 
 +
  $ gsettings set org.mate.session.required-components windowmanager ''wm-name''
  
 
;Using MATE session autostart
 
;Using MATE session autostart
Line 190: Line 196:
 
To prevent Caja from managing the desktop, execute the following:
 
To prevent Caja from managing the desktop, execute the following:
 
  $ gsettings set org.mate.background show-desktop-icons false
 
  $ gsettings set org.mate.background show-desktop-icons false
  $ killall caja # caja will be restarted by session manager
+
  $ killall caja # Caja will be restarted by session manager
  
 
=== Change window decoration button order ===
 
=== Change window decoration button order ===
  
You can change the button using dconf. The key is in org.mate.marco.general.button-layout. Use the graphical dconf-editor or the dconf command line tool to change it:
+
You can change the button order using the graphical dconf-editor or the gsettings command line tool:
  
  $ dconf write /org/mate/marco/general/button-layout "'close,maximize,minimize:'"
+
  $ gsettings set org.mate.Marco.general button-layout 'close,maximize,minimize:'
  
 
and put '''menu''', '''close''', '''minimize''' and '''maximize''' in your desired order, separated by commas. The colon is used to specify on which side of the titlebar the window buttons will appear and must be used for the changes to apply.
 
and put '''menu''', '''close''', '''minimize''' and '''maximize''' in your desired order, separated by commas. The colon is used to specify on which side of the titlebar the window buttons will appear and must be used for the changes to apply.
Line 202: Line 208:
 
=== Auto open file manager after drive mount ===
 
=== Auto open file manager after drive mount ===
  
By default, MATE automatically opens a new file manager window when a drive is mounted. To disable this, change the following key in dconf:
+
By default, MATE automatically opens a new file manager window when a drive is mounted. To disable this:
  
  $ dconf write /org/mate/desktop/media-handling/automount-open false
+
  $ gsettings set org.mate.media-handling automount-open false
  
 
=== Screensaver ===
 
=== Screensaver ===
  
MATE uses {{pkg|mate-screensaver}} to lock your session. By default there are a limited number of screensavers available. To make more screensavers available, install the {{Pkg|mate-screensaver-hacks}} package. This will allow you to use [[XScreenSaver]] screensavers with {{pkg|mate-screensaver}}.
+
MATE uses {{pkg|mate-screensaver}} to lock your session. By default there are a limited number of screensavers available. To make more screensavers available, install the {{AUR|mate-screensaver-hacks}} package. This will allow you to use [[XScreenSaver]] screensavers with {{pkg|mate-screensaver}}.
 
 
=== Lock screen and default background image ===
 
 
 
The full list of configuration options can be found in <code>/usr/share/glib-2.0/schemas/org.mate.background.gschema.xml</code>, they are overridden by creating the file <code>/usr/share/glib-2.0/schemas/mate-background.gschema.override</code>.
 
 
 
{{note|The values on the right must be enclosed in single quotes (<nowiki>''</nowiki>) otherwise an error will occur during re-compile.}}
 
 
 
Example #1: Change the background image of the lock screen:
 
{{hc|/usr/share/glib-2.0/schemas/mate-background.gschema.override|2=
 
 
 
[org.mate.background]
 
picture-filename='/path/to/the/background.jpg'}}
 
 
 
Example #2: Change the lock screen to use a gradient:
 
{{hc|/usr/share/glib-2.0/schemas/mate-background.gschema.override|2=
 
 
 
[org.mate.background]
 
color-shading-type='vertical-gradient'
 
picture-options='scaled'
 
picture-filename=<nowiki>''</nowiki>
 
primary-color='#152233'
 
secondary-color='#000000'}}
 
 
 
Re-compile the schemas:
 
# glib-compile-schemas /usr/share/glib-2.0/schemas/
 
 
 
Finally, restart your X session for the change to effect.
 
  
 
=== Spatial view in Caja ===
 
=== Spatial view in Caja ===
Line 263: Line 242:
 
  $ dconf write /org/mate/panel/toplevels/''panel''/animation-speed ''value''
 
  $ dconf write /org/mate/panel/toplevels/''panel''/animation-speed ''value''
 
where ''panel'' is either ''top'' or ''bottom'' and ''value'' is either {{ic|"'fast'"}}, {{ic|"'medium'"}} or {{ic|"'slow'"}}.
 
where ''panel'' is either ''top'' or ''bottom'' and ''value'' is either {{ic|"'fast'"}}, {{ic|"'medium'"}} or {{ic|"'slow'"}}.
 +
 +
=== Set the terminal for caja-open-terminal ===
 +
 +
The {{ic|caja-open-terminal}} extension uses GSettings to determine which terminal to use - ''mate-terminal'' is the default. To change the terminal that will be used, run the following command
 +
 +
$ gsettings set org.mate.applications-terminal exec ''my-terminal''
 +
 +
where ''my-terminal'' is the name of the terminal executable to be launched, for example: ''xterm''.
  
 
== Troubleshooting ==
 
== Troubleshooting ==
Line 274: Line 261:
 
{{bc|<nowiki>
 
{{bc|<nowiki>
 
#!/bin/bash
 
#!/bin/bash
if $(dconf read /org/mate/marco/general/compositing-manager) == "true"
+
if $(gsettings get org.mate.Marco.general compositing-manager) == "true"
 
then
 
then
   dconf write /org/mate/marco/general/compositing-manager false
+
   gsettings set org.mate.Marco.general compositing-manager false
 
else
 
else
   dconf write /org/mate/marco/general/compositing-manager true
+
   gsettings set org.mate.Marco.general compositing-manager true
 
fi
 
fi
 
</nowiki>}}
 
</nowiki>}}
Line 294: Line 281:
 
=== Use of gradient backgrounds with LightDM ===
 
=== Use of gradient backgrounds with LightDM ===
  
If you wish to use the default MATE (1.8) ''Stripes'' background as the LightDM background as well so as to make for seamless transition from LightDM to MATE, you will find that it is runtime-constructed from a grayscale PNG upon which MATE layers a vertical blue-to-green gradient, something which LightDM does not currently support. If insistent, you can work around this by temporarily setting {{ic|/org/mate/desktop/background/show-desktop-icons}} to {{ic|false}}, either through the {{ic|dconf Editor}} tool available from the {{ic|System Tools}} menu or by running
+
If you wish to use the default MATE (1.8) ''Stripes'' background as the LightDM background as well so as to make for seamless transition from LightDM to MATE, you will find that it is runtime-constructed from a grayscale PNG upon which MATE layers a vertical blue-to-green gradient, something which LightDM does not currently support. If insistent, you can work around this by temporarily setting {{ic|/org/mate/desktop/background/show-desktop-icons}} to {{ic|false}}, either through the {{ic|dconf-editor}} tool available from the {{ic|System Tools}} menu or by running
  
  dconf write /org/mate/desktop/background/show-desktop-icons false
+
  $ gsettings set org.mate.background show-desktop-icons false
  
 
from the Alt-F2 {{ic|Run Application}} dialog, then running {{ic|killall mate-panel}} from said dialog and hitting {{ic|Print Screen}} before the panel reappears. You are then presented with a {{ic|Save As}} dialog for exactly that fully rendered, screen-sized PNG that you need for LightDM. Run
 
from the Alt-F2 {{ic|Run Application}} dialog, then running {{ic|killall mate-panel}} from said dialog and hitting {{ic|Print Screen}} before the panel reappears. You are then presented with a {{ic|Save As}} dialog for exactly that fully rendered, screen-sized PNG that you need for LightDM. Run
  
  dconf reset /org/mate/desktop/background/show-desktop-icons
+
  $ gsettings set org.mate.background show-desktop-icons true
  
to have your desktop icons reappear.
+
to have your desktop icons reappear, if desired.
  
 
=== Enabling panel shadow ===
 
=== Enabling panel shadow ===
Line 322: Line 309:
  
 
=== Disabling scroll in taskbar ===
 
=== Disabling scroll in taskbar ===
 +
 +
{{Out of date|As of 1.18, MATE Panel uses {{Pkg|libwnck3}} instead of {{Pkg|libwnck}}. The patch does not apply to {{Pkg|libwnck3}} so this approach is now broken.}}
  
 
A feature of the MATE panel window list is that windows can be scrolled through using the mouse or touchpad. This feature may be troublesome for some as there is potential for accidental, unintended scrolling through windows.
 
A feature of the MATE panel window list is that windows can be scrolled through using the mouse or touchpad. This feature may be troublesome for some as there is potential for accidental, unintended scrolling through windows.
  
 
Whilst there is no way of disabling this feature through MATE's settings, this feature can be disabled by patching {{Pkg|libwnck}} using the [[Arch Build System]]; in this case, rebuild libwnck with the following [http://pastebin.com/raw.php?i=Bj0AnH1c patch]. For more information on rebuilding packages with patches applied, see [[Patching in ABS#Applying patches]].
 
Whilst there is no way of disabling this feature through MATE's settings, this feature can be disabled by patching {{Pkg|libwnck}} using the [[Arch Build System]]; in this case, rebuild libwnck with the following [http://pastebin.com/raw.php?i=Bj0AnH1c patch]. For more information on rebuilding packages with patches applied, see [[Patching in ABS#Applying patches]].
 +
 +
=== Logout/shutdown delayed by at-spi-registryd ===
 +
 +
When logging out or shutting down, you may find that you are presented with an ''A program is still running: at-spi-registryd.desktop'' popup. As a workaround, you can prevent ''at-spi-registryd'' from starting - see [[GTK+#Suppress warning about accessibility bus]] - though this may have an effect on some accessibility features.
  
 
== See also ==
 
== See also ==

Revision as of 10:32, 24 September 2017

From MATE homepage:

The MATE Desktop Environment is the continuation of GNOME 2. It provides an intuitive and attractive desktop environment using traditional metaphors for Linux and other Unix-like operating systems. MATE is under active development to add support for new technologies while preserving a traditional desktop experience.

MATE applications

MATE is largely composed of GNOME 2 applications and utilities, forked and renamed to avoid conflicting with their GNOME 3 counterparts. Below is a list of common GNOME applications which have been renamed in MATE.

Application GNOME 2 MATE
menu editor Alacarte mozo
file manager Nautilus caja
window manager Metacity marco
text editor Gedit pluma
image viewer Eye of GNOME Eye of MATE (eom)
document viewer Evince atril
archive manager File Roller engrampa

Other applications and core components prefixed with GNOME (such as GNOME Terminal, GNOME Panel, GNOME Menus, etc.) have had the prefix changed to MATE so they become MATE Panel, MATE Menus etc.

Installation

MATE is available in the official repositories and can be installed with one of the following:

  • The mate group contains the core desktop environment required for the standard MATE experience.
  • The mate-extra group contains additional utilities and applications that integrate well with the MATE desktop. Installing just the mate-extra group will not pull in the whole mate group via dependencies. If you want to install all MATE packages then you will need to explicitly install both groups.

The base desktop consists of marco, mate-panel and mate-session-manager,

Additional MATE packages

There are a number of other unofficial MATE applications that are contributed to and maintained by the MATE community and therefore not included in the mate or mate-extra groups.

  • Dock Applet — Application dock for the MATE panel.
https://github.com/robint99/dock-applet || mate-applet-dock
  • Online Radio Applet — A MATE panel applet to let you play your favourite online radio station with a single click.
http://www.zavedil.com/online-radio-applet/ || mate-applet-streamer
  • MATE Menu — Advanced menu for MATE Panel, a fork of MintMenu.
https://bitbucket.org/ubuntu-mate/mate-menu || mate-menu
  • MATE Tweak — Tweak tool for MATE, a fork of mintDesktop.
https://bitbucket.org/ubuntu-mate/mate-tweak || mate-tweakAUR
  • BriskMenu — Modern, efficient menu for the MATE Desktop Environment from SolusOS distribution.
https://github.com/solus-project/brisk-menu || brisk-menuAUR

Additional packages need to be installed to take advantage of some of Caja's advanced features - see File manager functionality.

MATE unstable

Consider the following community efforts, cf. forum:

Starting MATE

Choose MATE from the menu in a display manager of choice.

Alternatively, to start MATE with startx, append exec mate-session to your ~/.xinitrc file. See xinitrc for details, such as preserving the logind session.

Configuration

MATE can be configured with its Control Center application (mate-control-center) provided by the mate-control-center package. To manage some hardware, you may need to install additional tools.

Audio
ALSA and PulseAudio backends are supported by the mate-media package.
Bluetooth
For Bluetooth device support, install the blueman package. See Blueman.
Networking
For configuring the network, install the network-manager-applet package. See NetworkManager.
Power
UPower backend is supported by the mate-power-manager package.
Printers
For configuring the printers, install the system-config-printer package.

Accessibility

MATE is well suited for use by individuals with sight or mobility impairment. Install orca, espeak (Screen reader for individuals who are blind or visually impaired) and onboard (On-screen keyboard useful for mobility impaired users)

Before starting MATE for the first time, enter the following command as the user who needs accessibility features:

$ gsettings set org.mate.interface accessibility true

Once you start MATE, you can configure the accessibility applications via System > Preferences > Assistive Technologies, although if you need Orca, you will need to run it from the Alt-F2 run window in order to start getting speech.

Notifications

Battery discharge

To disable the notification on battery discharge, run:

$ gsettings set org.mate.power-manager.notify-discharging false
Brightness

See Backlight#Kernel command-line options.

Tips and tricks

Enabling compositing

Compositing is not enabled by default. To enable it navigate to run System -> Preferences -> Windows and click the tick box alongside Enable software compositing window manager in the General tab. Alternatively, you can run the following from the terminal:

$ gsettings set org.mate.Marco.general compositing-manager true

Enabling new window centering

By default, new windows are placed in the top-left corner. To center new windows on creation navigate to run System -> Preferences -> Windows and click the tick box alongside Center new windows in the Placement tab. Alternatively, you can run the following from the terminal:

$ gsettings set org.mate.Marco.general center-new-windows true

Enabling window snapping

Window snapping is not be enabled by default, to enable it navigate to run System -> Preferences -> Windows and click the tick box alongside Enable side by side tiling in the Placement tab. Alternatively, you can run the following from the terminal:

$ gsettings set org.mate.Marco.general side-by-side-tiling true

Show or hide desktop icons

By default, MATE shows multiple icons on the desktop: The content of your desktop directory, computer, home and network directories, the trash and mounted drives. You can show or hide them individually or all at once using gsettings.

Hide all desktop icons

$ gsettings set org.mate.background show-desktop-icons false

Hide individual icons

Hide computer icon:

$ gsettings set org.mate.caja.desktop computer-icon-visible false

Hide user directory icon:

$ gsettings set org.mate.caja.desktop home-icon-visible false

Hide network icon:

$ gsettings set org.mate.caja.desktop network-icon-visible false

Hide trash icon:

$ gsettings set org.mate.caja.desktop trash-icon-visible false

Hide mounted volumes:

$ gsettings set org.mate.caja.desktop volumes-visible false

Replace false with true for the icons to reappear.

Use a different window manager with MATE

The marco window manager can be replaced with another window manager via either of the following methods:

Using gsettings (recommended)

Execute the following to specify a different window manager for MATE:

$ gsettings set org.mate.session.required-components windowmanager wm-name
Using MATE session autostart

You can autostart a window manager of your choice using mate-session-properties. This means that the autostarted window manager will replace the default window manager at login. Navigate to System -> Preferences -> Startup Applications. In the dialog click Add. The command should take the syntax wm-name --replace.

Prevent Caja from managing the desktop

To prevent Caja from managing the desktop, execute the following:

$ gsettings set org.mate.background show-desktop-icons false
$ killall caja  # Caja will be restarted by session manager

Change window decoration button order

You can change the button order using the graphical dconf-editor or the gsettings command line tool:

$ gsettings set org.mate.Marco.general button-layout 'close,maximize,minimize:'

and put menu, close, minimize and maximize in your desired order, separated by commas. The colon is used to specify on which side of the titlebar the window buttons will appear and must be used for the changes to apply.

Auto open file manager after drive mount

By default, MATE automatically opens a new file manager window when a drive is mounted. To disable this:

$ gsettings set org.mate.media-handling automount-open false

Screensaver

MATE uses mate-screensaver to lock your session. By default there are a limited number of screensavers available. To make more screensavers available, install the mate-screensaver-hacksAUR package. This will allow you to use XScreenSaver screensavers with mate-screensaver.

Spatial view in Caja

To ensure that each new folder opens in a new window (known as spatial view), open Caja's preferences dialog, click on the behaviour tab and tick the 'Open each folder in its own window' option. Alternatively, execute the following command which achieves the same effect:

$ gsettings set org.mate.caja.preferences always-use-browser false

Change font DPI setting

You can alter the DPI (dots per inch) of the fonts in MATE by right-clicking on the desktop and choosing Change desktop background > Fonts > Details > Resolution.

Change applications menu icon

By default, the applications menu icon is set to start-here. To use a different icon, copy your icon to a folder such as /usr/local/share/pixmaps and execute the following:

$ gsettings set org.mate.panel.menubar icon-name icon

where icon is the name of your icon. Do not include the file extension in the icon name. Finally, restart MATE Panel.

Panel speed settings

Hide/Unhide delay

To adjust the amount of time it takes for the panel to disappear or reappear when autohide is enabled, execute the following:

$ dconf write /org/mate/panel/toplevels/panel/(un)hide-delay time

where panel is either top or bottom and time is a value in miliseconds, e.g. 300.

Animation speed

To set the speed at which panel animations occur, execute the following:

$ dconf write /org/mate/panel/toplevels/panel/animation-speed value

where panel is either top or bottom and value is either "'fast'", "'medium'" or "'slow'".

Set the terminal for caja-open-terminal

The caja-open-terminal extension uses GSettings to determine which terminal to use - mate-terminal is the default. To change the terminal that will be used, run the following command

$ gsettings set org.mate.applications-terminal exec my-terminal

where my-terminal is the name of the terminal executable to be launched, for example: xterm.

Troubleshooting

Toggling compositing

Some software may have issues rendering graphics when working on an environment using the nvidia proprietary drivers and a compositing window manager.

To easily toggle the compositing feature, save the following script somewhere within the Home directory, e.g. ~/.scripts/compositing.sh:

#!/bin/bash
if $(gsettings get org.mate.Marco.general compositing-manager) == "true"
then
  gsettings set org.mate.Marco.general compositing-manager false
else
  gsettings set org.mate.Marco.general compositing-manager true
fi

and then create a custom keyboard shortcut that executes the file, e.g. Ctrl+Alt+C, to sh ~/.scripts/compositing.sh.

Vertical sync for compositing

marco does not support vertical synchronization via OpenGL, which may cause video tearing with enabled compositing. [1] Consider a different composite manager with OpenGL support such as Compton.

Consistent cursor theme

See Cursor themes#Desktop environments.

Use of gradient backgrounds with LightDM

If you wish to use the default MATE (1.8) Stripes background as the LightDM background as well so as to make for seamless transition from LightDM to MATE, you will find that it is runtime-constructed from a grayscale PNG upon which MATE layers a vertical blue-to-green gradient, something which LightDM does not currently support. If insistent, you can work around this by temporarily setting /org/mate/desktop/background/show-desktop-icons to false, either through the dconf-editor tool available from the System Tools menu or by running

$ gsettings set org.mate.background show-desktop-icons false

from the Alt-F2 Run Application dialog, then running killall mate-panel from said dialog and hitting Print Screen before the panel reappears. You are then presented with a Save As dialog for exactly that fully rendered, screen-sized PNG that you need for LightDM. Run

$ gsettings set org.mate.background show-desktop-icons true

to have your desktop icons reappear, if desired.

Enabling panel shadow

Due to a race condition, the panel shadow does not appear after logging in to the MATE desktop, even with compositing enabled. [2]

Copy /usr/share/applications/marco.desktop and add a delay:

~/.local/share/applications/marco.desktop
X-MATE-Autostart-Phase=Applications
X-MATE-Autostart-Delay=2
X-MATE-Provides=windowmanager
X-MATE-Autostart-Notify=true
Note: Delays are only allowed in the applications phase, hence X-MATE-Autostart-Phase must be set to Applications.

If this has no effect, increase the delay duration.

Disabling scroll in taskbar

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: As of 1.18, MATE Panel uses libwnck3 instead of libwnck. The patch does not apply to libwnck3 so this approach is now broken. (Discuss in Talk:MATE#)

A feature of the MATE panel window list is that windows can be scrolled through using the mouse or touchpad. This feature may be troublesome for some as there is potential for accidental, unintended scrolling through windows.

Whilst there is no way of disabling this feature through MATE's settings, this feature can be disabled by patching libwnck using the Arch Build System; in this case, rebuild libwnck with the following patch. For more information on rebuilding packages with patches applied, see Patching in ABS#Applying patches.

Logout/shutdown delayed by at-spi-registryd

When logging out or shutting down, you may find that you are presented with an A program is still running: at-spi-registryd.desktop popup. As a workaround, you can prevent at-spi-registryd from starting - see GTK+#Suppress warning about accessibility bus - though this may have an effect on some accessibility features.

See also