sxmo(7)

NAME ¶

sxmo - a simple X mobile operating system

SYNOPSIS ¶

Sxmo is a collection of simple and suckless programs and scripts used together to create a fully functional mobile user interface adhering to the Unix philosophy. We focus on Linux smartphones such as the Pinephone. Sxmo is primarily written in POSIX shell scripts and can be easily modified, customised and extended using our hook system.

Sxmo provides an interface that is notably different from most other mobile interfaces, especially in the degree of customisability, so reading this manual is strongly recommended.

DESCRIPTION ¶

Sxmo runs both on Wayland (using sway(1)) as well as on Xorg (using dwm(1)). The X in our name historically referred to Xorg, but is now open to whatever interpretation you prefer (eXtensible, eXcellent, eXperimental, etc...)

All POSIX shell scripts provided by sxmo comply to the naming pattern sxmo_*.sh and and most can be found in your /usr/bin/ directory. Hooks, a central feature of sxmo, are named sxmo_hook_*.sh and a specifically designed to be editable by users. See HOOKS.

INITIALIZATION ¶

Sxmo is typically started via tinydm(1), which launches the window manager of your choice (sway(1) or dwm(1)) by invoking sxmo_winit.sh or sxmo_xinit.sh, respectively. Both scripts wrap around a shared sxmo_init.sh. The entry points sxmo_winit.sh and sxmo_xinit.sh are represented by .desktop files in /usr/share/wayland-sessions/ or /usr/share/xsessions. This implies you also can use use any other display manager that reads from there. You may want to consider another display manager if your device is a multi-user device.

tinydm(1) is a tiny automatic login manager for single user machines, meaning it has no password prompt. For security we always recommend setting up full disk encryption on your device. A password prompt like unl0kr(1) is then provided at boot time to unlock disk encryption and unauthorized users have no access to the system.

Note: You can configure the UID in /etc/conf.d/tinydm (on systems using openrc), or using systemctl edit tinydm.service (on systems using systemd). Make sure to change this if you create a custom user. You may switch between the two window managers in the Power Menu if you installed both.

Once the window manager launches, it will execute sxmo_hook_start.sh. Sxmo relies on superd(1) to launch various services from this start hook. See SERVICES. You can edit the start hook to start additional services.

You can edit ~/.config/sxmo/profile to override certain common environmental variables such as background image. This will be loaded for every shell environment. See ENVIRONMENT.

Note that sxmo respects the xdg specification, e.g., $XDG_CACHE_HOME, $XDG_CONFIG_HOME, etc.

HOOKS: sxmo_hook_start.sh (what executes on startup) sxmo_hook_wallpaper.sh (give the displayed wallpaper file path)

SEE ALSO: tinydm(1), superd(1)

LOGGING ¶

As soon as the system initialiazes, the following logs will be available in your $XDG_STATE_HOME directory, which usually corresponds to ~/.local/state/:

sxmo.log

The central log for Sxmo. Various scripts output a message here via the sxmo_log function provided by sxmo_common.sh.

tinydm.log

Contains standard error output from various programs running in your sessions if you are using tinydm(1).

superd.log

Logs the start of various sxmo (and other) background processes.

SERVICES ¶

Sxmo starts various background services, depending on your device and configuration. An overview of can be obtained by running superctl status.

bonsaid

bonsaid manages the logic for the hardware buttons, and invokes sxmo_hook_inputhandles.sh on presses.

dunst

dunst(1) is our notification daemon for Xorg.

geoclue-agent

Proxy location data to map applications.

mako

mako(1) is our notification daemon for Wayland.

mmsd-tng

mmsd-tng(1) manages incoming MMS messages.

pipewire

pipewire(1) is a media server.

pulseaudio

pulseaudio(1) is a sound server.

sxmo_autosuspend

Manages automatic suspension after a certain idle time.

sxmo_bg

Sets the wallpaper, invokes sxmo_hook_wallpaper.sh to obtain the wallpaper filename.

