選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。
 
 
 
 
 
テクニカル諏訪子 88addb5050 Merge branch 'master' of git.076.ne.jp:TechnicalSuwako/phantom 11ヶ月前
.gitlab/issue_templates Add issue template 4年前
build-aux build: Compile gschemas on install 1年前
data data: Add icons for disabled camera and mic 11ヶ月前
debian Document changes and release 0.8.1 12ヶ月前
docs Add PhoshHksInfo 11ヶ月前
po po: Add Creole Haitian translation 11ヶ月前
protocol Phoshからの新しいもの 1年前
screenshots README: Don't special case running nested on x11 3年前
src 本プロジェクトの変更 11ヶ月前
tests prompts: Update PhoshShellState 11ヶ月前
tools Move helpers to tools/ 1年前
.dir-locals.el Add .dir-locals.el 4年前
.editorconfig editorconfig: strip whitespace 2年前
.gitignore gitignore: Add generate files in Debian 1年前
.gitlab-ci.yml Phoshからの新しいもの 1年前
.gitmodules Add gvc submodule 3年前
COPYING Add GPLv3 license file 3年前
HACKING.md docs: Document C file layout 2年前
README.md README: update description 1年前
config.h.in config.h: Add phosh's version 3年前
meson.build Document changes and release 0.8.1 12ヶ月前
meson_options.txt build: Allow to add tests that require phoc 2年前
phosh.doap doap: Add Zander Brown 1年前
run.in run: Simplify oneshot gdb 1年前

README.md

Phosh

Code coverage

a pure wayland shell for mobile devices like Purism's Librem 5.

License

phosh is licensed under the GPLv3+.

Getting the source

    git clone https://source.puri.sm/Librem5/phosh
    cd phosh

The master branch has the current development version.

Dependencies

On a Debian based system run

    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.

If your distro doesn't ship libhandy you need to build that from source. More details are in the gitlab-ci.yml file.

Building

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

meson . _build
ninja -C _build
ninja -C _build install

Testing

To run the tests run

ninja -C _build test

For details see the .gitlab-ci.yml file.

There are some thorough tests not run during CI which can e.g. be run via

gtester -m thorough  _build/tests/test-idle-manager

Running

Running from the source tree

When running from the source tree start the compositor phoc. Then start phosh using:

_build/run -U

or in one command:

../phoc/_build/run -E '_build/run -U' -C ./data/phoc.ini

When running nested it's recommended to skip the gnome-session setup:

SKIP_GNOME_SESSION=1 ../phoc/_build/run -E '_build/run -U' -C ./data/phoc.ini

This will make sure the needed gsettings schema is found. The '-U' option makes sure the shell is not locked on startup so you can test with arbitrary passwords. This works on hardware as well as nested on other desktop environments. The result should look something like this:

phosh

Running from the Debian packages

If you're running a display manager like GDM or LightDM you can select the Phosh session from the display managers menu. If you want run without a display manager but nevertheless start phosh at system boot there's a systemd unit file in /lib/systemd/system/phosh which is disabled by default:

systemctl enable phosh
systemctl start phosh

This runs phosh as the user with user id 1000 (which needs to exist). If you don't have that user and don't want to create one you can make systemd run phosh as any user by using an override file:

$ cat /etc/systemd/system/phosh.service.d/override.conf
[Service]
User=<your_user>

All of the above use the /usr/bin/phosh script to start compositor and shell under the hood so if you just want to start phosh from the system console once invoke that script directly.

Translations

This is handled via GNOMEs infra, see https://wiki.gnome.org/TranslationProject and https://l10n.gnome.org/module/phosh/.

Getting in Touch

For details see the developer documentation.