Difference between revisions of "MATE"

From ArchWiki
Jump to navigation Jump to search
(→‎Additional MATE packages: add mate-screensaver-hacks)
m (no more plus in gtk)
 
(213 intermediate revisions by 42 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 articles end}}
 
{{Related articles end}}
  
From [http://mate-desktop.org/ MATE homepage]:
+
From [https://mate-desktop.org/ 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 [https://github.com/mate-desktop under active development] to add support for new technologies while preserving a traditional desktop experience.''
+
: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 [https://github.com/mate-desktop 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.
 
 
 
* Alacarte is renamed '''Mozo''';
 
* Nautilus is renamed '''Caja''';
 
* Metacity is renamed '''Marco''';
 
* Gedit is renamed '''Pluma''';
 
* Eye of GNOME is renamed '''Eye of MATE''';
 
* Evince is renamed  '''Atril''';
 
* File Roller is renamed '''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 ==
 
== Installation ==
  
MATE is available in the [[official repositories]] and can be [[pacman|installed]] with one of the following:
+
MATE is available in the [[official repositories]] and can be [[install]]ed with one of the following:
  
*The {{Pkg|mate-panel}} package provides a minimal desktop shell.
 
 
*The {{Grp|mate}} group contains the core desktop environment required for the standard MATE experience.
 
*The {{Grp|mate}} group contains the core desktop environment required for the standard MATE experience.
 
*The {{Grp|mate-extra}} group contains additional utilities and applications that integrate well with the MATE desktop. Installing just the {{Grp|mate-extra}} group will not pull in the whole {{Grp|mate}} group via dependencies. If you want to install all MATE packages then you will need to explicitly install both groups.
 
*The {{Grp|mate-extra}} group contains additional utilities and applications that integrate well with the MATE desktop. Installing just the {{Grp|mate-extra}} group will not pull in the whole {{Grp|mate}} group via dependencies. If you want to install all MATE packages then you will need to explicitly install both groups.
  
=== Additional MATE packages ===
+
The base desktop consists of {{Pkg|marco}}, {{Pkg|mate-panel}} and {{Pkg|mate-session-manager}}.
 +
 
 +
=== MATE applications ===
  
There are additional official packages not included in the {{Grp|mate}} or {{Grp|mate-extra}} because it is not necessarily useful to everyone.
+
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.
  
* {{Pkg|gnome-main-menu}} - A MATE panel applet similar to the traditional main-menu, but with a few additions.
+
{| class="wikitable"
* {{Pkg|mate-netbook}} - A MATE panel applet that might be useful to owners of small screen devices, such as a Netbook. The applet will automatically maximize all windows and provides an application switcher applet.
+
! Application
 +
! GNOME 2
 +
! MATE
 +
|-
 +
| menu editor
 +
| Alacarte
 +
| {{pkg|mozo}}
 +
|-
 +
| file manager
 +
| Nautilus
 +
| {{pkg|caja}}
 +
|-
 +
| window manager
 +
| Metacity
 +
| {{pkg|marco}}
 +
|-
 +
| text editor
 +
| Gedit
 +
| {{pkg|pluma}}
 +
|-
 +
| image viewer
 +
| Eye of GNOME
 +
| Eye of MATE ({{pkg|eom}})
 +
|-
 +
| document viewer
 +
| Evince
 +
| {{pkg|atril}}
 +
|-
 +
| archive manager
 +
| File Roller
 +
| {{pkg|engrampa}}
 +
|}
  
There are also a number of other unofficial MATE applications that are contributed and maintained by the MATE community and therefore not included in the {{Grp|mate}} or {{Grp|mate-extra}} groups.
+
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.
  
* {{Pkg|mate-accountsdialog}} - An application to view and modify user accounts information for MATE.
+
=== Additional MATE packages ===
* {{Pkg|mate-applet-lockkeys}} - A MATE panel applet that shows which of the CapsLock, NumLock and ScrollLock keys are on and which are off.
 
* {{Pkg|mate-applet-softupd}} - A MATE panel applet to notify when software updates become available.
 
* {{Pkg|mate-applet-streamer}} - A MATE panel applet to let you play your favourite online radio station with a single click.
 
* {{Pkg|mate-color-manager}} - Color management application for MATE.
 
* {{Pkg|mate-disk-utility}} - Disk management application for MATE.
 
* {{Pkg|mate-screensaver-hacks}} - Enable screensavers from xscreensaver for MATE.
 
* {{Pkg|mate-themes-extras}} - Collection of GTK2/3 desktop themes for MATE.
 
* {{Pkg|variety}} - Variety changes the wallpaper on a regular interval using user-specified or automatically downloaded images.
 
  
The following is also available via the AUR and integrates with MATE but the package is not maintained by the MATE team.
+
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.
  
* {{AUR|mintmenu}} - Linux Mint Menu for MATE.
+
* {{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|MATE Menu|Advanced menu for MATE Panel, a fork of MintMenu.|https://github.com/ubuntu-mate/mate-menu|{{AUR|mate-menu}}}}
 +
* {{App|MATE Tweak|Tweak tool for MATE, a fork of mintDesktop.|https://github.com/ubuntu-mate/mate-tweak|{{AUR|mate-tweak}}}}
 +
* {{App|BriskMenu|Modern, efficient menu for the MATE Desktop Environment from SolusOS distribution.|https://github.com/solus-project/brisk-menu|{{AUR|brisk-menu}}}}
  
== Starting MATE ==
+
Additional packages need to be installed to take advantage of some of Caja's advanced features - see [[File manager functionality]].
  
MATE can be started via a display manager or manually.
+
=== MATE unstable ===
  
=== Graphical log-in ===
+
Consider the following community efforts, cf. [https://bbs.archlinux.org/viewtopic.php?pid=1624557#p1624557 forum]:
  
Choose ''MATE'' from the menu in a [[display manager]] of choice. The MATE team recommends [[LightDM]] as the display manager with the GTK+ (2) greeter, which can be installed with the {{Pkg|lightdm-gtk2-greeter}} package.
+
* {{AUR|mate-desktop-dev}} (https://github.com/nicman23/arch_mate)
  
=== Manually ===
+
== Starting MATE ==
  
If you prefer to start MATE manually from the console, add the following line to your {{ic|~/.xinitrc}} file:
+
Choose ''MATE'' from the menu in a [[display manager]] of choice.
{{hc|~/.xinitrc|<nowiki>
 
exec mate-session
 
</nowiki>}}
 
  
Then MATE can be launched by typing {{ic|startx}}.
+
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.
  
See [[xinitrc]] for details, such as preserving the logind session.
+
== Configuration ==
  
== Accessibility ==
+
MATE can be configured with its ''Control Center'' application (''mate-control-center'') provided by the {{Pkg|mate-control-center}} package. To manage some hardware, you may need to install additional tools.
  
MATE is well suited for use by individuals with sight or mobility impairment. First install {{Pkg|orca}} and {{Pkg|espeak}} (Screen reader for individuals who are blind or visually impaired) and {{Pkg|onboard}} (On-screen keyboard useful for mobility impaired users)
+
; Audio
 +
: [[ALSA]] and [[PulseAudio]] backends are supported by the {{Pkg|mate-media}} package.
 +
; Bluetooth
 +
: For [[Bluetooth]] device support, install the {{Pkg|blueman}} package. See [[Blueman]].
 +
; Networking
 +
: For configuring the network, install the {{Pkg|network-manager-applet}} package. See [[NetworkManager]].
 +
; Power
 +
: UPower backend is supported by the {{Pkg|mate-power-manager}} package.
 +
; Printers
 +
: For configuring the printers, install the {{Pkg|system-config-printer}} package.
  
pacman -Syyu orca espeak onboard
+
=== Accessibility ===
  
Now, before starting MATE for the first time, enter the following command as the user who needs accessibility features:
+
MATE is well suited for use by individuals with sight or mobility impairment. [[Install]] {{Pkg|orca}}, {{Pkg|espeak}} (Screen reader for individuals who are blind or visually impaired) and {{Pkg|onboard}} (On-screen keyboard useful for mobility impaired users)
  
gsettings set org.mate.interface accessibility true
+
Before starting MATE for the first time, enter the following command as the user who needs accessibility features:
  
Once you start MATE, you can configure the accessibility applications via {{ic|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.
+
$ gsettings set org.mate.interface accessibility true
  
== Network Management ==
+
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.
  
It is recommended that you use [[Network Manager]] for managing networks in MATE. Please see the wiki page for more details on installing and configuring it.
+
=== Notifications ===
  
== Bluetooth ==
+
;Battery discharge
  
Since version 1.8, [[Bluetooth]] support in MATE is provided by [[Blueman]].
+
To disable the notification on battery discharge, run:
  
== PulseAudio and GStreamer ==
+
$ gsettings set org.mate.power-manager.notify-discharging false
  
MATE supports two audio backends, [http://www.pulseaudio.org PulseAudio] and [http://www.gstreamer.net GStreamer]. By default, the PulseAudio backend is installed but if you want to switch to the GStreamer backend, do the following:
+
;Brightness
  
# pacman -S mate-settings-daemon-gstreamer mate-media-gstreamer
+
See [[Backlight#Kernel command-line options]].
  
 
== Tips and tricks ==
 
== Tips and tricks ==
  
=== Enabling compositing ===
+
=== Disabling compositing ===
  
Compositing is not be 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 enabled by default. To disable it, navigate to ''Look and Feel > Windows > General'' in the System Preferences and tick the box alongside ''Enable software compositing window manager''. 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 false
  
=== Toggling compositing ===
+
=== Disabling new window centering ===
  
Some software, may have issues rendering images when working on an environment using the nvidia proprietary drivers and a compositing window manager.
+
By default, new windows are placed in the center. To disable centering new windows, navigate to run ''Windows > Placement'' in the System Preferences and tick the box alongside ''Center new windows''. Alternatively, you can run the following from the terminal:
  
To easily toggle the compositing feature, save the following script somewhere within the Home directory, e.g. {{ic|~/.scripts/compositing.sh}}:
+
$ gsettings set org.mate.Marco.general center-new-windows false
  
{{bc|<nowiki>
+
=== Disabling window snapping ===
#!/bin/sh
 
if $(dconf read /org/mate/marco/general/compositing-manager) == "true"
 
then
 
dconf write /org/mate/marco/general/compositing-manager false
 
else
 
dconf write /org/mate/marco/general/compositing-manager true
 
fi
 
</nowiki>}}
 
 
 
and then create a custom keyboard shortcut that executes the file, e.g. {{ic|Ctrl+Alt+C}}, to {{ic|sh ~/.scripts/compositing.sh}}.
 
 
 
=== Enabling new window centering ===
 
  
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:
+
Window snapping is enabled by default. To disable it, navigate to run ''Windows > Placement'' in the System Preferences and tick the box alongside ''Enable window tiling''. 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 allow-tiling false
  
=== Enabling window snapping ===
+
=== Undecorating maximized windows ===
  
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.  
+
Hiding the decorations of maximized windows is possible with the {{AUR|mate-tweak}} tool: After installing it, navigate to ''Look and Feel > MATE Tweak > Windows'' in the System Preferences and enable ''Undecorate maximized windows'' in the ''Window Behaviour'' section.
 +
{{Tip|If this option is grayed out and unavailable, try installing the {{Grp|mate-extra}} group.}}
  
 
=== 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
 +
 
 +
Doing so may cause some graphics artifacts on secondary monitors.
  
 
==== Hide individual icons ====
 
==== Hide individual icons ====
Line 155: Line 167:
 
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.
  
=== Use a different window manager with MATE ===
+
=== Use a different window manager ===
  
The default window manager in MATE is called ''marco'', a fork of the GNOME 2 window manager {{pkg|metacity}}. You can replace ''marco'' with another window manager via a number of different methods:
+
The ''marco'' window manager can be replaced with another window manager via either of the following methods:
  
* The easiest way to change the window manager is to autostart it using {{ic|mate-session-properties}}. Open the ''System'' menu, navigate to the ''Preferences'' menu and click on '''Startup Applications'''. In the dialog click '''Add.''' Enter a name and comment in the name and comment sections and in the command section add a command of the following syntax: ''"name of window manager"'' ''"--replace"''
+
;Using gsettings (recommended)
 +
Execute the following to specify a different window manager for MATE:
  
For example: for openbox you would use the command {{ic|openbox --replace}}.
+
$ gsettings set org.mate.session.required-components windowmanager ''wm-name''
  
Log out and log in again and ''marco'' should be replaced by the window manager of your choice. To revert to ''marco'' simply delete the entry you created in '''Startup Applications'''.
+
;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 ''Startup Applications'' in the System Preferences. In the dialog click ''Add.'' The command should take the syntax {{ic|''wm-name'' --replace}}.
  
* Alternatively you can specify the desired window manager in dconf:
+
=== Prevent Caja from managing the desktop ===
  
  $ dconf write /org/mate/desktop/session/required-components/windowmanager "'mywindowmanager'"
+
To prevent Caja from managing the desktop, execute the following:
 
+
  $ gsettings set org.mate.background show-desktop-icons false
replace "mywindowmanager" with the name of the window manager of your choice e.g. ''openbox'' or ''metacity''.
+
$ 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 the window title (it is necessary 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.
  
 
=== 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
 +
 
 +
And to disable automounting:
 +
 
 +
$ gsettings set org.mate.media-handling automount false
  
 
=== Screensaver ===
 
=== Screensaver ===
  
MATE uses {{pkg|mate-screensaver}} to lock your session. By default there are a limited number of lock-screens available. To make more lock-screens available, install the {{Pkg|mate-screensaver-hacks}} package. This will allow you to use [[Xscreensaver]] lock-screens 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}}.
 +
 
 +
=== 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 {{ic|start-here}}. To use a different icon, copy your icon to a folder such as {{ic|/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 {{ic|"'fast'"}}, {{ic|"'medium'"}} or {{ic|"'slow'"}}.
  
=== Lock screen & default background image ===
+
=== Set the terminal for caja-open-terminal ===
  
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>.
+
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
  
{{note|The values on the right must be enclosed in single quotes (<nowiki>''</nowiki>) otherwise an error will occur during re-compile.}}
+
$ gsettings set org.mate.applications-terminal exec ''my-terminal''
  
Example #1: Change the background image of the lock screen:
+
where ''my-terminal'' is the name of the terminal executable to be launched, for example: ''xterm''.
{{hc|/usr/share/glib-2.0/schemas/mate-background.gschema.override|2=
 
  
[org.mate.background]
+
== Troubleshooting ==
picture-filename='/path/to/the/background.jpg'}}
 
  
Example #2: Change the lock screen to use a gradient:
+
=== Toggling compositing ===
{{hc|/usr/share/glib-2.0/schemas/mate-background.gschema.override|2=
 
  
[org.mate.background]
+
Some software may have issues rendering graphics when working on an environment using the nvidia proprietary drivers and a compositing window manager.
color-shading-type='vertical-gradient'
 
picture-options='scaled'
 
picture-filename=<nowiki>''</nowiki>
 
primary-color='#152233'
 
secondary-color='#000000'}}
 
  
Re-compile the schemas:
+
To easily toggle the compositing feature, save the following script somewhere within the Home directory, e.g. {{ic|~/.scripts/compositing.sh}}:
# glib-compile-schemas /usr/share/glib-2.0/schemas/
 
  
Finally, restart your X session for the change to effect.
+
{{bc|<nowiki>
 +
#!/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
 +
</nowiki>}}
  
=== Styling Qt applications ===
+
and then create a custom keyboard shortcut that executes the file, e.g. {{ic|Ctrl+Alt+C}}, to {{ic|sh ~/.scripts/compositing.sh}}.
  
To make Qt4 applications inherit the MATE theme, do the following:
+
=== Vertical sync for compositing ===
  
* Navigate to ''System -> Preferences -> Qt4 Config'' or execute {{ic|qtconfig-qt4}} from a shell.
+
Mate's window manager, ''marco'', supports tear-free software compositing via DRI3/Xpresent. [https://github.com/mate-desktop/marco/issues/326]
* Change '''GUI Style''' to {{ic|GTK+}}.
 
* ''File --> Save''.
 
  
See [[Uniform Look for Qt and GTK Applications]] for more details.
+
If your graphics driver does not support DRI3 (e.g. the Nvidia Proprietary driver), ''marco'' does not support vertical synchronization via ''OpenGL'', which may cause video tearing with enabled compositing. [https://github.com/mate-desktop/marco/issues/91] In this case, consider a different [[composite manager]] with OpenGL support such as [[Compton]].
  
 
=== Consistent cursor theme ===
 
=== Consistent cursor theme ===
  
You may find that the cursor theme used in MATE is not consistent. For example, it may change when moving the cursor across different application windows. To fix this problem, set the cursor theme by creating an {{ic|index.theme}} file which defines the cursor theme according to the XDG icon theme specification. See the following section of the [[Cursor Themes]] article: [[Cursor_Themes#Using_an_index.theme_file_.28recommended.29]].
+
See [[Cursor themes#Desktop environments]].
  
 
=== 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
+
 
to have your desktop icons reappear.
+
  $ 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. [https://github.com/mate-desktop/mate-panel/issues/193]
 +
 
 +
Copy {{ic|/usr/share/applications/marco.desktop}} and add a delay:
 +
 
 +
{{hc|~/.local/share/applications/marco.desktop|2=
 +
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 {{ic|X-MATE-Autostart-Phase}} must be set to {{ic|Applications}}.}}
 +
 
 +
If this has no effect, increase the delay duration.
 +
 
 +
=== Disabling scroll in taskbar ===
 +
 
 +
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|libwnck3}} using the [[Arch Build System]]; in this case, rebuild libwnck3 with the following [https://pastebin.com/raw/q66p3dtj 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.
 +
 
 +
=== Caja's text file preview ===
 +
 
 +
Since the migration to GTK 3 this feature is not working.[https://github.com/mate-desktop/caja/issues/1047]
 +
 
 +
=== GTK 2 applications seem to ignore default MATE themes ===
 +
Themes that come with {{Pkg|mate-themes}} need optional dependencies {{Pkg|gtk-engines}} and {{Pkg|gtk-engine-murrine}} for GTK 2 themes to function properly.
 +
 
 +
=== Speaker test does not work ===
 +
For [[PulseAudio]] backend, [[install]] {{Pkg|libcanberra}}'s optional dependency {{Pkg|libcanberra-pulse}}.
 +
 
 +
=== Extra decoration on CSD applications ===
 +
An extra decoration can appear on CSD applications (Firefox, Visual Studio Code...) when they are unmaximized.[https://github.com/mate-desktop/mate-netbook/issues/14]
 +
 
 +
Uninstalling the package {{Pkg|mate-netbook}} solves the issue.
  
 
== See also ==
 
== See also ==
  
* [http://mate-desktop.org MATE homepage]
+
* [https://mate-desktop.org MATE homepage]
* [http://wiki.mate-desktop.org/archlinux_custom_repo MATE wiki for Arch Linux]
+
* [https://wiki.mate-desktop.org/archlinux_custom_repo MATE wiki for Arch Linux]
* [http://mate-desktop.org/gallery/1.8/ ''MATE desktop screenshots'']
+
* [https://mate-desktop.org/gallery/1.8/ MATE desktop screenshots]
* [https://bbs.archlinux.org/viewtopic.php?pid=1018647 ''The MATE Desktop Environment''] - Arch Linux forum discussion about MATE
+
* [https://bbs.archlinux.org/viewtopic.php?pid=1018647 The MATE Desktop Environment] - Arch Linux forum discussion about MATE

Latest revision as of 06:19, 16 August 2019

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.

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.

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.

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://github.com/ubuntu-mate/mate-menu || mate-menuAUR
  • MATE Tweak — Tweak tool for MATE, a fork of mintDesktop.
https://github.com/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

Disabling compositing

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

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

Disabling new window centering

By default, new windows are placed in the center. To disable centering new windows, navigate to run Windows > Placement in the System Preferences and tick the box alongside Center new windows. Alternatively, you can run the following from the terminal:

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

Disabling window snapping

Window snapping is enabled by default. To disable it, navigate to run Windows > Placement in the System Preferences and tick the box alongside Enable window tiling. Alternatively, you can run the following from the terminal:

$ gsettings set org.mate.Marco.general allow-tiling false

Undecorating maximized windows

Hiding the decorations of maximized windows is possible with the mate-tweakAUR tool: After installing it, navigate to Look and Feel > MATE Tweak > Windows in the System Preferences and enable Undecorate maximized windows in the Window Behaviour section.

Tip: If this option is grayed out and unavailable, try installing the mate-extra group.

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

Doing so may cause some graphics artifacts on secondary monitors.

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

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 Startup Applications in the System Preferences. 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

And to disable automounting:

$ gsettings set org.mate.media-handling automount 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

Mate's window manager, marco, supports tear-free software compositing via DRI3/Xpresent. [1]

If your graphics driver does not support DRI3 (e.g. the Nvidia Proprietary driver), marco does not support vertical synchronization via OpenGL, which may cause video tearing with enabled compositing. [2] In this case, 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. [3]

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

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 libwnck3 using the Arch Build System; in this case, rebuild libwnck3 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.

Caja's text file preview

Since the migration to GTK 3 this feature is not working.[4]

GTK 2 applications seem to ignore default MATE themes

Themes that come with mate-themes need optional dependencies gtk-engines and gtk-engine-murrine for GTK 2 themes to function properly.

Speaker test does not work

For PulseAudio backend, install libcanberra's optional dependency libcanberra-pulse.

Extra decoration on CSD applications

An extra decoration can appear on CSD applications (Firefox, Visual Studio Code...) when they are unmaximized.[5]

Uninstalling the package mate-netbook solves the issue.

See also