sxmo_battery_monitor

This script monitors the battery status using upower(1) and ensures the status bar is updated accordingly.

sxmo_conky

Starts conky (desktop widget)

sxmo_desktop_widget

Starts the desktop widget via sxmo_hook_desktop_widget.sh .

sxmo_hook_lisgd

Invokes sxmo_hook_startlisgd.sh with launches the gesture daemon.

sxmo_menumode_toggler

Configures hardware buttons for sway in menus.

sxmo_modemmonitor

The modemmonitor observes the modem for incoming calls, texts and other status changes. It is powered by mmcli(1) and dbus_monitor(1) and required to receive calls and texts. It can be toggled via the Config Menu.

sxmo_networkmonitor

The network monitor looks out for new wifi/mobile connections. It is powered by nmcli(1) and dbus_monitor(1).

sxmo_notificationmonitor

Monitors for notifications and dispatches them to the notification daemon (sxmo_notifs.sh monitor)

sxmo_soundmonitor

Monitors audio setup changes and updates the status bar accordingly.

sxmo-x11-status

This periodically sets the status bar content on Xorg.

sxmo_xob

A lightweight overlay volume/backlight/progress/anything bar for Xorg

sxmo_wob

A lightweight overlay volume/backlight/progress/anything bar for Wayland

unclutter

Hides the mouse pointer when not in use.

vvmd

vvmd(1) is a lower-level daemon to receive visual voicemail.

wireplumber

Session/policy manager for pipewire(1).

HOOKS ¶

A lot of functionality is also contained in hooks (sxmo_hook_*.sh). Hooks are associated with certain events, such as starting the system, receiving a call, or opening menu. They are called by the core system, or other hooks.

Sxmo uses $PATH to determine which hook executes. It will look first for user-provided hooks in ~/.config/sxmo/hooks/ before it looks in /usr/share/sxmo/default_hooks/ for the system defaults. For example, if you pickup a call and ~/.config/sxmo/hooks/sxmo_hook_pickup.sh does not exist, /usr/share/sxmo/default_hooks/sxmo_hook_pickup.sh will be run.

Hooks (and configuration files) are versioned with a version hash in a comment. After upgrading your installation you are asked to run sxmo_migrate.sh(1) to consolidate any new changes from our side with your own modifications. See UPDATING.

Note that some hooks are in a device-specific subdirectory under the hooks/ main directory. This allows you to have hooks associated with a certain device. See DEVICES. For instance, in /usr/share/sxmo/default_hooks/ there are several device subdirectories, one of which will be your $SXMO_DEVICE_NAME. Device-specific hooks go here and these take presendence over the more generic hooks.

While you can manually copy and edit hooks to your liking, sxmo_hookmenu.sh (MENU > config > hooks) simplifies this process.

Note also that hooks do not have their own man pages. We have documented each hook in the comment header of that hook, that also explains possible parameters that are provided to the hook. A list of all available hooks in alphabetical order is provided below:

sxmo_hook_apps.sh

Runs when display of the App menu is requested. Allows you to override the apps displayed.

sxmo_hook_block_suspend.sh

Runs when the system wants to suspend and contains rules that check whether suspension may happen or should be blocked because certain programs are active.

sxmo_hook_call_audio.sh

Runs phone successfully enables/disables callaudio mode.

sxmo_hook_contextmenu.sh

Runs when a menu is loaded and an application is active. This hook defines all the context menus. You may override or add menus for applications here.

sxmo_hook_desktop_widget.sh

Runs when the system starts to launch a desktop widget. Used to display the clock via conky(1).

sxmo_hook_discard.sh

Runs asynchronously when you discard an incoming call. Stops the ringing hook.

sxmo_hook_hangup.sh

Runs when the user ends an incoming call.

sxmo_hook_icons.sh

Runs every time we load a script, you can override icons here.

sxmo_hook_inputhandler.sh

Runs when a gesture is to be interpreted. This defines all kinds of actions that may be triggered by gestures.

