Jump to content

Sxmo: Difference between revisions

From postmarketOS Wiki
S0p0st (talk | contribs)
m (external) install guide & user guide links are dead
Fix dead link.
Line 17: Line 17:
== Usage ==
== Usage ==


User graphical interface controlled by gestures and hardware buttons. Refer to the [https://git.sr.ht/~mil/sxmo-docs/tree/master/USERGUIDE.md user guide] [dead link] for detailed usage instructions.
User graphical interface controlled by gestures and hardware buttons. Refer to the [https://man.sr.ht/~anjan/sxmo-docs/USERGUIDE.md user guide] for detailed usage instructions.


Note that Sxmo is designed for the Pinephone, so don't expect everything to work well on any device out of the box. However, Sxmo is open to contributions that would help to extend portability, see [https://todo.sr.ht/~mil/sxmo-tickets/207 this issue]. See below for how to improve functionality on other devices.
Note that Sxmo is designed for the Pinephone, so don't expect everything to work well on any device out of the box. However, Sxmo is open to contributions that would help to extend portability, see [https://todo.sr.ht/~mil/sxmo-tickets/207 this issue]. See below for how to improve functionality on other devices.

Revision as of 20:43, 4 November 2021

Sxmo
Sxmo homescreen.
Sxmo homescreen.
Name Sxmo
Graphics stack dwm on X11/Xorg
Toolkit suckless tools (dwm, dmenu, st, etc)
In postmarketOS
Package postmarketos-ui-sxmo
Status Available

Sxmo, or Simple X Mobile, is a collection of simple and suckless X programs and scripts used together to create a fully functional mobile UI adhering to the Unix philosophy for the Pinephone.

Installation

You can download an installer image or prebuilt image [herehttp://postmarketos.org/download/]

pmbootstrap config ui sxmo

Alternatively, you may download a PostmarketOS image with Sxmo preinstalled (equivalent to running pmbootstrap init and selecting pinephone and sxmo as the interface): [1] [dead link]

Usage

User graphical interface controlled by gestures and hardware buttons. Refer to the user guide for detailed usage instructions.

Note that Sxmo is designed for the Pinephone, so don't expect everything to work well on any device out of the box. However, Sxmo is open to contributions that would help to extend portability, see this issue. See below for how to improve functionality on other devices.

Components

Default installation consist of:

  • dwm — window manager,
  • dmenu — menu system,
  • lisgd — gesture daemon,
  • svkbd — virtual keyboard,
  • feh — wallpaper,
  • conky — desktop clock,
  • clickclack — audio/vibration feedback on keypress,
  • st — simple terminal,

State on other devices

Basic functionality forks well out of the box on almost any mainline device. However, there are some things that are still have to be generalised, like:

  • Vibration (sxmo_vibratepine doesn't work on msm8916 even if correct path to vibrate device is set)
  • Sound control (need to get it completly universal instead of hardcoding alsa devices)

Fonts on devices with smaller screens can be configured using the variables dmenu.font, dwm.font, st.font and svkbd.font in the file ~/.Xresources. The positioning of the xdm login greeter can be configured with the xlogin*geometry line of the file /etc/X11/xdm/Xresources.

Pictures

See also