https://github.com/sailfishos-chum/sailfishos-chum-gui
GUI application for utilising the SailfishOS:Chum community repository
https://github.com/sailfishos-chum/sailfishos-chum-gui
chum gui gui-application package-management package-manager packagemanagement packagemanager repo sailfish sailfish-os sailfish-os-app sailfishos sfos
Last synced: 4 months ago
JSON representation
GUI application for utilising the SailfishOS:Chum community repository
- Host: GitHub
- URL: https://github.com/sailfishos-chum/sailfishos-chum-gui
- Owner: sailfishos-chum
- License: mit
- Created: 2021-09-21T12:04:14.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-29T02:10:54.000Z (5 months ago)
- Last Synced: 2024-11-29T03:22:40.874Z (5 months ago)
- Topics: chum, gui, gui-application, package-management, package-manager, packagemanagement, packagemanager, repo, sailfish, sailfish-os, sailfish-os-app, sailfishos, sfos
- Language: C++
- Homepage: https://openrepos.net/content/olf/sailfishoschum-gui-installer
- Size: 6.09 MB
- Stars: 13
- Watchers: 2
- Forks: 17
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-sailfishos - Chum GUI - A (Applications)
README
# SailfishOS:Chum GUI application
**SailfishOS:Chum GUI is a graphical client application for managing software packages from the SailfishOS:Chum community repository.**
### Feature set
The SailfishOS:Chum GUI application deploys the same repository configuration as either of the [SailfishOS:Chum repository configuration RPMs](https://github.com/sailfishos-chum/sailfishos-chum-repo-config#readme) do, hence one can alternatively use command line tools as `pkcon` or `zypper` at any time.
The [main page](./.screenshots/sailfishos-chum-gui_main-page.png?raw=true) of the SailfishOS:Chum GUI app provides:
- In the pulley menu
- **About** page
- [**Settings** page](./.screenshots/sailfishos-chum-gui_settings.png?raw=true)
- Preset to show either applications or all packages for each package list by default
- Switch between the regular SailfishOS:Chum and the SailfishOS:Chum:Testing repository
- The ability to overrride the automatic SailfishOS:Chum repository selection based on the installed Sailfish OS release
- [**Refresh repository**](./.screenshots/sailfishos-chum-gui_retrieving-refreshed.png?raw=true) trigger
- **Updates** page
- Lists all installed packages, for which an update is available
- [**Categories** page](./.screenshots/sailfishos-chum-gui_categories.png?raw=true)
- Lists all categories
- Each category lists all packages assigned to it
- [**Packages** page](./.screenshots/sailfishos-chum-gui_applications.png?raw=true)
- Lists all available packages
- [**Installed packages** page](./.screenshots/sailfishos-chum-gui_installed-packages.png?raw=true)
- Lists only the installed packages
- On both aforementioned packages pages
- Search for packages
- Switch between "applications only" and "all packages" being displayed and searchable
- Display for each package
- Package title
- Categories the package is assigned to
- The name if its develeoper
- A package icon, if provided
- The number of *stars* its source code repository has aquired (only for packages hosted at GitHub or GitLab.com)
- Its install status (checkmark when installed) or if an update for an installed package is available (by a down-arrow)
- On each individual package page
- All aforementioned items which are displayed for each package in a package list
- If the package is a Sailfish application or a console application
- The number of *forks* of its source code repository (gear in curly brackets; only for packages hosted at GitHub or GitLab.com)
- A detailed description
- Installed and available version, if applicable
- Package name, download size and license (if indicated)
- A link to its homepage
- **Releases** sub-page (only for packages hosted at GitHub or GitLab.com)
- Release versions and dates
- On each release's sub-sub-page:
- Release version and date
- Release notes (if provided)
- **Issues** sub-page (only for packages hosted at GitHub or GitLab.com)
- Issue title, number and creator
- Creation date and last updated date
- Number of comments to the original issue report
- On each issue's sub-sub-page:
- Whole issue thread with all aforementioned items displayed in the thread header
- Creator, creation date and last updated date for each message
### How to install the SailfishOS:Chum GUI application
See [sailfishos-chum/main#how-to-install-the-sailfishoschum-gui-application](https://github.com/sailfishos-chum/main#how-to-install-the-sailfishoschum-gui-application).
### Important notes
* If you experience issues when installing, removing or updating packages after a SailfishOS upgrade, try running `devel-su pkcon refresh` in a terminal app.
* Before software can be build for a SailfishOS release at the SailfishOS-OBS, Jolla must create a [corresponding "download on demand (DoD)" OBS-repository](https://build.sailfishos.org/project/subprojects/sailfishos). It may take a little time after a new SailfishOS release is published before the corresponding "DoD" repository is being made available, during which installing the SailfishOS:Chum GUI application by the SailfishOS:Chum GUI Installer or updating the SailfishOS:Chum GUI application by itself on a device with the new SailfishOS release already installed does not work, because the SailfishOS:Chum GUI application cannot be compiled for this new SailfishOS release at the Sailfish-OBS, yet; consequently this is always the case for "closed beta (cBeta)" releases of SailfishOS. In such a situation one has to manually download the SailfishOS:Chum GUI application built for the last prior SailfishOS "general availability (GA)" release (e.g. from [the SailfishOS:Chum repository](https://build.sailfishos.org/package/show/sailfishos:chum/sailfishos-chum-gui)), then install or update the SailfishOS:Chum GUI application via `pkcon install-local `, and hope that there is no change in the new SailfishOS release which breaks the SailfishOS:Chum GUI application; if there is, please report that soon at [SailfishOS:Chum GUI application's issue tracker](https://github.com/sailfishos-chum/sailfishos-chum-gui/issues).
* Disclaimer: The SailfishOS:Chum GUI application and its installer may still have flaws, kill your kittens or break your SailfishOS installation! Although this is very unlikely after years of testing by many users, new flaws may be introduced in any release (as for any software). Mind that the license you implicitly accept by using the SailfishOS:Chum GUI application or the SailfishOS:Chum GUI Installer excludes any liability.
### Translating (i18n / l10n) the SailfishOS:Chum GUI application
If you want to translate the SailfishOS:Chum GUI application to a language it does not support yet or enhance an existing translation, please read the [translation README](./translations#readme).
**Translators**: [@atlochowski](https://github.com/atlochowski) (`pl`), [@black-sheep-dev](https://github.com/black-sheep-dev) (`de`), [@carmenfdezb](https://github.com/carmenfdezb) (`es`), [@dikonov](https://github.com/dikonov) (`ru`), [@eson57](https://github.com/eson57) (`sv`), [@jaimeMF](https://github.com/jaimeMF) (`es`), [@martonmiklos](https://github.com/martonmiklos) (`hu`), [@Olf0](https://github.com/Olf0) (`de` etc.), [@okruhliak](https://github.com/okruhliak) (`sk`), [@pherjung](https://github.com/pherjung) (`fr`), [@phklrz](https://github.com/phklrz) (`fr`), [@spodermenpls](https://github.com/spodermenpls) (`de`)
### Screenshots of the SailfishOS:Chum GUI application
| | | |
| :---: | :---: | :---: |
| | | |
|  |  |  |
| Refreshing repository | Main page | Settings page |
| | | |
| | | |
|  |  |  |
| Search available apps | Browse by category | Search installed packages |
| | | |
### Developers
- [Rinigus](https://github.com/rinigus)
- [olf (Olf0)](https://github.com/Olf0)
- [Adam Pigg (piggz)](https://github.com/piggz)
- [Petr Tsymbarovich (mentaljam / osetr)](https://github.com/mentaljam)
### Credits
- [SailfishOS:Chum OBS repository](https://build.sailfishos.org/project/show/sailfishos:chum) hosted at the [SailfishOS-OBS](https://build.sailfishos.org/), which is maintained by [Jolla Group Ltd. / Jollyboys OY](https://jolla.com/)
- [SailfishOS:Chum community repository (source code)](https://github.com/orgs/sailfishos-chum/repositories?type=all) hosted at [GitHub](https://github.com/about)
- [SailfishOS:Chum (GUI) icon(s)](https://github.com/sailfishos-chum/sailfishos-chum-gui-installer/tree/main/.icons#readme) by [olf (Olf0)](https://github.com/Olf0)