Difference between revisions of "MATE"

From postmarketOS
Jump to: navigation, search
(Update Installation steps, added the status and the steps for landscape mode)
Line 1: Line 1:
[[File:MATE drebrez.jpg|thumb]]
+
{{Infobox interface
 +
| image = File:MATE drebrez.jpg
 +
| imagecaption = MATE running on Samsung Galaxy S Advance (i9070)
 +
}}
 +
 
 
MATE is a desktop environment forked from the maintained code base of GNOME 3.  It is installable on postmarketOS.<br>
 
MATE is a desktop environment forked from the maintained code base of GNOME 3.  It is installable on postmarketOS.<br>
== Install MATE Desktop ==
+
 
{{note|This is a draft, installation will be as easy as selecting "mate" in pmbootstrap init, once a postmarketos-ui-mate package is created with the information from below. Contributions welcome - it is not that hard, simply look at the other postmarketos-ui- packages and make a PR.}}
+
== Status ==
Install your X11 video drivers and do:
+
 
 +
It works on most devices with a working display, works fine without hardware acceleration.
 +
 
 +
After the postmarketOS loading splashscreen you will get a black screen for 20-30 seconds before the desktop appears.
 +
This seems due to an issue with <code>marco</code> (MATE window manager):
 
<pre>
 
<pre>
sudo su
+
mate-session[1377]: WARNING: Application 'marco.desktop' failed to register before timeout
apk update
 
apk add xorg-server xf86-input-libinput libinput
 
 
</pre>
 
</pre>
Now let us install a bunch of needed packages what includes all MATE Desktop packages avaliable in the repository:
+
 
 +
== Install MATE Desktop ==
 +
Run <code>pmbootstrap init</code> and choose <code>mate</code> in the interface section.
 +
The Alpine repository already contains all the packages for x86_64, armhf and aarch64 architectures.
 +
Nothing has to be done to enable it.
 +
 
 +
After installation, the shell will automatically launch upon boot. If it doesn't, have a look at <code>/etc/profile.d/start_mate.sh</code> script.
 +
 
 +
For the official MATE instructions, see [https://wiki.alpinelinux.org/wiki/MATE their website].
 +
 
 +
== Troubleshooting ==
 +
 
 +
Check the logs with <code>logread -f | grep x11</code>
 +
 
 +
== Landscape mode ==
 +
 
 +
=== Rotate the screen ===
 +
 
 +
You can rotate adding the following configuration file: <code>/etc/X11/xorg.conf.d/00-fbdev-rotate.conf</code>
 
<pre>
 
<pre>
apk add desktop-file-utils gtk-engines consolekit gtk-murrine-engine caja caja-extensions marco dbus-x11 lxdm hicolor-icon-theme
+
Section "Device"
mate_pkgs=$(apk search mate -q | grep -v '\-dev' | grep -v '\-lang' | grep -v '\-doc')
+
  Identifier "LCD"
apk add $mate_pkgs
+
  Driver "fbdev"
ln -s /usr/etc/xdg/menus/ /etc/xdg/menus
+
  Option "Rotate" "CW"
 +
EndSection
 
</pre>
 
</pre>
In the next step we add some services to start up with the operating system:
+
 
<pre>
+
=== Rotate the touchscreen ===
rc-update add lxdm
+
In order to also rotate the touchscreen you need to change the udev rule: <code>/etc/udev/rules.d/90-device-samsung-i9070.rules</code>
</pre>
+
And add one of the following line:
Adding avaliable True Type Fonts:
 
<pre>
 
ttfs=$(apk search -q ttf- | grep -v '\-doc')
 
apk add $ttfs
 
</pre>
 
Configure lxdm with autologin:
 
<pre>
 
nano /etc/lxdm/lxdm.conf
 
autologin=yourusername
 
session=/usr/bin/mate-session
 
skip_password=1
 
</pre>
 
And finally, reboot the device and you should be auto logged into MATE. If you see just a black screen try rebooting again - Mate should load.
 
 
<pre>
 
<pre>
sync
+
# Left - 90 degree clockwise
reboot
+
ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"
 +
# 180 degree clockwise
 +
ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"
 +
# Right - 270 degree clockwise
 +
ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"
 +
# reflect along y axis
 +
ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 1 0 0"
 
</pre>
 
</pre>
=== Calibrating the touchscreen ===
+
and reboot udev or the device.
  
If you want to rotate the screen change/add a value in this file and reboot udev or the device:
 
<pre>
 
sudo nano /etc/udev/rules.d/90-android-touch-dev.rules
 
</pre>
 
<pre>
 
ENV{ID_INPUT}="1", ENV{ID_INPUT_TOUCHSCREEN}="1", \
 
# default ENV{LIBINPUT_CALIBRATION_MATRIX}="1 0 0 0 1 0"
 
# Left - 90 degree clockwise ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"
 
# 180 degree clockwise ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"
 
# Right - 270 degree clockwise ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"
 
# reflect along y axis ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 1 0 0"
 
</pre>
 
 
[[Category:Interface]]
 
[[Category:Interface]]

Revision as of 11:54, 4 January 2018

MATE running on Samsung Galaxy S Advance (i9070)
MATE running on Samsung Galaxy S Advance (i9070)

MATE is a desktop environment forked from the maintained code base of GNOME 3. It is installable on postmarketOS.

Status

It works on most devices with a working display, works fine without hardware acceleration.

After the postmarketOS loading splashscreen you will get a black screen for 20-30 seconds before the desktop appears. This seems due to an issue with marco (MATE window manager):

mate-session[1377]: WARNING: Application 'marco.desktop' failed to register before timeout

Install MATE Desktop

Run pmbootstrap init and choose mate in the interface section. The Alpine repository already contains all the packages for x86_64, armhf and aarch64 architectures. Nothing has to be done to enable it.

After installation, the shell will automatically launch upon boot. If it doesn't, have a look at /etc/profile.d/start_mate.sh script.

For the official MATE instructions, see their website.

Troubleshooting

Check the logs with logread -f | grep x11

Landscape mode

Rotate the screen

You can rotate adding the following configuration file: /etc/X11/xorg.conf.d/00-fbdev-rotate.conf

Section "Device"
  Identifier "LCD"
  Driver "fbdev"
  Option "Rotate" "CW"
EndSection

Rotate the touchscreen

In order to also rotate the touchscreen you need to change the udev rule: /etc/udev/rules.d/90-device-samsung-i9070.rules And add one of the following line:

# Left - 90 degree clockwise
ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"
# 180 degree clockwise
ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"
# Right - 270 degree clockwise
ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"
# reflect along y axis
ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 1 0 0"

and reboot udev or the device.