Note Viewer

Standalone app for browsing, filtering, and managing calendar notes.

Access points

MiniCal sidebar button (open-book icon)
BigCal header button (open-book icon)
HUD bar button (open-book icon)

Each button is hidden from a user without the View Note Viewer permission.

Layout

Area	Description
Search bar	Text search input with a clear button, plus a close button; also the drag handle
Filter sidebar	Dropdowns and checkboxes for narrowing results
Results list	Scrollable list of matching notes; more rows load as you scroll to the bottom
Footer	Note count, selection mode toggle, and bulk action controls (GM only)

Filters

Preset

Multi-select dropdown for filtering by note preset. An “Uncategorized” option covers notes with no preset assigned.

Visibility (GM only)

Option	Description
All	Show all notes regardless of visibility
Visible	Only visible notes
Hidden	Only hidden notes
Secret	Only secret notes

Sort

Option	Description
Date (Oldest First)	Oldest first
Date (Newest First)	Newest first
Name (A-Z)	Alphabetical
Name (Z-A)	Reverse alphabetical

Author (GM only)

Filter notes by the user who created them.

Checkbox filters

Filter	Description
All Day	Show only all-day notes
Has Duration	Show only notes with a duration set
Is Recurring	Show only notes that repeat, either from a repeat rule or from a computed recurrence
Is Festival	Show only notes linked to a festival

Text search

To filter notes by name or body text, type two or more characters in the search bar. A single character leaves the list unfiltered. A clear button inside the field resets the search.

When some results match only in the note body, the list splits under two headings. Direct Matches holds the notes whose name contains the term, and Mentioned holds the rest.

Clear filters

When any filter is active, a Clear Filters button appears at the bottom of the filter sidebar. Click it to reset every filter at once.

Results list

The list shows notes from the active calendar and any calendars picked in the Equivalent Date Calendars setting. Notes on other loaded calendars never appear. Switching the active calendar reloads the list. On first open the list scrolls to the first note dated on or after the current date.

Each note row displays:

Element	Description
Color bar	The note’s color
Icon	The note’s configured icon
Name	Note title
Date	Formatted start date
Preset badges	Up to four preset icons with colors
Status tags	Icons for hidden/secret, has duration, recurring, and festival

An empty result shows one of two messages. When the calendar holds notes but none pass the filters, the list reads “No notes match the current filters.” When the calendar holds no notes at all, it reads “Create notes from the calendar to see them here.”

Interactions

Click a note row to open it in view mode
Double-click a note row to open it in edit mode (GM or note owner)
Right-click a note row for the context menu

Note count

The footer shows a “Showing X of Y” count. Y covers only the calendars the list is scoped to. For a non-GM, Y counts only the notes that user can see. Hover the count for a tooltip listing the included calendar names. When that total is zero, the footer reads “No notes found” instead of a count.

Right-click any note row for these options:

Action	Description
Open	Open the note in view mode
Edit	Open the note in edit mode (GM or note owner)
Jump to Date	Navigate the calendar to the note’s start date
Delete	Delete the note with confirmation (GM only)
Add Note	Create a new note at the current date and time (requires the Add Notes permission)

Creating notes

To create a note at the current game date and time, click the ”+” button in the bottom-right corner of the results list, or right-click any note row and pick Add Note. Both are hidden from a user without the Add Notes permission.

Bulk operations

GMs can act on several notes at once through selection mode.

Entering selection mode

Click the selection toggle in the footer (check-square icon), and checkboxes appear on each note row.

Selecting notes

Click a checkbox to select or deselect one note
Shift-click a checkbox to select every note between the last selected note and the clicked one
Use the Select All checkbox in the footer to select or deselect all filtered notes

While selection mode is on, clicking or double-clicking a row no longer opens the note. Only the checkbox responds.

Available bulk actions

When notes are selected, these buttons appear in the footer:

Action	Icon	Description
Delete	Trash	Delete all selected notes, with confirmation. Festival-linked notes are skipped.
Change Preset	Tag	Replace every preset on the selected notes with one chosen from a dialog
Change Visibility	Eye	Set visibility (visible/hidden/secret) for all selected notes via a dialog
Change Display Style	Palette	Set display style (icon/pip/banner) for all selected notes via a dialog

If every selected note is festival-linked, a warning appears and Delete never opens its confirmation dialog.

Bulk action buttons stay disabled until at least one note is selected. Completing an action exits selection mode and clears the selection, while cancelling the dialog leaves the selection intact. To leave selection mode by hand, click the selection toggle again (X icon).

For developers

See API Reference and Hooks.