sxmo_hook_lisgdstart.sh

Runs when start of the gestured daemon (lisgd(1)) is requested. This hook allows defining custom gestures.

sxmo_hook_lock.sh

Runs when the system enters a locked state where typically the screen is still on but input is off. This is NOT the state lockers like peanutbutter(1) use.

sxmo_network_down.sh

Runs after disconnecting from a network. Called by sxmo_networkmonitor.sh .

sxmo_network_up.sh

Runs after connecting to a new network. Called by sxmo_networkmonitor.sh .

sxmo_hook_network_pre_down.sh

Runs when a network prepares to go down. Called by sxmo_networkmonitor.sh .

sxmo_hook_network_pre_up.sh

Runs when a network prepares to go up. Called by sxmo_networkmonitor.sh .

sxmo_hook_notification.sh

Runs when a notification is received. Runs once for each notification. May be used for forwarding the notification over a network. Called by the notification monitor (sxmo_notifs.sh monitor).

sxmo_hook_notifications.sh

Runs when the number of the notifications changes, i.e. a new one comes in or they are all cleared. This is used for generic things like enabling a LED or playing a sound. Called by the notification monitor (sxmo_notifs.sh monitor).

sxmo_hook_missed_call.sh

Runs when an incoming call was missed (not picked up). Stops the ringing hook. Called by the modem monitor (sxmo_modemmonitor.sh).

sxmo_hook_modem.sh

Runs when the modem changes state, used for example to pop up the PIN entry menu. Can be overridden to provide a PIN automatically. Called by the modem monitor (sxmo_modemmonitor.sh).

sxmo_hook_mute_ring.sh

Runs when the user requests to mute an incoming call. Stops the ringing.

sxmo_hook_pickup.sh

Runs when the phone accepts an incoming call. This is used to stop the ringing.

sxmo_hook_postwake.sh

Runs after waking for suspension.

sxmo_hook_scripts.sh

Runs when display of the Scripts menu is requested. Allows you to override the scripts displayed.

sxmo_hook_sendsms.sh

Runs after you just sent a text message.

sxmo_hook_sms.sh

Runs when a message (sms/mms/vmm) is received.

sxmo_hook_restart_modem_daemons.sh

Runs when a restart of the modem is requested.

sxmo_hook_ring.sh

Runs asynchronously when the phone receives an incoming call and is used to play a ring tone. It is stopped again by other hooks (sxmo_hook_pickup.sh , sxmo_hook_discard.sh, sxmo_missed_call.sh, sxmo_hook_mute_ring.sh) and called by the modem monitor (sxmo_modemmonitor.sh).

sxmo_hook_rotate.sh

Runs just after the screen was rotated (explicitly).

sxmo_hook_start.sh

Runs upon system start in order to start various background services.

sxmo_hook_statusbar.sh

Runs to update one of the components of the statusbar

sxmo_hook_stop.sh

Runs after the system has been stopped in order to do some cleanup.

sxmo_hook_suspend.sh

Runs when the system suspends, the actual suspension call is in here.

sxmo_hook_tailtextlog.sh

Runs when viewing incoming text messages for a given contact.

sxmo_hook_unlock.sh

Runs when the system becomes unlocked again. This state is NOT the state that screen lockers like peanutbutter(1) enter after unlocking.

In further sections in this documentations, all hooks relevant to the topic in question will be mentioned.

SEE ALSO: sxmo_migrate.sh(1)

STATUSBAR ¶

The bar located at the top of the screen displays the various workspaces that you have available. These come the form of the numbers 1,2,3,4 (inactive workspaces are not shown). Tapping one of these numbers will take you to that workspace. If you are running dwm rather than sway, you will see right next to it the layout that is activated. The default layout is a vertical stack (three lines). On sway you may see a dedicated input mode indicated with a red background, such as "menu" when you open a menu. The center of the bar the title of the active window.

The right part of the bar is the statusbar, powered by sxmobar(1). It presents status icons for the following:

