~mil/sxmo-docs

Simple X Mobile documentation
added gesture schematic
Updated documentation, mainly regarding gestures, hooks and environment variables.
Maintainers: added note to include changelog in tag message

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~mil/sxmo-docs
read/write
git@git.sr.ht:~mil/sxmo-docs

You can also use your local clone with git send-email.

#Sxmo: Simple X Mobile

Pinephone Sxmo Demo


Project Overview | Install Guide | User Guide | Contributing | Images | Demo Videos | Changelog


builds.sr.ht status

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. You control the UI largely through using the Pinephone buttons (press different numbers of times quickly for different actions) and swipe gestures.

Overview of Sxmo's features:

  • Pinephone buttons actions: (via dwm) press hardware buttons different number of times for different actions (like launching terminals, browsers, and window management)
  • Swipe gestures: (via lisgd) move between workspaces, move windows between workspaces, and raise/lower volume via swipe gestures
  • Menu interfaces: (via dmenu) use the Pinephone hardware buttons to select menu entries (e.g. volume up/volume down/select translates to previous/next/select)
  • Onscreen keyboard: (via svkbd) Multiple layer responsive onscreen keyboard that autoadjusts WM space
  • Window Managment: (via dwm) Arrange windows (in classic dwm layouts like monocle, tile, and bstack), kill clients, and cycle window focus using Pinephone buttons
  • Calls & Texting: (via dmenu scripts/mmcli) Compose texts in $EDITOR / vim-like editor, read texts in $PAGER, make calls (and audio-route) via dmenu script utilizing modemmanager
  • Incoming Text/Call notifications: (via script) Vibrate phone & blink led when there is an incoming call/text
  • Lock Screen: (via custom C program) Disable screen input and toggle screen on/off for listening to music / pocket use
  • Menu Scripts: Web Search, Files, Countdown Timer, Youtube audio and video (mpv-based), Weather, RSS
  • Web browser: (via surf) Browse the web while saving screenspace and includes Pinephone buttons (via dmenu) based link-following
  • Terminal: (via st) Excellent terminal support with scrollback, copy-paste, and color invert
  • Other Applications: Prebaked images bundle foxtrotgps (GPS), sacc (Gopher client), Firefox and Netsurf (web browsers)
  • System-menus: Control Volume, Brightness, Camera, Wifi, Logout, Modem Info, Launching Apps, and more
  • Application-specific menus: Increase font-size, zoom, paste, on per-application level via dmenu scripts
  • Login Screen: (via xdm) Login/logout via XDM which launches with onscreen keyboard
  • Alpine Linux / PmOS Based Images: Our infrastructure bakes images that live ontop of PmOS/Alpine Linux which keeps things small, simple, and pragmatic