Revise README for clarity and accuracy

This commit is contained in:
Lukas Pieper 2025-10-19 13:40:33 +02:00 committed by GitHub
parent 526007e2b6
commit 1a11af7e16
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -3,14 +3,13 @@
[![continuous](https://github.com/lukaspieper/Gcam-Services-Provider/workflows/continuous/badge.svg)](https://github.com/lukaspieper/Gcam-Services-Provider/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/lukaspieper/Gcam-Services-Provider/blob/master/LICENSE)
This app "simulates" the Google Play Services that the Google Camera app (Gcam) requires, allowing the camera app to be
used on devices without Google Play Services.
This app 'simulates' certain components of Google Play Services required by the Google Camera (Gcam) app, enabling it
to be used on devices without Google Play Services.
### Comparison: [GrapheneOS' Gcam support](https://grapheneos.org/usage#google-camera)
> [!NOTE]
> The only reason to consider Gcam-Services-Provider on GrapheneOS is the ability to use the button in Gcam that opens
> the last taken photo without having Google Photos installed. If you can do without it, you don't need this app.
> [!IMPORTANT]
> On GrapheneOS the *photosonly* flavor is the only one that is supported.
Since April 2023 GrapheneOS is able to run Gcam without additional steps. Here is the relevant part of
the [changelog](https://grapheneos.org/releases#2023040400):
@ -19,6 +18,9 @@ the [changelog](https://grapheneos.org/releases#2023040400):
> Google Camera [...] to work without GSF installed since they don't have any actual hard dependency on either GSF or
> Play services
However, the button that opens the last photo taken won't work unless Google Photos is installed. If you want to use
your favourite gallery app instead, install the *photosonly* flavor of this app.
### Comparison: [microG](https://github.com/microg)
microG is a open source re-implementation of the Google Play Services (client side). Among other
@ -35,10 +37,10 @@ access).
There are three flavors of this app named *basic*, *photos*, and *photosonly*. All come without UI and therefore have no
icon in the app drawer. But of course the installation is listed in the Android settings (e.g. for uninstallation).
*Basic* includes everything you need to get Gcam running but the button showing the last taken photo in full size will
not work. The *photosonly* flavor supports this button but does not provide the features of the *basic* flavor; it is
meant to be used on GrapheneOS alongside the sandboxed Play Services. The *photos* flavor has all features from *basic*
and *photosonly* combined in one app.
*Basic* includes everything you need to get Gcam running but the button opening the last taken photo will not work. The
*photosonly* flavor supports this button but does **not** provide the features of the *basic* flavor; it is meant to be
used alongside Play Services/microg. The *photos* flavor has all features from *basic* and *photosonly* combined in one
app.
| Flavor | Incompatible apps | Download |
|--------------|-------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
@ -46,11 +48,7 @@ and *photosonly* combined in one app.
| *Photosonly* | - Google Photos | [GitHub](https://github.com/lukaspieper/Gcam-Services-Provider/releases) |
| *Photos* | - Google Service Framework (GSF)<br/>- microg<br/>- Google Photos | [GitHub](https://github.com/lukaspieper/Gcam-Services-Provider/releases) |
### Gcam Compatibility
### Gcam compatibility
[Compatible Android OS](https://github.com/lukaspieper/Gcam-Services-Provider/discussions/28) ([#22](https://github.com/lukaspieper/Gcam-Services-Provider/issues/22#issuecomment-814239882)) or modded Gcam
## Known from/recommended by
- [GCam Hub (celsoazevedo)](https://www.celsoazevedo.com/files/android/google-camera/troubleshooting/)
- [Kuketz-Blog (German IT security and privacy blog)](https://www.kuketz-blog.de/?s=gcam+services+provider)
* Use a [compatible Android OS](https://github.com/lukaspieper/Gcam-Services-Provider/discussions/28) ([#22](https://github.com/lukaspieper/Gcam-Services-Provider/issues/22#issuecomment-814239882)) or modded Gcam
* Gcam version 10.x is currently unsupported ([#190](https://github.com/lukaspieper/Gcam-Services-Provider/issues/190))