• GSM modem state icon (i.e. what state modemmanager reports, e.g. registered, initializing, etc.)
• GSM network type icon (e.g. 2g, 3g, etc.).
• GSM network strength icon.
• Wifi icon (representing strength).
• Battery icon (representing strength).
• Microphone icon (enabled or disabled).
• Sound icon (or headphone).
• An icon also represents what "state" the device is in: unlock (open circle), lock (circle with slash), screenoff (filled circle), or proximity lock (circle with dot)
• Time.

HOOKS: sxmo_hook_statusbar.sh (override look and feel of the statusbar), sxmo_hook_icons.sh (adjust icons)

SEE ALSO: sxmobar(1)

INPUT ¶

The main forms of input are Hardware buttons (power, raise volume, lower volume), Touchscreen (i.e., touching the screen), and Gestures (i.e., swipes). Sxmo also allows input for a Hardware keyboard (e.g., the pinephone keyboard case or a bluetooth keyboard) and a Stylus. Sxmo also supports a virtual keyboard (svkbd(1) on Xorg or wvkbd(1) on Wayland).

MENUS ¶

Menus are a central feature of sxmo and are navigable through using hardware buttons. On three button devices:

• Volume Raise (upper button): Previous item
• Volume Lower (lower button): Next item
• Power: Select item

You can also simply use the touchscreen to tap your selection if you'd like as well.

The menu backend can be configured via the $SXMO_MENU environment variable, which you can set in your ~/.profile. Supported menu backends are:

• dmenu (only for Xorg)
• bemenu
• wofi (Wayland only)

All are mediated via sxmo_dmenu.sh(1).

Note that you can also make full use of the menu system when you are connected over SSH, just run sxmo_appmenu.sh(1) to start the main menu! When running in the tty, bemenu will always serve as backend.

In addition to a Main Menu, each application can have its own Context Menu associated with it which defines functions unique to that application (e.g., zoom in, zoom out, etc.).

If no application is focused, swiping down from the top of the screen, or pressing the volume raise button once, will bring up the Main Menu. If an application is focused, this will bring up the application's Context Menu instead. (To access the Main Menu while an application is focussed, press the volume raise button twice.)

You can close any open menu with a gesture: swipe straight up (vertically) onto the top edge of the screen and all the open menus will close. See INPUT.

HOOKS: sxmo_hook_apps.sh (what shows up on Apps submenu), sxmo_hook_scripts.sh (what shows up in Scripts submenu), sxmo_hook_contextmenu.sh (controls the content of all the menus, including contextmenus), sxmo_hook_icons.sh (icons)

$icon_wtr Weather ^ 0 ^ sxmo_terminal.sh -f "Sxmo:size=5" sh -c "curl http://wttr.in/ | less -SR"

# title="$icon_glb My World"

WINDOW MANAGEMENT ¶

Sxmo uses tiling window managers such as sway(1) and dwm(1). This makes a particularly good fit on mobile devices where screen estate is sparse, as windows are automatically laid out to make maximum use of the available space.

Window management is done using menus. When you do a long press on the volume up hardware button, the window management menu will pop up and allow to switch layouts when multiple windows are open, and to close windows.

Windows can also be conveniently closed via a quick gesture; move with two fingers down onto the bottom edge of the screen to close the focussed window. Focussing windows is done by simply tapping them on the touchscreen.

STATES AND SUSPENSION ¶

Sxmo recognizes five basic states:

• Unlocked (unlock): Screen is on; touchscreen is enabled.
• Locked (lock): Screen is on; touchscreen is disabled.
• Screenoff (screenoff): Screen is off; touchscreen is disabled. The led will also blink purple every few seconds to indicate that you are in this state.
• Proximity Lock (proximitylock/unlock): When close to your face, the screen will be off and touchscreen disabled; when far from your face, screen will be on and touchscreen enabled. This is used during phone calls, for instance.
• Suspend: The device is asleep in a low-power mode.

