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 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88
|
# Phosh Mobile Settings
Mobile Settings App for [phosh](https://gitlab.gnome.org/World/Phosh/phosh) and
related components.
Additionally, it supports the [conf-tweaks format](src/conf-tweaks/README.md)
for defining additional settings in YAML format.
## License
Phosh Mobile Settings is licensed under the GPLv3+.
## Getting the source
```sh
git clone https://gitlab.gnome.org/World/Phosh/phosh-mobile-settings
cd phosh-mobile-settings
```
The [main][] branch has the current development version.
## Dependencies
On a Debian based system run
```sh
sudo apt-get -y install build-essential
sudo apt-get -y build-dep .
```
For an explicit list of dependencies check the `Build-Depends` entry in the
[debian/control][] file.
## Building
We use the meson (and thereby Ninja) build system for phosh. The quickest
way to get going is to do the following:
```sh
meson setup _build
meson compile -C _build
```
## Running
Phosh Mobile Settings needs to locate a few GSettings schema, if phosh is
already installed on your system, then it works out of box.
```sh
sudo apt-get -y install phosh
```
Then run Mobile Settings using `_build/run`.
```sh
_build/run
```
If you have the source code of phosh and would like to run Mobile Settings using
the schema generated by it, you need to set the `PHOSH_BUILD_DIR` to
phosh's build directory.
```sh
PHOSH_BUILD_DIR=/path/to/phosh/_build _build/run
```
By default, `_build/run` looks for phosh build directory at `../phosh/_build`.
If you have phosh source code in that location, then you can run `_build/run`
as it is without setting `PHOSH_BUILD_DIR`.
Note that the `run` script sets the GSettings backend to `memory` by default
so phosh or other apps don't see any changes made. This can be changed by
settings `GSETTINGS_BACKEND=dconf`.
The result should look something like this:



## Getting in Touch
- Issue tracker: <https://gitlab.gnome.org/World/Phosh/phosh-mobile-settings/issues>
- Matrix: <https://matrix.to/#/#phosh:phosh.mobi>
[main]: https://gitlab.gnome.org/World/Phosh/phosh-mobile-seettings/-/tree/main
[.gitlab-ci.yml]: https://gitlab.gnome.org/World/Phosh/phosh-mobile-settings/-/blob/main/.gitlab-ci.yml
[debian/control]: https://gitlab.gnome.org/World/Phosh/phosh-mobile-settings/-/blob/main/debian/control
|