MATE

MATE is a desktop environment forked from the maintained code base of GNOME 2. It is installable on postmarketOS. However, it's less touch-friendly and configurable than Xfce4.

Installation
Run  and choose   in the interface section.

Additional software can be added at  in step "Extra packages" or later on by , see also MATE.

Panel

 * Increase the panel size by right-clicking it in an empty area, preferences, raise size, close. Default size is 24.
 * On small screens, the workspace switcher in the lower right corner is hard to click. A tweak to increase the size: Right-click the workspace switcher (for how-to see MATE), click Preferences, double-click the first workspace name and change it to e.g. "- 1 -", change the second to "- 2 -" etc., finally check "Show workspace names in switcher". Pure spaces before/after the numbers are ignored, therefore a sign like the dash is needed. Between the number and the dashes, one or more spaces can be placed to "adjust" the size. Unfortunately, when showing the wokspace names, there is no miniature view of the windows placed on the workspaces.
 * When yellow comment labels like e.g. "Click to view month calender" remain visible due to some combination of clicks, a right-click on the according item (in this example on the clock) helps to get rid of the label.
 * The classic menu with categories "Applications, Places, System" can be replaced by a more compact menu (remove the classic menu by right-click, add the classic menu by right-click, move the icon by right-click). The more advanced menus "Brisk Menu" (screenshot) and "MATE menu" (screenshot) aren't packaged in Alpine Linux, unfortunately.
 * The default battery icon doesn't show the percentage. Here are two possibilities how to add this information. If you have a small screen and space in the panel is limited, richt-click the clock, preferences, uncheck "show the date".
 * Recommended: Right-click the upper panel in an empty area, add to panel, command, add, close, right-click the newly clock-looking icon, preferences, enter command  (adapt the battery path to your device), set the interval to e.g. 30 seconds, close, right-click the three dots left of the speaker icon (hard to hit), uncheck "lock to panel", right-click the new percentage icon, move, click on the clock (percentage icon jumps next to the clock), right-click the percentage icon, lock to panel, right-click the three dots left of the speaker icon, lock to panel.
 * Alternatively (might look better on increased panel size): Install packages  and , right-click the upper panel in an empty erea, add to panel, indicator applet complete, add, close, log out (system -> logout user), log in (happens automatically by default), there should be a new battery icon, open a terminal and enter the command   (if doing this via ssh, prepend  ), now there should be the percentage next to the new battery icon, go to system -> preferences -> hardware -> power management -> tab general -> choose "never display an icon" (this disabled the default battery icon), right-click the three dots left of the speaker icon (hard to hit), uncheck "lock to panel", right-click the new battery icon, move, click on the clock (new battery icon jumps next to the clock), right-click the new battery icon, lock to panel, right-click the three dots left of the speaker icon, lock to panel.
 * The timezone of the clock can be changed in the terminal by command like . Available timezones can be looked up at  . Thereafter, log out to update the time.

Appearance

 * To change the system font size, go to System -> Preferences -> Look and Feel -> Appearance -> tab Fonts. Default font size is 10. Besides changing the font size there directly, an alternative might be to click the "Details" button in the lower richt corner, uncheck automatic resolution detection and increase the "dots per inch" value (untested).
 * Font size in the terminal can be changed by Edit -> Profile Preferences -> in tab "General" uncheck "Use the system fixed width font", thereafter click the font button below and change the size.
 * The top right window buttons can be modified in System -> Preferences -> Look and Feel -> Appearance -> button "Customize" -> tab "Window Border". You can use the keyboard up/down keys to check out one by one. Default window border ist "Menta".
 * For a more modern set of icons install package . Change the icons by System -> Preferences -> Look and Feel -> Appearance -> button "Customize" -> tab "Icons" -> choose "MATE-Faenza". Default set of icons is "Menta".

Display
Follow the Display guide to optionally change it to landscape mode by default or fix display related issues.