A schema illustrates the transition between states:

https://man.sr.ht/~anjan/sxmo-docs/schemas/lock-power-states.png

Specific devices may call for specific state workflows:

On desktop systems, which is the default mode if a device is not recognised, there are two states:

• unlock: The default state
• locker: A state that indicates that a session locker is running, preventing any interaction with the environment until it is unlocked with a password.

On e-ink display devices, such e-readers we often only have one state:

• unlock: The screen stays on while the device is suspended, which means that the power button is only a refresh of the suspension idle timeout, and a way to bring back interactivity.

Sxmo will also suspend on most devices, when this feature is available.

• suspend: In this state, the modem will still be active and monitor for incoming calls/texts but everything else will be suspended.

The usual workflow is this.

• If the phone is in the unlock state (default when you boot up) and you wish to suspend it, tap the power button once. This will transition to the screenoff state which will then automatically transition to the suspend state unless something is blocking it.
• If the phone is in the suspend state and you wish to wake it up, tap the power button once (to transition to the lock state) and then tap it once again to transition to the unlock state. (This prevents accidental wakeups in the pocket.)

Sxmo also handles automatic transitions from some states to others.

• It will automatically transition from unlock to screenoff after a certain amount of idleness (120s).
• It will automatically transition from lock to screenoff after a certain amount of time (8s).
• It will automatically transition from screenoff to suspend immediately unless something is blocking it.

You can set up suspend blockers in the sxmo_hook_block_suspend.sh hook.

HOOKS: sxmo_hook_postwake.sh (what to do after waking up from suspend state), sxmo_hook_lock.sh (what to do when transitioning into lock state), sxmo_hook_screenoff.sh (what to do when transitioning into screenoff state), sxmo_hook_unlock.sh (what to do when transitioning into unlock state), sxmo_hook_block_suspend.sh (which processes should prevent the system from to into suspension),

SEE ALSO: sxmo_wakelock.sh(1)

CRONJOBS ¶

Sxmo ensures that cron jobs run and will actively wake the phone from sleep temporarily to this end. The cron daemon is installed but not enabled in postmarketOS. Cron has to be started manually with rc-service crond start and set to start on boot with rc-update add crond default. We use a little program called mnc(1) to wake the phone up just before the next planned cron job. We also wrap some sxmo logic in sxmo_rtcwake(1) which launches the cronjob and puts the phone back to sleep when finished.

*/15 * * * * sxmo_rtcwake.sh sleep 10

This example will wake the phone up for 10 seconds every 15 minutes.

If you omit sxmo_rtcwake.sh for a job, the system will not wake up from suspension to execute the job. Note that in such cases, you might want to use sxmo_wm.sh execwait instead as this will set most of the sxmo environment variables, e.g.:

*/15 * * * * sxmo_wm.sh execwait sleep 20

HOOKS: sxmo_hook_mnc.sh (change the program that calculates when to wakeup)

SEE ALSO: sxmo_rtcwake.sh(1), mnc(1)

CALLS AND TEXTING ¶

Calling and texting is fully functional and should work out-of-the-box if your device has a support modem. On devices with a hardware switch such as the pinephone or Librem 5, make sure you have the modem killswitch in the enabled position. You may also need to wait a little bit after booting before modem functionality becomes available.

The scripting behind the scenes works via mmcli(1).

mmcli -i 0 --pin 1234

NETWORK CONFIGURATION ¶

The Networks menu (sxmo_networks.sh(1)) provides access various kinds of network configuration.

CONTACTS ¶

The sxmo contacts system is based on a plain TSV file that can be placed at ~/.config/sxmo/contacts.tsv (the actual filename is actually kept in the $SXMO_CONTACTFILE environment variable, here we assume the default). This TSV file is expected to have two tab separated columns: phonenumber, and contactname. Upon receiving a call, if you have a contact stored associated with the incoming number, the contact name will be displayed instead of the number. Contact names will also appear in the Texts and Dialer menus if they are present in the contacts TSV file. If no contacts.tsv is present, or the number is missing from this file; the contact in menus will show up as ???. A contacts.tsv example might look like:

