Usage Overview¶

Once loaded:

%load_ext jupyternotifyplus

You have two main commands: - %notifyme — triggers a notification after the cell finishes - %notifyme here — triggers a notification immediately at that line

Startup Permission Check¶

On %load_ext or %reload_ext the extension checks notification permission and acts accordingly:

if permission is granted nothing is shown;
if default a compact yellow banner appears on the left with Request and Dismiss;
if denied the same left banner appears with a Dismiss button and brief instructions to enable notifications via the browser site settings.

When native notifications are unavailable or blocked the extension falls back to an in‑page toast so messages remain visible.

Notification Execution Behaviour¶

%notifyme schedules a notification for the next executed cell. To ensure predictable behaviour:

Notifications do not fire when a notebook is opened.
Notifications only fire after a real cell execution.
Internal state is stored privately and cleared immediately after use.
No state is written into the user namespace.

This prevents stale notifications from appearing when reopening notebooks and ensures that %notifyme behaves consistently across sessions.

End-of-cell notification¶

%notifyme -t "Done" -m "Cell finished"

Inline notification¶

%notifyme here -t "Checkpoint" -m "Reached step 1"

You can use as many inline notifications as you want.

Variable and Expression Resolution¶

%notifyme supports Python variable names, expressions, and f‑strings inside the -t (title) and -m (message) arguments.

This allows you to write expressive, dynamic notifications without string‑escaping or manual formatting.

Examples¶

Using variables¶

a = "Hello World"
%notifyme success -t a

The notification title becomes:

Hello World

Using f‑strings¶

%notifyme success -t f"1+1={1+1}"

Title:

1+1=2

Using expressions¶

%notifyme -t "3 * 7"

Title:

Resolution Rules¶

%notifyme resolves values using the following logic:

If the argument matches a variable name in the user namespace, its value is used.
Otherwise, the argument is evaluated as a Python expression (e.g., f‑strings, arithmetic).
If evaluation fails, the literal string is used unchanged.

This makes %notifyme flexible while remaining safe and predictable.