You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Dejvino eff323bf72 Update toolkit 3 years ago
home/config Power management supports suspend. Mentioned ALARM. 3 years ago
lisgd @ 877beea273 Add lisgd and rot8 support 3 years ago
patches Add lisgd patch to support screen rotation. 3 years ago
pinephone-toolkit @ 0deaf8473a Update toolkit 3 years ago
rot8 @ 8f2128c172 Add lisgd and rot8 support 3 years ago
usr Power management supports suspend. Mentioned ALARM. 3 years ago
.gitmodules Add vertical waybar for landscape mode 3 years ago
LICENSE Initial commit 3 years ago
Makefile Fixed lisgd version with for the patch file 3 years ago Power management supports suspend. Mentioned ALARM. 3 years ago
screenshots.png Update README with screenshot. 3 years ago


Sway UI configured for PINE64 PinePhone (Proof Of Concept)

You can find ready-made config files, scripts and installation instructions on how to set up Sway on Arch Linux ARM or postmarketOS and use it with a PinePhone.




Start with a postmarketOS for PinePhone image with postmarketos-ui-sway installed. Either use the pre-built demo image or build a custom one with pmbootstrap.

Flash the system onto the phone (either to an SD card or directly to the eMMC with Jumpdrive).

Open a terminal on the phone (either through SSH, the serial connection or directly on the screen) and run this:

# system components
$ sudo apk add waybar bemenu swaylock swayidle squeekboard bash dialog tzdata

# user components
$ sudo apk add networkmanager htop pavucontrol

# build tools
$ sudo apk add git make meson ninja cargo linux-headers libinput-dev eudev-dev

Arch Linux ARM

Start with a Pine64-Arch image flashed to the phone. You’ll need the sway package and most of what is mentioned in the postmarketOS section. Disable (or remove) the default phosh package so that it doesn’t get loaded on boot.


# installation
$ git clone --recurse-submodules
$ cd pinephone-sway-poc
$ make install_user
$ sudo make install_system

# power button
sudo vim /etc/systemd/logind.conf # or /etc/elogind/logind.conf for non-systemd distros (pmOS)
# replace:
# #HandlePowerKey=poweroff
# with:
# HandlePowerKey=suspend

That’s it. You should now have everything in place. Reboot to use the new settings.


Study the provided config files and shell scripts to get more details. The following is just an introduction.

Power Button

The power button activates or deactivates a “sleep mode” (suspend). This mode is automatically entered after a period of inactivity (via swayidle). Before that, the backlight is first turned low, then the backlight is turned off and all the CPUs except for the primary one are shut down. The indicator LED is used to indicate the power mode: 1) green = running, low power usage, 2) blue = suspend.

Top and bottom waybar

The bars show you CPU/MEM usage, backlight brightness, time, etc. Touching them opens a relevant app (e.g. NetworkManager or htop). Touching the date opens a custom “quick execute” menu to launch an app. The [x] icon closes the active window. Touching the backlight indicator brings up a custom brightness setting app.

Touch gestures

Swiping two fingers up / down activates or hides the on-screen keyboard. Swiping two fingers left / right changes the active workspace. Three fingers change the active window in the direction of the swipe. Four fingers move the active window accordingly.

Screen Rotation

The screen is automatically rotated based on the readings from the phone’s built-in accelerometer.


You can use this as a configs backup mechanism!

$ make fetch

Running this command gathers the relevant config files from your running system and replaces the files in the repository. You can then git add and commit your own changes, straight from the phone! This is actually how the config files here were created.


  • postmarketOS / Arch Linux ARM - base Linux distribution (though any other would work as well)
  • sway (packaged) - tiling Wayland compositor
    • swayidle, swaylock - utils for sway
  • bemenu (packaged) - app launcher
  • waybar (packaged) - Wayland status bar
  • squeekboard (packaged) - on-screen keyboard for Wayland
  • pinephone-toolkit - various utilities for the PinePhone
  • sxmo-lisgd - gesture detection daemon
  • rot8 - screen rotation daemon using data from the accelerometer
  • htop (packaged) - Processes monitoring
  • pavucontrol (packaged) - PulseAudio control panel
  • mako (packaged) - Notify daemon

(packaged = available as a package directly from the repository)