+122345628	John Smith
+128371642	Jeff Foo
+31612345678	Jan Janssen

You may edit the file in an editor of your choice or use the New Contact entry from the Contacts menu.

SEE ALSO: sxmo_contacts.sh(1), sxmo_contactmenu.sh(1)

AUDIO ¶

You can use the Audio Menu (sxmo_audio.sh) to toggle which audio output you want to send sound to. Sxmo uses pipewire(1) and pulseaudio(1). We use callaudiod(1) to route audio during a phone call.

Currently, bluetooth audio during phone calls does not work. Please see:

• https://gitlab.com/mobian1/issues/-/issues/345
• https://gitlab.com/mobian1/callaudiod/-/issues/12

SEE ALSO: sxmo_hook_call_audio.sh (adjust volume after/before a call)

BLUETOOTH ¶

To enable bluetooth, toggle it in Config. A Bluetooth Menu (sxmo_bluetoothmenu.sh) can be chosen from the Main Menu.

UPDATING ¶

Sxmo's packages are typically distributed via your Linux distribution (e.g. postmarketOS). To update run:

sxmo_upgrade.sh

..or just use the menu entry within the Config Menu which does the same. This is a just tiny wrapper that invokes your distribution's package manager.

After you update the sxmo packages themselves, be sure to run sxmo_migrate.sh(1) to guide you through upgrading your (local) config files and hooks, if needed. Your configuration files and hooks may be temporarily stashed away until you complete the migration process. This is so the system can remain fully functional at all times. See sxmo_migrate.sh(1) for further documentation on this.

New releases will be announced on the ~mil/sxmo-announce@lists.sr.ht mailing list. See https://lists.sr.ht/~mil/sxmo-announce for the archives. Mail ~mil/sxmo-announce+subscribe@lists.sr.ht to automatically subscribe.

SEE ALSO: sxmo_migrate.sh(1)

NOTIFICATIONS ¶

When a notification comes in, the status bar will indicate this with an icon, and the menu will have a Notifications entry that also mentioned the number of unread notifications. They can be viewed and cleared through this submenu.

If your device has a green status LED, it will be default be enabled when you have unread notifications.

Notifications are mediated by sxmo_notifs.sh. Whenever a notification comes in or is cleared, then sxmo_hook_notifications.sh will be called with the number of notifications. This puts an icon status in the status bar if there are any notifications. For each specific notification, sxmo_hook_notification.sh is called. This hook can be used, for instance, to forward the notification content over a network.

HOOKS: sxmo_hook_notifications.sh (runs when there is any notification), sxmo_hook_notification.sh (runs once for each notification)

See sxmo_notifs.sh(1)

DEVICES ¶

This section describes how to add a new device to sxmo. If you are instead looking for what devices are suitable to run Sxmo, then check the postmarketOS device page at https://wiki.postmarketos.org/wiki/Devices instead.

When adding a new device, there are three basic steps:

• Determine the $SXMO_DEVICE_NAME
• Add a sxmo_deviceprofile_${SXMO_DEVICE_NAME}.sh file to scripts/deviceprofiles/ in the sxmo-utils source tree. Please send us the patch too.
• Add (or symlink to an existing) SXMO_DEVICE_NAME folder in configs/default_hooks/ in the sxmo-utils source tree.

tr -c '0[:alnum:].,-' '_' < /proc/device-tree/compatible | tr '0' 'n' | head -n1

MISC ¶

This sections explains some smaller miscellaneous aspects of Sxmo.

ENVIRONMENT ¶

Hint: type env to see environmental variables. Environmental variables can be overridden (generally) in ~/.config/sxmo/profile or ~/.profile. See also ~/.Xdefaults, ~/.config/sxmo/xinit, and ~/.config/sxmo/sway.

sxmo respects the xdg protocal, falling back to some sane defaults if this is missing on your system. The most relevant ones are:

