A lightweight BetterDiscord plugin to display in-app notifications that focuses on simplicity and efficiency.
- In-app notifications for mentions, DMs, and in-line replies
- Customizable server-specific notifications
- User and channel blocking capabilities
- Privacy mode for content protection
Out of the box, PingNotification will be in "Automatic" mode which will alert for all messages that you physically hear a ping for (aka it follows your discord-level notification settings per guild/channel/user.)
You have the option to swap to "Manual" mode where you can configure which servers/channels you want to ping for. Default behaviour with no configuration performed in manual mode:
- ¬ Mentions
- ¬ Direct Messages (DMs)
- ¬ In-line Replies (same as mention)
¬ Means regardless of the notification settings of that channel
Navigate to BetterDiscord > Plugins > PingNotification settings to:
- Customise coloring of user mentions, role mentions and more.
- Customise length of notification shown on screen
- Change display location of the notification window
- Enable 'Privacy Mode' which hides all message content and attachments behind a
hover-to-revealsystem - Configure the ability to apply 'Privacy Mode' to NSFW channels And much more!
v6.3, 6.3.1, 6.3.2
- Added proper support for spoilered content (text, images and videos) in notifications
- Privacy mode rework, is now clearer and more intuitive
- Now displays Group DMs as 'Group Chat • {Name}'
- Added support for threads in automatic mode
- Now closes all notifications from the same channel/DM when one is clicked
- Added new setting to color user mentions based on their role color
- Added new 'automatic' mode that follows Discord's notification settings directly
- Added new setting to blur all content from NSFW (age restricted) channels, disabled by default
- Updated changelog to use BetterDiscord's UI components
- Fixed issue with un-spoilered images not being clickable to invoke transitionTo
- Fixed role name retrieval for role mentions
- Fixed issue with role color not being applied to mentions
- Disabled image draggable property to prevent choppy swipe animation
- Various other optimizations and fixes. Reduced API calls by roughly 50%. First version of this plugin was very bad at calling the same API multiple times, and with more development over time it was calling the same API multiple times for every single notification
Note: If you experience issues, fully close Discord and delete 'pingnotification.config.json' from your BetterDiscord/plugins folder. Restart Discord to reset the plugin to default settings. You'll need to reconfigure your preferences.
v6.2
- Added context menu items for channels, guilds, threads and users for easy addition/removal from ignored lists
- Completely rewritten settings menus with a new design
- Overhauled popup theme for a more sleek and modern look with better readability
- Completely removed the blacklist/whitelist system. Default behavior is now:
- Whitelist servers you want all notifications for
- Ignore specific channels
- Ignore specific users
Note: If you experience issues, fully close Discord and delete 'pingnotification.config.json' from your BetterDiscord/plugins folder. Restart Discord to reset the plugin to default settings. You'll need to reconfigure your preferences.
v6.1
- Added logic to handle forwarded messages gracefully.
v6.0
- Major change: Moved away from ZeresPluginLibrary to use built-in BdApi.
- General code improvements and optimizations.
v5.4.1
- You can now swipe the notification to the left or right to close it, depending on notification location.
- Added a new setting to show nicknames instead of usernames from the server the message was sent in. Disabled by default.
- Added a new setting to show senders color based on their role from the server the message was sent in. Disabled by default.
- General code improvements and optimizations.
v5.3
- Enhanced settings panel for improved user experience
- Added count indicators for selected channels and guilds
- Introduced privacy mode to blur notification content until hover
- Stickers do not display in the notification window.
If you encounter any problems, please open an issue.
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions, issues, and feature requests are welcome! Feel free to check the issues page.
Give a ⭐️ if this project helped you!