Scripts, programs and configuration for making life easier on a Lenovo Miix running wayland/wlroots or other laptop-tablet convertibles
Go to file
Yuki Joou 3771c8792a daemon: Finish renaming to convertablet 2023-08-27 23:35:12 +02:00
configs configs: Added sample waybar config 2023-07-21 02:54:09 +02:00
daemon daemon: Finish renaming to convertablet 2023-08-27 23:35:12 +02:00
fcitx5-hooks fcitx5-hooks: Created fcitx module to help with on-screen keyboard input 2023-07-22 10:39:31 +02:00
wayland-protos meta: Refactoring to make room for other parts of the project 2023-07-13 14:22:52 +02:00
.clang-format format: Fixed clang-format to not mess up arrays 2023-08-27 21:19:06 +02:00
.gitignore fcitx5-hooks: Created fcitx module to help with on-screen keyboard input 2023-07-22 10:39:31 +02:00
README.md daemon: Added support for 'google-caroline' 2023-08-27 21:20:37 +02:00
build.sh meta: Refactoring to make room for other parts of the project 2023-07-13 14:22:52 +02:00

README.md

convertablet

Support for tablet-laptop convertible on wlroots-based compositors.

This project includes both a daemon for handling screen rotation and docking, and some configuration for other software

Daemon

Installation

  1. Get the code
git clone https://git.kemonomimi.gay/yukijoou/convertablet && cd convertablet
  1. Download and build the wayland extensions
cd wayland-protos/
./download_protocols.sh
./codegen.sh
cd ../
  1. Build the daemon
./build.sh
  1. Run it to try it out
./convertablet generic

This will run the daemon in 'generic' mode. This assumes "sane defaults" for your display's name and motion sensor. It's likely your device isn't using those.

You can check the list of supported devices with ./convertablet list-devices, and load that specific device's config with ./convertablet <device name here>.

  1. Copy it to /usr/local/bin & make it run at startup

Configuration

You can create scripts at $HOME/.config/convertablet/hooks that will trigger on events

  • Basestation disconnected: basestation-disconnected-hook
  • Basestation connected: basestation-connected-hook

Device compatibility

Product name Device name Notes
Lenovo Miix 320-10icr lenovo-miix-320-10icr
Samsung Chromebook Pro XE510C24-K01US google-caroline Thanks to nothingneko/@jaiden@ordinary.cafe!

Using fcitx hooks

If you're using fcitx to get fancy input methods working, on-screen keyboards will not work, because on wayland, only one program can detect input begining events. To work around this issue, you can use the fcitx5-hooks module I wrote to run a script when an input field is focused/unfocused. See instructions in fcitx5-hooks/.

3rd party programs Configurations

Still a work in progress...

In the meantime, you can find some example hooks for the convertablet daemon and waybar in configs/.