XDG_DATA_HOME

~/.local/share

XDG_CONFIG_HOME

~/.config

XDG_CACHE_HOME

~/.cache

XDG_STATE_HOME

~/.local/state

XDG_RUNTIME_DIR

/dev/shm/$USER/1000

XDG_DATA_DIRS

~/.local/share

The default values for environment variables are set in /etc/profile.d/sxmo_init.sh . If you want to override them, use your ~/.profile. Sxmo itself defines the following variables, in alphabetical order:

DEFAULT_COUNTRY

String to indicate the default country sxmo should fallback to when the phone numbers are not country code prefixed. Should be set to a country code (iso-3166) such as FR for France, DE for Germany, US for the Unites States. See CONTACTS.

KEYBOARD

the virtual keyboard used, defaults to svkbd-mobile-intl (svkbd(1)) on Xorg on wvkbd-mobile-intl on Wayland.

KEYBOARD_ARGS

parameters to pass to the virtual keyboard upon launch

SXMO_BLOCKDIR

blocked number metadata (~/.local/share/modem/block).

SXMO_BLOCKFILE

A file with phone numbers to block (~/.config/sxmo/block.tsv).

SXMO_CACHEDIR

temporary cache files (~/.cache/sxmo)

SXMO_CONTACTFILE

a TSV file containing contacts (~/.config/sxmo/contacts.tsv)

SXMO_DEBUG

if defined, extra debug messages will appear in ~/.local/state/sxmo.log .

SXMO_DEFAULT_DRAFT

a string containg the default draft text for text messages.

SXMO_DEVICE_NAME

the device name. Sxmo will also load all the variables in /usr/bin/sxmo_deviceprofile_$SXMO_DEVICE_NAME.sh, such as id for touch input, whether the device has leds, and so on. See DEVICES.

SXMO_LOGDIR

where sxmo logs metadata about calls and texts received. Under this directory, there will be several subdirectories, one for each number, which contain the content of the text messages received. (~/.local/share/modem)

SXMO_MENU

The menu program to use. This must be either dmenu(1), bemenu(1) or wofi(1), you can not just specify an arbitrary binary here as Sxmo must have internal support for it.

SXMO_NOTCH

Set SXMO_NOTCH to a string to use for (under) the notch, the length of the string determines the width, do NOT use spaces or tabs.

SXMO_NOTCH_PRIO

Integer value determining where to place the notch in relation to other sxmobar components. Value is trial and error (default is 29).

SXMO_NOTIFDIR

The directory where notifications are stored (mediated by sxmo_notifs.sh(1))

SXMO_OS

the distribution (postmarketos, archlinux, etc.)

SXMO_TERMINAL

Terminal to launch. Defaults to foot(1) on wayland or st(1) on Xorg. Launching a terminal is mediated via sxmo_terminal.sh, which reads this variable.

SXMO_RINGTONE

The audio file to play when the phone is ringing.

SXMO_RINGNUMBER

The number of times the audio file will play.

SXMO_STATE

the file containing the current state

SXMO_SWAY_SCALE

the scaling factor to use for sway

SXMO_TEXTSOUND

The audio file to play when the phone is receives a text.

SXMO_VIBRATE_STRENGTH

The vibration strength to pass to the haptic feedback when a text arrives.

SXMO_WM

the window manager used (sway or dwm)

Other relevant environment variables are, in alphabetical order:

BROWSER

default web browser

DMENU_WRAP_AROUND

If set to 1, when scrolling past the beginning or end of a menu, wraps around it (dmenu only)

DBUS_SESSION_BUS_ADDRESS

dbus socket

BEMENU_OPTS

options to pass to bemenu

EDITOR

default text editor

MOZ_ENABLE_WAYLAND

Set to 1 when running under Wayland.

PATH

