File: README.md

package info (click to toggle)
gmobile 0.6.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 688 kB
  • sloc: ansic: 2,605; sh: 37; xml: 32; python: 11; makefile: 9; javascript: 6
file content (52 lines) | stat: -rw-r--r-- 1,368 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# gmobile

gmobile carries some helpers for glib based environments on mobile devices.
Some of those parts might move to glib or libgnome-desktop eventually. It can
be used as a shared library or git submodule. There aren't any API stability
guarantees at this point in time.

## License

gmobile is licensed under the GPL-3-or-later and LGPLv2.1-or-later.

## Getting the source

```sh
    git clone https://gitlab.gnome.org/World/Phosh/gmobile.git
    cd gmobile.git
```

The `main` branch has the current development version.

## Dependencies

See `meson.build` for required dependencies.

## Building

We use the meson (and thereby Ninja) build system for gmobile.  The quickest
way to get going is to do the following:

```sh
    meson setup _build
    meson compile -C _build
```

## API docs

API documentation is available at <https://world.pages.gitlab.gnome.org/Phosh/gmobile/>

## Adding a new device

If you want to add display panel information for a new device see
this post on [notch support](https://phosh.mobi/posts/notch-support/).

If you want to add support for wakeup keys see the
[manpage](./doc/gmobile.udev.rst) and the post on [wakeup keys][].

## Getting in Touch

* Issue tracker: <https://gitlab.gnome.org/World/Phosh/gmobile/-/issues>
* Matrix: <https://matrix.to/#/#phosh:phosh.mobi>

[wakeup keys]: https://phosh.mobi/posts/wakeup-keys/