View source for Projects:PinePhone Daily Driver with Sway

Implementation of [[Projects:PinePhone Daily Driver]] using [[swayWM]].

== Components ==
* [[postmarketOS]] with [[swayWM|postmarketos-ui-sway]]
* System packages: [[bemenu]] [[networkmanager]] [[termite]] termite-terminfo [[bluez]] [[squeekboard]]
* App packages: [[vim]] [[firefox]] [[galculator]] [[thunderbird]] [[gajim]] [[audacious]] audacious-plugins

== Setup ==
Configs are stored in a [https://github.com/Dejvino/pinephone-sway-poc repository].

{{Todo|Create a [[postmarketOS]] package? [https://wiki.postmarketos.org/wiki/Create_a_package]}}

=== [[elogind]] ===
Power key needs to be locked from [[elogind]], otherwise it would shutdown the system. This way as long as the UI session is running, power button is ignored by [[elogind]]. Once the session ends and we're back in the login screen, the power button is again able to shutdown the system.

{{codeblock|title=/usr/share/wayland-sessions/sway.desktop|1=
...
Exec=elogind-inhibit --what=handle-power-key --mode=block dbus-run-session /usr/bin/sway
...
}}

=== lisgd ===
{{codeblock|title=~/build/lisgd/lisgd.h|1=
/* Commands to execute upon recieving a swipe gesture */
Gesture gestures[] = {
        /* fingers      start   end     command */
        { 1,    Left,   Right,    "swaymsg workspace prev" },
        { 1,    Right,  Left,     "swaymsg workspace next" },

        { 2,    Left,   Right,    "xdotool key --clearmodifiers Alt+e" },
        { 2,    Right,  Left,     "xdotool key --clearmodifiers Alt+r" },

        { 2,    Down,   Up,       "swayphone_keyboard_show" },
        { 2,    Up,     Down,     "swayphone_keyboard_hide" },

        { 3,    Down,   Up,       "sxmo_vol.sh up" },
        { 3,    Up,     Down,     "sxmo_vol.sh down" },

        { 4,    Down,   Up,       "sxmo_brightness.sh up" },
        { 4,    Up,     Down,     "sxmo_brightness.sh down" },
};}}
{{todo|Finish updating this}}

{{codeblock|1=# TODO: cloning  and building the app
cp ~/build/lisgd/lisgd /usr/local/bin/lisgd}}

=== [[swayWM]] ===
# Copy {{code|1=/etc/sway/config}} to {{code|1=~/.config/sway/config}}
# Edit:
{{codeblock|title=~/.config/sway/config|1=
# Logo key. Use Mod1 for Alt.
set $mod Mod1
[...]
# Your preferred terminal emulator
set $term termite
[...]
# Your preferred application launcher
set $menu bemenu-run | xargs swaymsg exec --
[...]
   # Kill focused window
    bindsym $mod+q kill
[...]
# Default scaling for the touchscreen
output DSI-1 scale 2

# Initial utility apps
exec squeekboard
exec lisgd

# Waybar on multiple rows
exec "waybar -c /home/dejvino/.config/waybar/config_0 -b b0"
exec "waybar -c /home/dejvino/.config/waybar/config_1 -b b1"
exec "waybar -c /home/dejvino/.config/waybar/config_2 -b b2"
}}

=== [[waybar]] ===
* Pick a theme! Mine is: [https://github.com/carlosdss22/dotfiles/]
* {{IconInfo}} For '''clock''' module, don't forget to set the ''locale'' and ''timezone'' parameters, otherwise nothing will show up.

=== [[Bluetooth]] ===
* Enable the service on boot: {{code|1=rc-update add bluetooth}}
* Enable the controller by default:
{{codeblock|title=/etc/bluetooth/main.conf|1=
[Policy]
AutoEnable=true
}}

=== TODOs ===
{{todo|Complete these TODOs!}}
# power saving (so that I can leave the battery in the device when I'm not using it)
#* hibernation / suspend command
#* shortcut to enter suspend
#* {{IconInfo}} {{code|1=rtcwake -m mem -s 10}}
# Install and test essential apps & workflows
## Terminal: [[termite]]
## Web browser: [[Firefox]]
## Passwords manager: [[KeepassXC]])
## Personal Information Manager with [[WebDAV]] sync support for calendar, contacts
## Email client: [[thunderbird]]
## Calculator: [[galculator]]
## Alarm: ?
## IM clients
##* XMPP: ?
##* Matrix: ?
##* Slack: ?
## Music player: [[audacious]]
## Camera & Video recorder: ?
## VPN client: [[NetworkManager]]?
# Support for non-essential apps & workflows
#* RSS client: ?
#* OTP generator: ?
#* Ebook reader: ?
#* Weather forecast: ?
#* Maps, navigation: ?
#* Calls & Texts: ?
# Touch gestures and controls
#* [[sxmo#lisgd]]
#* [[twofing]]
#* [[easystroke]] (abandoned)
#* [[wmctrl]], [[xdotool]], [[xte]], ...
#* Custom input device? [https://python-evdev.readthedocs.io/en/latest/tutorial.html]
# tweaking
#* Configure [[Firefox]] for touch: [https://wiki.postmarketos.org/wiki/Firefox]?
#* ''acpi'' for battery monitoring?
#* ...
# non-essential userspace apps
#* ...


== Rejected solutions ==
=== under Wayland ===
* [https://github.com/bulletmark/libinput-gestures libinput-gestures]
* [http://www.plippo.de/p/twofing twofing]
* onboard virtual keyboard