the system path, this will be set to look in ~/.config/sxmo/hooks/$SXMO_DEVICE_NAME/, /usr/share/sxmo/hooks/$SXMO_DEVICE_NAME/, ~/.config/sxmo/hooks/, and ~/usr/share/sxmo/hooks/ before the regular PATH the operating system sets.

SDL_VIDEODRIVER

Set to value wayland when running under Wayland.

SHELL

default shell

SWAYSOCK

sway socket

XDG_CURRENT_DESKTOP

The current desktop (sway or dwm)

Hint: you can type _sxmo_grab_session from the commandline to reload environment variables (e.g., if you switch window managers but are logged in over an ssh connection).

There are other environmental variables that are device specific. See DEVICES. As well, several scripts have their own environmental variables which we do not list here.

FILES ¶

~/.local/state/sxmo.log - sxmo's logfiles. See LOGGING.

~/.config/sxmo - most sxmo config files

~/.config/sxmo/profile - profile where you can customise environment variables. See ENVIRONMENT.

~/.config/sxmo/hooks - your user-defined hooks. See HOOKS.

~/.config/sxmo/userscripts - either a file or a directory containing your userscripts. See MENUS.

AUTHORS ¶

Sxmo is developed by a wide community of contributors, to whom we are all grateful. See the git log for full details.

MAINTAINERS ¶

• Anjandev Momi <anjan@momi.ca>
• Aren Moynihan <aren@peacevolution.org>
• Maarten van Gompel <proycon@anaproy.nl>
• Willow Barraco <contact@willowbarraco.fr>

Former maintainers:

• Miles Alan <m@milesalan.com> (the original creator of Sxmo)
• Peter John Hartman <peterjohnhartman@gmail.com>

BUGS AND SUPPORT ¶

We have the following support channels for questions and bug reports:

~mil/sxmo-announce@lists.sr.ht (e-mail)

This is a low-volume read-only mailing list used for announcing new package releases. See https://lists.sr.ht/~mil/sxmo-announce .

~mil/sxmo-devel@lists.sr.ht (e-mail)

This is our primary asynchronous developer support channel where you can send code contributions as patches via git-send-email(1). See https://lists.sr.ht/~mil/sxmo-devel .

~mil/sxmo-user@lists.sr.ht (e-mail)

This is our primary asynchronous user support channel where you can send questions, bug reports, and featVure requests. Please check if your question is not already answered before posting. Here you can also discuss the general goals of the project, your experience daily driving, and have other fun discussions with the Sxmo community. See https://lists.sr.ht/~mil/sxmo-user .

https://todo.sr.ht/~mil/sxmo-tickets (web)

This is our bug/feature tracker. It is for confirmed bugs and tracking feature requests. Not for user support. See https://todo.sr.ht/~mil/sxmo-tickets .

#sxmo (IRC)

We have the channel #sxmo and #sxmo-offtopic on the OFTC IRC Network (irc.oftc.net). Here you can talk to Sxmo users and developers in realtime. Moreover, you can get help with Sxmo and related projects. Please stay around for answers when asking questions. A web-based chat is available via https://webchat.oftc.net/?channels=#sxmo

#otfc#sxmo:matrix.org (Matrix)

This is a Matrix bridge to the IRC chat. See https://matrix.to/#/#_oftc_#sxmo:matrix.org .

PostmarketOS Wiki (web)

The postmarketOS Wiki contains user-maintained Tips & Tricks pages for Sxmo like https://wiki.postmarketos.org/wiki/Sxmo/Tips_and_Tricks .

There are a number of communities working on FOSS mobile distros, middleware, apps, and hardware development. You can join the other chatrooms related to FOSS mobile via the following matrix space:

https://matrix.to/#/#FOSSMobile:matrix.org

COPYRIGHT ¶

Sxmo is licensed under the GNU Affero General Public License v3.

SEE ALSO ¶

sxmo_appmenu.sh(1) sxmo_files.sh(1) sxmo_migrate.sh(1) sxmo_wakelock.sh(1) lisgd(1) peanutbutter(1) svkbd(1) wvkbd(1)