Updated FAQ

master
M66B 1 month ago
parent cbd1f7f36b
commit a5ac560154

@ -478,9 +478,7 @@ The following Android permissions are **required**:
* *prevent device from sleeping* (WAKE_LOCK): to keep the device awake while performing actions, like synchronization of messages
* *use fingerprint hardware* (USE_FINGERPRINT) and *use biometric hardware* (USE_BIOMETRIC): to use biometric authentication (fingerprint, face unlock, etc.)
* *ask to ignore battery optimizations* (REQUEST_IGNORE_BATTERY_OPTIMIZATIONS): to disable battery optimizations, please see [this FAQ](#faq175) for more information
* *allow the app to show notifications* (POST_NOTIFICATIONS): to show new message notifications and (account) warnings and errors (Android 13 and later only)
* *Google Play (in-app) billing service* (BILLING): for in-app purchases
* *Nearby devices* (ACCESS_LOCAL_NETWORK): to access email servers via local network addresses (Android 17 and later only; not available in the Play Store release)
<br />
@ -491,7 +489,9 @@ The following Android permissions are **optional**:
* *read the contents of your shared storage (SD card)* (READ_EXTERNAL_STORAGE): to accept files from other, outdated apps, see also [this FAQ](#faq49)
* Android 5.1 Lollipop and before: *use accounts on the device* (USE_CREDENTIALS): to select an account when using the Gmail quick setup (not requested on later Android versions)
* Android 5.1 Lollipop and before: *Read profile* (READ_PROFILE): to read your name when using the Gmail quick setup (not requested on later Android versions)
* *allow the app to show notifications* (POST_NOTIFICATIONS): to show new message notifications and (account) warnings and errors (Android 13 and later only)
* GitHub version only: *read and write calendar data* (READ_CALENDAR/WRITE_CALENDAR): to [auto-store invitations](#faq186)
* GitHub version only: *nearby devices* (ACCESS_LOCAL_NETWORK): to access email servers via [local network addresses](#faq210) (Android 17 and later only)
[Optional permissions](https://developer.android.com/training/permissions/requesting) are supported on Android 6 Marshmallow and later only.
On earlier Android versions, you will be asked to grant the permissions on installing FairEmail.
@ -3974,6 +3974,12 @@ So, you don't have to disable this option if you don't have an EU SIM or are not
&#x1F30E; [Google Translate](https://translate.google.com/translate?sl=en&u=https%3A%2F%2Fm66b.github.io%2FFairEmail%2F%23faq106)
**Because badge counters are not supported by Android as released by Google, there are fewer and fewer devices that support badge counters.**
The best and most compatible option is to use the unread message count home screen widget.
<br>
Please [see here](https://github.com/leolin310148/ShortcutBadger#supported-launchers)
for a list of launchers which can show the number of unread messages.
Standard Android [does not support this](https://developer.android.com/training/notify-user/badges).
@ -3993,7 +3999,7 @@ This feature depends on support of your launcher.
FairEmail merely 'broadcasts' the number of unread messages using the ShortcutBadger library.
If it doesn't work, this cannot be fixed by changes in FairEmail.
An alternative is to use the unread messages count home screen widget.
An alternative is to use the unread message count home screen widget.
You can add this widget by long pressing on an empty place on the home screen.
If you are using Nova launcher and you want to show the number of notifications in the launcher icon (maximum 10; imposed by Nova launcher),

@ -462,9 +462,7 @@
<li><em>prevent device from sleeping</em> (WAKE_LOCK): to keep the device awake while performing actions, like synchronization of messages</li>
<li><em>use fingerprint hardware</em> (USE_FINGERPRINT) and <em>use biometric hardware</em> (USE_BIOMETRIC): to use biometric authentication (fingerprint, face unlock, etc.)</li>
<li><em>ask to ignore battery optimizations</em> (REQUEST_IGNORE_BATTERY_OPTIMIZATIONS): to disable battery optimizations, please see <a href="#faq175">this FAQ</a> for more information</li>
<li><em>allow the app to show notifications</em> (POST_NOTIFICATIONS): to show new message notifications and (account) warnings and errors (Android 13 and later only)</li>
<li><em>Google Play (in-app) billing service</em> (BILLING): for in-app purchases</li>
<li><em>Nearby devices</em> (ACCESS_LOCAL_NETWORK): to access email servers via local network addresses (Android 17 and later only; not available in the Play Store release)</li>
</ul>
<p><br /></p>
<p>The following Android permissions are <strong>optional</strong>:</p>
@ -474,7 +472,9 @@
<li><em>read the contents of your shared storage (SD card)</em> (READ_EXTERNAL_STORAGE): to accept files from other, outdated apps, see also <a href="#faq49">this FAQ</a></li>
<li>Android 5.1 Lollipop and before: <em>use accounts on the device</em> (USE_CREDENTIALS): to select an account when using the Gmail quick setup (not requested on later Android versions)</li>
<li>Android 5.1 Lollipop and before: <em>Read profile</em> (READ_PROFILE): to read your name when using the Gmail quick setup (not requested on later Android versions)</li>
<li><em>allow the app to show notifications</em> (POST_NOTIFICATIONS): to show new message notifications and (account) warnings and errors (Android 13 and later only)</li>
<li>GitHub version only: <em>read and write calendar data</em> (READ_CALENDAR/WRITE_CALENDAR): to <a href="#faq186">auto-store invitations</a></li>
<li>GitHub version only: <em>nearby devices</em> (ACCESS_LOCAL_NETWORK): to access email servers via <a href="#faq210">local network addresses</a> (Android 17 and later only)</li>
</ul>
<p><a href="https://developer.android.com/training/permissions/requesting">Optional permissions</a> are supported on Android 6 Marshmallow and later only. On earlier Android versions, you will be asked to grant the permissions on installing FairEmail.</p>
<p><br /></p>
@ -2116,13 +2116,16 @@ category:promotions</code></pre>
<p><br /></p>
<p><a name="faq106"></a> <strong>(106) Which launchers can show a badge count with the number of unread messages?</strong></p>
<p>🌎 <a href="https://translate.google.com/translate?sl=en&amp;u=https%3A%2F%2Fm66b.github.io%2FFairEmail%2F%23faq106">Google Translate</a></p>
<p><strong>Because badge counters are not supported by Android as released by Google, there are fewer and fewer devices that support badge counters.</strong></p>
<p>The best and most compatible option is to use the unread message count home screen widget.</p>
<p><br></p>
<p>Please <a href="https://github.com/leolin310148/ShortcutBadger#supported-launchers">see here</a> for a list of launchers which can show the number of unread messages. Standard Android <a href="https://developer.android.com/training/notify-user/badges">does not support this</a>.</p>
<p>Note that Nova Launcher requires Tesla Unread, which is <a href="https://forum.xda-developers.com/android/general/bad-news-tesla-unread-devoloper-t3920415">not supported anymore</a>.</p>
<p>Note that the notification setting <em>Show launcher icon with number of new messages</em> needs to be enabled (default enabled).</p>
<p>Only <em>new</em> unread messages in folders set to show new message notifications will be counted, so messages marked unread again and messages in folders set to not show new message notification will not be counted.</p>
<p>Depending on what you want, the notification settings <em>Let the number of new messages match the number of notifications</em> needs to be enabled (default disabled). When enabled the badge count will be the same as the number of new message notifications. When disabled the badge count will be the number of unread messages, independent if they are shown in a notification or are new.</p>
<p>This feature depends on support of your launcher. FairEmail merely broadcasts the number of unread messages using the ShortcutBadger library. If it doesnt work, this cannot be fixed by changes in FairEmail.</p>
<p>An alternative is to use the unread messages count home screen widget. You can add this widget by long pressing on an empty place on the home screen.</p>
<p>An alternative is to use the unread message count home screen widget. You can add this widget by long pressing on an empty place on the home screen.</p>
<p>If you are using Nova launcher and you want to show the number of notifications in the launcher icon (maximum 10; imposed by Nova launcher), youll need to enable <em>Notification access</em> in the Android <em>Special app access</em> settings for Nova launcher on recent Android versions.</p>
<p>Some launchers display a dot or a 1 for <a href="#faq2">the monitoring notification</a>, despite FairEmail explicitly requesting not to show a <em>badge</em> for this notification. This could be caused by a bug in the launcher app or in your Android version. Please double check if the notification dot (badge) is disabled for the receive (service) notification channel. You can go to the right notification channel settings via the notification settings of FairEmail. This might not be obvious, but you can tap on the channel name for more settings.</p>
<p>FairEmail does send a new message count <em>broadcast</em> intent as well:</p>

Loading…
Cancel
Save