README.md 930 Bytes
Newer Older
Guido Gunther's avatar
Guido Gunther committed
1 2
# Phosh

Guido Gunther's avatar
Guido Gunther committed
3
a trivial wayland shell for prototyping things.
Guido Gunther's avatar
Guido Gunther committed
4 5 6 7 8 9 10

## License

phosh is licensed under the GPLv3+.

## Dependencies

Guido Gunther's avatar
Guido Gunther committed
11 12 13 14
    sudo apt-get install libgnome-desktop-3-dev libgtk-3-dev libpam0g-dev libupower-glib-dev libwayland-dev meson

Until distros ship [libhandy](https://sources.puri.sm/Librem5/libhandy) you
need to build that from source as well.
Guido Gunther's avatar
Guido Gunther committed
15 16 17 18 19 20

## Building

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

Guido Gunther's avatar
Guido Gunther committed
21 22 23
    meson . _build
    ninja -C _build
    ninja -C _build install
Guido Gunther's avatar
Guido Gunther committed
24

25 26 27 28 29 30 31

## Running
When running from the source tree start *rootston*. Then start *phosh*
using:

    _build/run

32 33 34 35
or in one command:`

    ../wlroots/_build/rootston/rootston -E _build/run -C ./rootston.ini

Guido Gunther's avatar
Guido Gunther committed
36 37 38
This will make sure the gsettings schema is found, there's enough of a GNOME
session running an the some of the mutter DBus API is stubbed so
gnome-settings-manager can work.