Metadata-Version: 2.1
Name: tabletmode
Version: 2.2.0
Summary: Tablet mode switch for GNOME 3.
Home-page: https://github.com/conqp/tablet-mode
Author: Richard Neumann
Author-email: mail@richard-neumann.de
License: GPLv3
Keywords: tablet mode tent convertible switch
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# tablet-mode

Allow users to toggle a convertible laptop between laptop and tablet mode.

## Configuration

The devices to be deactivated in either *tablet* or *laptop* mode must be specified in `/etc/tablet-mode.json`.  
You can specify whether desktop notifications shall be send when changing the mode using the `notify` flag.  
If specified, you can override `sudo` to provide another program that accepts commands to be run as root without a password
by the current user to elevate privileges, such as *doas*.

```json
{
    "tablet": [
        "/dev/input/by-path/platform-i8042-serio-0-event-kbd",
        "/dev/input/by-path/platform-i8042-serio-1-event-mouse"
    ],
    "notify": false,
    "sudo": "/usr/bin/doas"
}
```

## Usage

You must be a member of the group `tablet` to toggle between tablet and laptop mode.  
You can toggle between tablet and laptop mode by running `setsysmode toggle` or use the desktop icon provided with this package.
