AO3: Badge for Unread Inbox Messages

puts a little notification badge in the menu for unread messages in your AO3 inbox

Author
escctrl
Daily installs
0
Total installs
33
Ratings
0 0 0
Version
1.1
Created
2023-09-09
Updated
2024-04-02
License
MIT
Applies to

You have unread messages!

This script adds a little notification badge into the menu (top right of the screen, left of your usericon and the "Hi, [user]!" greeting), if you have unread messages in your AO3 inbox. This badge displays on every AO3 page, as long as you're logged in.



Selecting the badge takes you directly to your AO3 inbox, filtered to only show you the unread messages.

If you don't have any unread messages, the badge is hidden completely.

Configuration

There are a few configuration options for you in the first few lines of the code:

  • REFRESH_INTERVAL ... set the number of hours, how often the script will check for new messages; by default it's set to 12 hours
  • BADGE_ICON ... set to true for an envelope icon, or to false to see the AO3-standard "Inbox (#)" text
  • HIGHLIGHT_COLOR ... set a background color for the badge to stand out more, or if you don't want it to have a background, leave the quotes empty
  • FILTER_INBOX ... set to true if you'd like the sidebar links to the Inbox to automatically filter for unread messages

How it works

While you're browsing AO3, the script will load your dashboard in the background to check for unread inbox messages every few hours (configured in REFRESH_INTERVAL). It does NOT send you notifications for new messages immediately as they arrive. That kind of functionality is not supported by AO3. But you can reduce the lag time by reducing the interval.