~anjan/sxmo-docs-stable

a2149e2a25387c0b60b44dd072c3271a338b3de4 — Maarten van Gompel 6 months ago 5888a9f
Updated the index page for swmo
1 files changed, 23 insertions(+), 14 deletions(-)

M index.md
M index.md => index.md +23 -14
@@ 13,26 13,35 @@
[![builds.sr.ht status](https://builds.sr.ht/~sxmo-infra/sxmo-image-builder-nightly.svg?name=Nightly%20Img)](https://builds.sr.ht/~sxmo-infra/sxmo-image-builder-nightly)
[![builds.sr.ht status](https://builds.sr.ht/~proycon/sxmo-build.svg?name=Nightly%20Pkgs)](https://builds.sr.ht/~proycon/sxmo-build?)

**Sxmo**, or Simple X Mobile, is a collection of simple and [suckless](http://suckless.org) X programs and scripts used together to create a fully functional mobile UI adhering to the [Unix philosophy](https://en.wikipedia.org/wiki/Unix_philosophy) for the [Pinephone](https://www.pine64.org/pinephone/). You control the UI largely through using the Pinephone buttons (press different numbers of times quickly for different actions) and swipe gestures.
**Sxmo**, or Simple X Mobile, is a collection of simple and [suckless](http://suckless.org) programs and scripts used
together to create a fully functional mobile UI adhering to the [Unix
philosophy](https://en.wikipedia.org/wiki/Unix_philosophy). We focus on Linux smartphones such as the
[Pinephone](https://www.pine64.org/pinephone/). Sxmo is primarily written in POSIX shell scripts and can be easily
modified and extended using our hook system.

Overview of Sxmo's features:
Sxmo >= 1.6.0 runs both on Xorg (using [dwm](http://git.sr.ht/~mil/sxmo-dwm)) as well as on Wayland (using
[sway](https://swaywm.org/)). The X in our name historically referred to Xorg, but is now open to whatever
interpretation you prefer  (eXtensible, eXcellent, eXperimental, etc...)

- **Pinephone buttons actions**: (via [dwm](http://git.sr.ht/~mil/sxmo-dwm)) press hardware buttons different number of times for different actions (like launching terminals, browsers, and window management)
A brief overview of Sxmo's features:

- **Hardware buttons action**: press hardware buttons different number of times for different actions (like launching terminals, browsers, and window management)
- **Swipe gestures**: (via [lisgd](http://git.sr.ht/~mil/lisgd)) move between workspaces, move windows between workspaces, and raise/lower volume via swipe gestures
- **Menu interfaces**: (via [dmenu](http://git.sr.ht/~mil/sxmo-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](http://git.sr.ht/~mil/sxmo-svkbd)) Multiple layer responsive onscreen keyboard that autoadjusts WM space
- **Window Managment**: (via [dwm](http://git.sr.ht/~mil/sxmo-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](https://git.sr.ht/~mil/sxmo-utils/tree/master/scripts/modem)) Compose texts in $EDITOR / vim-like editor, read texts in $PAGER, make calls (and audio-route) via dmenu script utilizing modemmanager
- **Menu interfaces**: (via [bemenu](https://github.com/Cloudef/bemenu) or [dmenu](http://git.sr.ht/~mil/sxmo-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](http://git.sr.ht/~mil/sxmo-svkbd) or [wvkbd](https://github.com/jjsullivan5196/wvkbd)) Multiple layer responsive onscreen keyboard that autoadjusts WM space
- **Window Managment**: (via [sway](https://swaywm.org/) or [dwm](http://git.sr.ht/~mil/sxmo-dwm)) Arrange windows (in classic dwm layouts like monocle, tile, and bstack), kill clients, and cycle window focus using Pinephone buttons
- **Calls & Texting**: (via [scripts/mmcli](https://git.sr.ht/~mil/sxmo-utils/tree/master/scripts/modem)) Compose texts in $EDITOR / vim-like editor, read texts in $PAGER, make calls (and audio-route) via dmenu script utilizing modemmanager. Support also for MMS since v1.6.0.
- **Incoming Text/Call notifications**:  (via [script](https://git.sr.ht/~mil/sxmo-utils/tree/master/scripts/modem/sxmo_modemmonitor.sh)) Vibrate phone & blink led when there is an incoming call/text
- **Lock Screen**: (via custom script) Disable screen input, toggle screen on/off for listening to music / pocket use, and enter deep sleep via button bindings
- **Lock Screen**: (via custom script) Disable screen input, toggle screen on/off for listening to music / pocket use, automatic deep sleep when idle
- **Menu Scripts**: Web Search, Files, Countdown Timer, Youtube audio and video (mpv-based), Weather, RSS
- **Web browser**: (via [surf](http://git.sr.ht/~mil/sxmo-surf)) Browse the web while saving screenspace and includes Pinephone buttons (via dmenu) based link-following
- **Terminal**: (via [st](http://git.sr.ht/~mil/sxmo-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
- **Web browser**: (e.g. [firefox](https://mozilla.org/firefox)) Browse the web while saving screenspace and includes Pinephone buttons (via dmenu) based link-following
- **Terminal**: (via [foot](https://codeberg.org/dnkl/foot) or [st](http://git.sr.ht/~mil/sxmo-st)) Excellent terminal support with scrollback, copy-paste, and color invert
- **Camera** (via [megapixels](https://git.sr.ht/~martijnbraam/megapixels)) Take photos and videos
- **System-menus**: Control Volume, Brightness, Wifi, Logout, Modem Info, Launching Apps, and more
- **Application-specific context menus**: Increase font-size, zoom, paste, on per-application level via dmenu scripts
- **Auto Login**: (via [tinydm](https://gitlab.com/postmarketOS/tinydm))
- **Alpine Linux / PmOS Based Images**: postmarketOS's infra bakes images that bundle Sxmo and pmOS (based on Alpine Linux) which keeps things small, simple, and pragmatic
- **SSH as a first class citizen**: Log into your phone over ssh and have full access to all sxmo menus and functionality.
- **Alpine Linux / PmOS Based Images**: postmarketOS's infrastructure bakes images that bundle Sxmo and pmOS (based on Alpine Linux) which keeps things small, simple, and pragmatic

Sxmo 1.4.1 was presented at AlpineConf 2021, you can [watch the video](https://diode.zone/videos/watch/3f0948cf-47df-437e-b1ea-76fec58479c2).