Difference between revisions of "MATE"

From ArchWiki
Jump to: navigation, search
(Installation: rewrote installation section and pointed users towards the mate wiki arch page)
(retitle the section on changing the screensaver background and move it to troubleshooting. it's a workaround for a bug, not a tip.)
 
(225 intermediate revisions by 41 users not shown)
Line 9: Line 9:
 
{{Related|GNOME}}
 
{{Related|GNOME}}
 
{{Related|Cinnamon}}
 
{{Related|Cinnamon}}
{{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 [http://mate-desktop.org/ MATE homepage]:
  
:''The MATE Desktop Environment is a fork 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.
 +
 
 +
{| class="wikitable"
 +
! Application
 +
! GNOME 2
 +
! MATE
 +
|-
 +
| menu editor
 +
| Alacarte
 +
| style="font-weight: bold;" | Mozo
 +
|-
 +
| file manager
 +
| Nautilus
 +
| style="font-weight: bold;" | Caja
 +
|-
 +
| window manager
 +
| Metacity
 +
| style="font-weight: bold;" | Marco
 +
|-
 +
| text editor
 +
| Gedit
 +
| style="font-weight: bold;" | Pluma
 +
|-
 +
| image viewer
 +
| Eye of GNOME
 +
| style="font-weight: bold;" | Eye of MATE
 +
|-
 +
| document viewer
 +
| Evince
 +
| style="font-weight: bold;" | Atril
 +
|-
 +
| archive manager
 +
| File Roller
 +
| style="font-weight: bold;" | 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 not packaged in the [[Official Repositories]]. MATE can either be installed from an [[Unofficial User Repositories#mate|unofficial repository]] or from the [[AUR]]. Please see the [http://wiki.mate-desktop.org/archlinux_custom_repo MATE wiki] for instructions on adding the repository and signing the developer key.
+
MATE is available in the [[official repositories]] and can be [[installed]] with one of the following:
  
Once the repository has been added you can install the core MATE components by installing the '''mate''' group. You can also install the '''mate-extra''' group which contains additional MATE utilities and applications.
+
*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.
  
{{Tip|The '''mate-netbook''' package provides a MATE panel applet that might be useful to owners of small screen devices, such as a Netbook. The applet will automatically maximise all windows and provides an application switcher applet. It is not part of the '''mate''' or '''mate-extra''' groups but can be installed separately if desired.}}
+
The base desktop consists of {{Pkg|marco}}, {{Pkg|mate-panel}} and {{Pkg|mate-session-manager}},
  
== Starting ==
+
=== Additional MATE packages ===
  
MATE can be started via a display manager or manually.
+
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.
  
=== Graphical log-in ===
+
* {{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|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 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}}}}
  
Just select MATE from the Sessions list of you favorite [[Display Manager]].
+
Additional packages need to be installed to take advantage of some of Caja's advanced features - see [[File manager functionality]].
  
==== LightDM ====
+
=== GTK+ 3 version ===
+
The MATE team recommend [[LightDM]] as the display manager with the {{Pkg|lightdm-gtk2-greeter}} greeter.
+
  
==== GDM-old ====
+
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 few 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-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].
  
If you are using {{AUR|gdm-old}} from the AUR, simply select the MATE session from the Sessions list. For your first time launching MATE, make sure to click "Just this session" when prompted.
+
=== MATE unstable ===
  
==== KDM ====
+
Consider the following community efforts, cf. [https://bbs.archlinux.org/viewtopic.php?pid=1624557#p1624557 forum]:
  
In order to be able to launch MATE from [[KDM]], the [[KDE]] Display Manager, you have to edit the KDM configuration.
+
* {{AUR|mate-desktop-dev}} (https://github.com/nicman23/arch_mate)
As root, edit the <code>/usr/share/config/kdm/kdmrc</code> configuration file. Find the '''SessionsDir''' parameter and add <code>/usr/share/xsessions</code> to the list.
+
It should then look like this:
+
  
SessionsDirs=/usr/share/config/kdm/sessions,/usr/share/apps/kdm/sessions,/usr/share/xsessions
+
== Starting MATE ==
  
Restart KDM and select the "MATE session" from the list.
+
Choose ''MATE'' from the menu in a [[display manager]] of choice. The MATE team recommends [[LightDM]] as the display manager.
  
=== Manually ===
+
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.
  
In order to start MATE manually, you must add
+
== Configuration ==
  
exec mate-session
+
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.
  
to your {{ic|~/.xinitrc}} file and then run
+
; 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.
  
$ startx
+
=== Accessibility ===
  
{{note|See [[xinitrc]] for details, such as preserving the logind session.}}
+
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)
  
== GNOME 2 Applications ==
+
Before starting MATE for the first time, enter the following command as the user who needs accessibility features:
  
MATE is largely composed of GNOME 2 applications and utilities, forked and renamed to avoid conflicting with GNOME 3. Below is a list of common GNOME applications which have been renamed in MATE.
+
$ gsettings set org.mate.interface accessibility true
  
* Alacarte is renamed '''Mozo'''.
+
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.
* 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'''.
+
* GNOME Terminal is renamed '''MATE Terminal'''.
+
  
Other applications and core components prefixed with GNOME (such as GNOME Panel, GNOME Menus etc) have had the prefix changed to MATE so they become MATE Panel, MATE Menus etc.
+
== Tips and tricks ==
  
=== Network Management ===
+
=== Enabling compositing ===
  
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.
+
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:
  
== Tips & Tricks ==
+
$ gsettings set org.mate.Marco.general compositing-manager true
=== Upgrading from 1.4 to 1.6 ===
+
  
MATE 1.6 migrated from {{ic|gconf}} to {{ic|gsettings}}. If you are updating from an MATE 1.4 you might end up with an empty panel. To resolve the issue reset the panel configuration to its defaults using
+
=== Enabling new window centering ===
  
# mate-panel --reset
+
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:
  
Then use...
+
$ gsettings set org.mate.Marco.general center-new-windows true
  
# mate-conf-import
+
=== Enabling window snapping ===
  
to restore most of your old settings. After upgrading from MATE 1.4 to MATE 1.6 you should remove the some of the old MATE 1.4 libraries that are not required by MATE 1.6, this can also improve the start-up time of MATE.
+
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:
  
  # pacman -R ffmpegthumbnailer-caja libmate libmatecanvas libmatecomponent libmatecomponentui libmatenotify libmateui mate-conf mate-conf-editor mate-corba mate-mime-data mate-vfs python-corba python-mate python-mate-desktop
+
  $ gsettings set org.mate.Marco.general side-by-side-tiling true
  
You can also use:
+
=== Show or hide desktop icons ===
  
# pacman -R $(pacman -Qtdq)
+
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}}.
  
to remove any orphaned packages. Packages which are not orphaned are probably still required.
+
==== Hide all desktop icons ====
  
{{note|The command to remove orphaned packages will need to be executed multiple times to ensure that all packages are cleaned up.}}
+
$ gsettings set org.mate.background show-desktop-icons false
{{warning|When removing the deprecated libraries take care to not remove other important packages as well.}}
+
  
=== Bluetooth applet ===
+
==== Hide individual icons ====
  
The MATE bluetooth applet currently requires [[Bluez4]] which has been deprecated. If you need a bluetooth applet in MATE you will have to install {{AUR|mate-bluetooth}} and {{AUR|bluez4}} from the [[AUR]]. If you want to enable Personal File Sharing over Bluetooth you will also need to install {{AUR|mate-user-share-bluez4}} because the packaged version of {{AUR|mate-user-share}} has had the bluetooth component removed.
+
Hide computer icon:
  
{{tip|It may be advisable to install {{pkg|bluez}} version 5 instead and access bluetooth functionality from the command line. For more information please consult the [[Bluetooth]] article.}}
+
$ gsettings set org.mate.caja.desktop computer-icon-visible false
  
=== Use a different window manager with MATE ===
+
Hide user directory icon:
  
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:
+
$ gsettings set org.mate.caja.desktop home-icon-visible false
  
* 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"''
+
Hide network icon:
  
For example: for openbox you would use the command {{ic|openbox --replace}}.
+
$ gsettings set org.mate.caja.desktop network-icon-visible false
  
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'''.
+
Hide trash icon:
  
* Alternatively you can specify the desired window manager in dconf:
+
$ gsettings set org.mate.caja.desktop trash-icon-visible false
  
$ dconf write /org/mate/desktop/session/required-components/windowmanager "'mywindowmanager'"
+
Hide mounted volumes:
  
replace "mywindowmanager" with the name of the window manager of your choice e.g. ''openbox'' or ''metacity''.
+
$ gsettings set org.mate.caja.desktop volumes-visible false
  
* Killing MATE's window manager (marco) and starting your prefered one (this method is not recommended!)
+
Replace {{ic|false}} with {{ic|true}} for the icons to reappear.
  
Edit your .xinitrc as follow:
+
=== 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''
  
exec mate-session
+
;Using MATE session autostart
killall marco
+
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 {{ic|''wm-name'' --replace}}.
exec mywindowmanager
+
  
and replace "mywindowmanager" with the name of the window manager of your choice.
+
=== Prevent Caja from managing the desktop ===
  
{{note|This method is relevant only for those who start the MATE session using the {{ic|startx}} command. Users of display managers will need to use one of the previous two methods.}}
+
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 ===
 
=== 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.
  
=== Change window placement of new windows ===
+
=== Auto open file manager after drive mount ===
  
By default, new windows are placed in the top-left corner. To center new windows on creation, edit the org.mate.marco.general.center-new-windows key:
+
By default, MATE automatically opens a new file manager window when a drive is mounted. To disable this:
  
  $ dconf write /org/mate/marco/general/center-new-windows true
+
  $ gsettings set org.mate.media-handling automount-open false
  
=== Lock screen & default background image ===
+
=== Screensaver ===
  
Edit {{ic|/usr/share/glib-2.0/schemas/org.mate.background.gschema.xml}} under root and change the default in element, {{ic|<key type&#61;"s" name&#61;"picture-filename">}}. For example:
+
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}}.
  
{{bc|
+
=== Spatial view in Caja ===
    <key type&#61;"s" name&#61;"picture-filename">
+
      '''<default>'/usr/share/archlinux/wallpaper/archlinux-underground.jpg'</default>'''
+
      <summary>Picture Filename</summary> 
+
      <description>File to use for the background image.</description>
+
    </key>
+
}}
+
  
The original image used is {{ic|/usr/share/backgrounds/mate/desktop/Stripes.png}}.
+
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
  
Then, re-compile the schemas:
+
=== Change font DPI setting ===
  
# glib-compile-schemas /usr/share/glib-2.0/schemas/
+
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''.
  
Restart your X session for the change to effect.
+
=== Change applications menu icon ===
  
=== Styling Qt applications ===
+
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.
  
To make Qt4 applications inherit the MATE theme, do the following:
+
=== Panel speed settings ===
  
* Navigate to ''System -> Preferences -> Qt4 Config'' or execute {{ic|qtconfig-qt4}} from a shell.
+
;Hide/Unhide delay
* Change '''GUI Style''' to {{ic|GTK+}}.
+
To adjust the amount of time it takes for the panel to disappear or reappear when autohide is enabled, execute the following:
* ''File --> Save''.
+
$ 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.
  
See [[Uniform Look for Qt and GTK Applications]] for more details.
+
;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'"}}.
 +
 
 +
== 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. {{ic|~/.scripts/compositing.sh}}:
 +
 
 +
{{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>}}
 +
 
 +
and then create a custom keyboard shortcut that executes the file, e.g. {{ic|Ctrl+Alt+C}}, to {{ic|sh ~/.scripts/compositing.sh}}.
 +
 
 +
=== Vertical sync for compositing ===
 +
 
 +
''marco'' does not support vertical synchronization via ''OpenGL'', which may cause video tearing with enabled compositing. [https://github.com/mate-desktop/marco/issues/91] Consider a different [[composite manager]] with OpenGL support such as [[Compton]].
  
 
=== Consistent cursor theme ===
 
=== Consistent cursor theme ===
  
To ensure a consistent cursor theme edit {{ic|~/.icons/default/index.theme}} to include:
+
See [[Cursor themes#Desktop environments]].
  
[Icon Theme]
+
=== Use of gradient backgrounds with LightDM ===
Inherits=mate
+
  
== Where does the name come from? ==
+
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
 +
 
 +
$ 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
 +
 
 +
$ 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|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]].
 +
 
 +
=== MATE Screensaver background cannot be changed ===
 +
 
 +
Due to a [https://github.com/mate-desktop/mate-screensaver/issues/55 bug] in MATE Screensaver, it is only possible to change the MATE Screensaver background by changing the default background image using a gsettings override. 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/
  
The name ''"MATE"'', pronounced ''Ma-Tay'', comes from yerba maté, a species of holly native to subtropical South America. Its leaves contain caffeine and are used to make infusions and a beverage called mate.
+
Finally, restart your X session for the change to effect.
  
== Useful references ==
+
== See also ==
  
 
* [http://mate-desktop.org MATE homepage]
 
* [http://mate-desktop.org MATE homepage]
 
* [http://wiki.mate-desktop.org/archlinux_custom_repo MATE wiki for Arch Linux]
 
* [http://wiki.mate-desktop.org/archlinux_custom_repo MATE wiki for Arch Linux]
* [http://mate-desktop.org/gallery/1.6/ ''MATE desktop screenshots'']
+
* [http://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 11:32, 30 November 2016

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
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.

  • Caja Actions — An extension for Caja which allows arbitrary programs to be launched via context menu.
https://github.com/raveit65/caja-actions || caja-actions
  • 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
  • TopMenu (GTK+) — MATE panel applet for a global menubar.
https://git.javispedro.com/cgit/topmenu-gtk.git/about/ || topmenu-gtkAUR

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 mate-gtk3 and mate-extra-gtk3 groups. While it works mostly, there are few known issues with caja, eom, marco, mate-control-center, mate-netbook, mate-notification-daemon, mate-panel and pluma.

MATE unstable

Consider the following community efforts, cf. forum:

Starting MATE

Choose MATE from the menu in a display manager of choice. The MATE team recommends LightDM as the display manager.

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.

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-hacks 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'".

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

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.

MATE Screensaver background cannot be changed

Due to a bug in MATE Screensaver, it is only possible to change the MATE Screensaver background by changing the default background image using a gsettings override. The full list of configuration options can be found in /usr/share/glib-2.0/schemas/org.mate.background.gschema.xml, they are overridden by creating the file /usr/share/glib-2.0/schemas/mate-background.gschema.override.

Note: The values on the right must be enclosed in single quotes ('') otherwise an error will occur during re-compile.

Example #1: Change the background image of the lock screen:

/usr/share/glib-2.0/schemas/mate-background.gschema.override
[org.mate.background]
picture-filename='/path/to/the/background.jpg'

Example #2: Change the lock screen to use a gradient:

/usr/share/glib-2.0/schemas/mate-background.gschema.override
[org.mate.background]
color-shading-type='vertical-gradient'
picture-options='scaled'
picture-filename=''
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.

See also