Auto-rotation is not implemented natively in MATE. On the page Auto-rotation there are some scripts listed that can provide this functionality. There is also a simple script that can be triggered manually, thus doesn't need a working accelerometer sensor.

When rotating the screen with xrandr, there seems to be an issue with the screen update. It doesn't cleanly update across the entire area of the wallpaper. Not sure if this is device-specific.

Input

 * To simulate right mouse clicks with the touchscreen, long-click the return key of the onboard keyboard to get some mouse click options at the right side of the keyboard. For other possibilities of right mouse click emulation, see Input_methods.
 * Clicking the onboard icon in the panel shows or hides the virtual keyboard. In the settings of onboard, a bigger floating icon for show/hide can be enabled.
 * If you can't grab something by touchscreen, use the keyboard (tab key to go through the elements, arrow keys to choose).
 * Hiding the cursor is done by autostart command  (just for information).

Lock screen
The screen lock kicks in when the screen saver gets active. For unlocking, onboard keyboard with layout "Phone" is called.

For devices with a hardware keyboard, this is unfavorable. The virtual keyboard can be disabled by command.

For touch devices with bigger screen, the layout can be changed to e.g. "Compact" by. For more options of the onboard command see e.g. debian manpage.

The onboard keyboard takes quite some time to show up when unlocking. Alternatively,  can be installed and then applied by. However, it's not as configurable as the onboard keyboard.

When the screen is locked, inputs like the touchscreen or volume buttons are still active, waking up the screen. There is an experimental draft script how the inputs can be disabled: Screen_locker:Disable_inputs. The script needs to be adapted to your device. Also please note that this script might not work reliable.

LightDM
Autologin is configured by default. If you want to use LightDM as a login screen, see Display_manager how to set this up.

Disk management
With the set of installed software, additional drives are not shown in the file manager. Install package  to make them available. (For more information see also pmaports#1377.)

As a graphical interface for formatting drives or image writing, e.g. package  can be installed (this installs   as well). After installation, it's at Accessories -> Disks.

Bluetooth
For bluetooth management package  is installed.

The tray icon needs right-clicking (for right-clicking see MATE above). Alternatively use System -> Preferences -> Hardware -> Bluetooth Manager and Bluetooth Adapters, and  or   respectively to enable/disable (on new edge installations, "sudo" isn't needed anymore due to   integration).

When hitting the "Search" button in the Blueman window, it searches 30 seconds for other Bluetooth devices. Often those 30 seconds are not enough to detect other devices, which is a bit frustrating. Just keep klicking "Search" several times, keep patient, at some point your target device should show up. If it doesn't work at all, try command  in the terminal with the Blueman window opened in parallel, it's more "efficient", and exit the command with Ctrl+C after having the devices connected.

Audio routing should work automatically. Changing the audio output manually can be done in Applications -> Sound & Video -> Sound -> tab "Output" -> "Choose a device for sound output". (On older installations, the audio output can be changed at System -> Sound & Video -> PulseAudio Volume Control -> Output Devices -> click the check button at the device you want to use.)

To make your device discoverable, right-click the try icon and choose "Make Discoverable". This is just temporary. To make it permanently discoverable, right-click the tray icon -> Adapters -> choose "Always". In this window you can also choose the name to identify your device.

If Bluetooth isn't available, consult Bluetooth.

Additional software

 * to make "removable" drives available.
 * As a browser, install e.g.  or  . To enable touch screen behaviour, add a new file   and write , in   change   from 2 (default, auto-detect) to 1 (enabled). For better touch screen usability, install package   (more information).
 * For phone applications, try,   and  , which are used in Phosh. Package   needs to be installed (gets installed automatically with these packages), start the service by  , add it permanently by   and reboot.
 * To view PDF files, install package, for alternatives see PDF.
 * Graphical interface for formatting drives or writing images e.g..
 * to investigate sound issues, it contains commands,  ,  , which are helpful.