zulip/help/desktop-notifications.md

151 lines
4.2 KiB
Markdown

# Desktop notifications
Zulip offers visual and audible desktop notifications. You can
customize whether [channel messages](/help/channel-notifications),
[direct messages](/help/dm-mention-alert-notifications) and
[mentions](/help/dm-mention-alert-notifications#wildcard-mentions)
trigger desktop notifications.
{start_tabs}
{settings_tab|notifications}
1. Toggle the checkboxes for **Channels** and **DMs, mentions, and alerts**
in the **Desktop** column of the **Notification triggers** table.
{end_tabs}
## Notification sound
You can select the sound Zulip uses for audible desktop notifications. Choosing
**None** disables all audible desktop notifications.
### Change notification sound
{start_tabs}
{settings_tab|notifications}
1. Under **Desktop message notifications**, configure
**Notification sound**.
{end_tabs}
!!! tip ""
To hear the selected sound, click the <i class="fa fa-play-circle"></i> to the right of your selection.
## Unread count badge
By default, Zulip displays a count of your unmuted unread messages on the
[desktop app](https://zulip.com/apps/) sidebar and on the browser tab icon. You
can configure the badge to only count [direct messages](/help/direct-messages)
and [mentions](/help/mention-a-user-or-group), or to include messages in
[followed topics](/help/follow-a-topic) but not other
[channel](/help/channels-and-topics) messages.
### Configure unread count badge
{start_tabs}
{settings_tab|notifications}
1. Under **Desktop message notifications**, configure
**Unread count badge**.
{end_tabs}
### Disable unread count badge
{start_tabs}
{settings_tab|notifications}
1. Under **Desktop message notifications**, select **None** from the
**Unread count badge** dropdown.
{end_tabs}
## Troubleshooting desktop notifications
First, make sure you have enabled
[desktop notifications for DMs](/help/dm-mention-alert-notifications) or for the
[channel](/help/channel-notifications) you are testing with.
Desktop notifications are triggered when a message arrives, and Zulip is not
in focus or the message is offscreen. You must have Zulip open in a browser
tab or in the Zulip desktop app to receive desktop notifications.
**Visual desktop notifications** appear in the corner of your main monitor.
**Audible desktop notifications** make a sound.
The most common issue is that your browser or system settings are blocking
notifications from Zulip.
### Check platform settings
{start_tabs}
{tab|chrome}
1. Click on **Secure** to the left of the URL bar. It should be green and
have a lock icon next to it.
1. Set **Notifications** and **Sound** to **Allow**.
Alternate instructions:
1. Open the Chrome **Edit** menu. Select **Preferences**.
2. On the top left, select the menu icon (<i class="fa
fa-bars"></i>). Select **Advanced**, and then **Privacy & Security**.
Click on **Content settings** (partway down the page), and select
**Notifications**.
3. If the Zulip URL for your organization is listed under **Blocked**,
select the menu icon (<i class="fa fa-ellipsis-v"></i>) to its right, and
click **Remove**.
4. Next to **Allow**, click **Add**.
5. Paste the Zulip URL for your organization into the site field, and click
**Add**.
{tab|firefox}
1. Open the Firefox **Edit** menu. Select **Preferences**.
2. On the left, select **Privacy & Security**. Scroll to the **Permissions**
section and select the **Settings** button next to **Notifications**.
3. Find the URL for your Zulip organization, and adjust the **Status**
selector to **Allow**.
{tab|desktop-app}
**Windows**
1. Click the **Start** button and select **Settings**. Select **System**,
and then **Notifications & actions**.
2. Select **Zulip** from the list of apps.
3. Configure the notification style that you would like Zulip to use.
**macOS**
1. Open your Mac **System Preferences** and select **Notifications**.
2. Select **Zulip** from the list of apps.
3. Configure the notification style that you would like Zulip to use.
{end_tabs}
## Related articles
* [Channel notifications](/help/channel-notifications)
* [DMs, mentions, and alerts](/help/dm-mention-alert-notifications)
* [Email notifications](/help/email-notifications)
* [Mobile notifications](/help/mobile-notifications)
* [Do not disturb](/help/do-not-disturb)