{"id":23802553,"url":"https://github.com/agx/phosh","last_synced_at":"2025-04-04T13:08:38.266Z","repository":{"id":43221535,"uuid":"150992735","full_name":"agx/phosh","owner":"agx","description":"A pure Wayland shell for GNOME on mobile devices. Mirror of https://gitlab.gnome.org/World/Phosh/phosh","archived":false,"fork":false,"pushed_at":"2025-03-25T16:51:42.000Z","size":7150,"stargazers_count":140,"open_issues_count":0,"forks_count":5,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-28T20:06:11.818Z","etag":null,"topics":["gnome","gtk","phosh","wayland"],"latest_commit_sha":null,"homepage":"https://phosh.mobi","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agx.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-30T18:10:07.000Z","updated_at":"2025-03-25T16:51:46.000Z","dependencies_parsed_at":"2023-02-17T18:01:23.674Z","dependency_job_id":"7ead49a4-955b-43f3-bc8d-99354df393e0","html_url":"https://github.com/agx/phosh","commit_stats":{"total_commits":4989,"total_committers":157,"mean_commits":"31.777070063694268","dds":"0.26879134095009016","last_synced_commit":"8d3c3da3fcd2ba8495ce7c97deb21b579d537b7d"},"previous_names":[],"tags_count":92,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agx%2Fphosh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agx%2Fphosh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agx%2Fphosh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agx%2Fphosh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agx","download_url":"https://codeload.github.com/agx/phosh/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247178825,"owners_count":20896923,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gnome","gtk","phosh","wayland"],"created_at":"2025-01-01T22:27:02.311Z","updated_at":"2025-04-04T13:08:38.246Z","avatar_url":"https://github.com/agx.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Phosh\n\nA pure Wayland shell for mobile devices like smart phones or small\ntablets which\n\n* use touch input\n* are running battery powered most of the time\n* have limited screen space\n* have a limited number of buttons\n* might be docked to a keyboard, screen and other input devices\n\nTypical devices are the Librem 5 and PinePhone or devices formerly\nrunning proprietary operating systems like the OnePlus 6/6T.\n\nThe companion Wayland compositor is [phoc][].\n\n## License\n\nphosh is licensed under the GPL-3.0-or-later licence.\n\n## Getting the source\n\n```sh\ngit clone https://gitlab.gnome.org/World/Phosh/phosh\ncd phosh\n```\n\nThe [main][] branch has the current development version.\n\n## Dependencies\n\nOn a Debian based system run\n\n```sh\nsudo apt-get -y install build-essential\nsudo apt-get -y build-dep .\n```\n\nFor an explicit list of dependencies check the `Build-Depends` entry in the\n[debian/control][] file.\n\n## Building\n\nWe use the meson (and thereby Ninja) build system for phosh.  The quickest\nway to get going is to do the following:\n\n```sh\nmeson setup _build\nmeson compile -C _build\n```\n\n## Testing\n\nTo run the tests run\n\n```sh\nxvfb-run meson test --no-suite screenshots -C _build\n```\n\nFor details see the [.gitlab-ci.yml][] file.\n\n## Running\n\n### Running from the source tree\n\nWhen running from the source tree start the compositor *[phoc][]*.\nThen start *phosh* using:\n\n```sh\n_build/run\n```\n\nor (if you built *phoc* from source in *../phoc*) in one command:\n\n```sh\n../phoc/_build/run -C ./data/phoc.ini -E _build/run\n```\n\nThis will make sure the needed gsettings schema is found. Note that there's no\nneed to install any files outside the source tree.\n\nThe result should look something like this:\n\n![phosh](screenshots/phosh-overview.png)\n\n### Running from the Debian packages\n\nIf you're running a display manager like GDM or LightDM you can select the\n`Phosh` session from the display managers menu. For development purposes\nyou can use the provided systemd unit:\n\n```sh\nsystemctl start phosh\n```\n\nThis runs *phosh* as the user with user id 1000 (which needs to exist). If you\ndon't have that user and don't want to create one you can make systemd\nrun *phosh* as any user by using an override file:\n\n```sh\ncat \u003c\u003cEOF \u003e /etc/systemd/system/phosh.service.d/override.conf\n[Service]\nUser=\u003cyour_user\u003e\nEOF\n```\n\nAll of the above use the `/usr/bin/phosh-session` script to start compositor\nand shell under the hood so if you just want to start phosh from the system\nconsole once invoke that script directly.\n\n## Translations\n\nThis is handled via GNOMEs infra, see\n\u003chttps://wiki.gnome.org/TranslationProject\u003e and\n\u003chttps://l10n.gnome.org/module/phosh/\u003e.\n\n## Getting in Touch\n\n* Issue tracker: \u003chttps://gitlab.gnome.org/World/Phosh/phosh/issues\u003e\n* Matrix: \u003chttps://im.puri.sm/#/room/#phosh:talk.puri.sm\u003e\n\n## Development Documentation\n\nDevelopment documentation including public API docs and notes for application\ndevelopers is at \u003chttps://world.pages.gitlab.gnome.org/Phosh/phosh\u003e.\n\n[main]: https://gitlab.gnome.org/World/Phosh/phosh/-/tree/main\n[.gitlab-ci.yml]: https://gitlab.gnome.org/World/Phosh/phosh/-/blob/main/.gitlab-ci.yml\n[debian/control]: https://gitlab.gnome.org/World/Phosh/phosh/-/blob/main/debian/control\n[phoc]: https://gitlab.gnome.org/World/Phosh/phoc\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagx%2Fphosh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagx%2Fphosh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagx%2Fphosh/lists"}