https://github.com/ether/ep_desktop_notifications

Etherpad Desktop Chat Notifications
https://github.com/ether/ep_desktop_notifications

Last synced: 6 months ago
JSON representation

Etherpad Desktop Chat Notifications

• Host: GitHub
• URL: https://github.com/ether/ep_desktop_notifications
• Owner: ether
• License: other
• Created: 2013-03-19T02:45:34.000Z (almost 13 years ago)
• Default Branch: main
• Last Pushed: 2025-02-17T12:03:41.000Z (about 1 year ago)
• Last Synced: 2025-06-16T14:49:47.915Z (9 months ago)
• Language: JavaScript
• Homepage:
• Size: 3.83 MB
• Stars: 5
• Watchers: 6
• Forks: 13
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
![Publish Status](https://github.com/ether/ep_desktop_notifications/workflows/Node.js%20Package/badge.svg) ![Backend Tests Status](https://github.com/ether/ep_desktop_notifications/workflows/Backend%20tests/badge.svg)

# Desktop Chat Notifications

![Screenshot](https://user-images.githubusercontent.com/64109265/81602939-c7547080-93cd-11ea-84a1-a06fde79926f.png)

Get notifications on your desktop when someone sends a chat message to your pad.

No matter, if you are on another browser tab or if you've minimized your browser.

Works on Chrome and on Firefox. Should work fine in all webkit browsers.

See the [compatibility table] to see which browsers support native desktop notifications.

For other browsers there might be add-ons.

# HOW TO USE (tm)

When loading a pad, desktop notifications are enabled by default.

Notifications can be disabled for each pad via the pad's settings.

You can change the initial state:

* with a settings entry:

    * `"ep_desktop_notifications_default": false,`

* or with an URL parameter:

    * http://URL?DesktopNotifications=false

The first time you open a pad with activated desktop notifications,

your browser asks for your permission to show notifications.

This permission is valid for the given host running your etherpad service.

You can change or reset the permission anytime in your browser settings

(e.g. for Firefox: Page Info/Ctrl-I - Permissions - Show Notifications).

# TODO

* Test URL parameter feature.

# WHY

Etherpad-lite is a perfect match for small distributed

project teams and deserves a much bigger user base.

The plugin ep_desktop_notifications (in combination

with e.g. ep_real_time_chat, ep_headings and ep_markdown)

is an important step towards world dominance. ;-)

# License

Apache 2

[compatibility table]: https://developer.mozilla.org/en-US/docs/Web/API/notification#Browser_compatibility