NBDIFF-WEB(1)

💖 NBDIFF-WEB(1) 💖

okay so bestie, welcome to nbdiff-web — it lives in the User Commands section of the manual, and it is literally the diff tool for Jupyter notebooks. yes, the one you've been wanting. no cap.

---

✨ NAME ✨

nbdiff-web — compute the difference between two Jupyter notebooks 🦋

---

🌸 DESCRIPTION 🌸

Here's how you call her, exactly as she comes:

usage: nbdiff-web [-h] [--version] [--config]
       [--log-level {DEBUG,INFO,WARN,ERROR,CRITICAL}] [-p PORT] [-b
       BROWSER] [--persist] [--ip IP] [-w WORKDIRECTORY] [--base-url
       BASE_URL] [--show-unchanged] [--identical-lines-margin
       IDENTICAL_LINES_MARGIN] [-s] [-o] [-a] [-m] [-i] [-d] [base]
       [remote] [paths ...]

It's the difftool for Nbdime. that's the whole vibe. 💅

---

🎀 positional arguments 🎀

These are the lil cuties you hand over without a flag in front of them:

• base — the base notebook filename OR a base git-revision. either one, she's flexible. 💜
• remote — the remote modified notebook filename OR a remote gitrevision. yes, "gitrevision" is one word here, that's how she spells it, we don't argue. 🙈
• paths — filter diffs for git-revisions based on path. only matters when you're doing the git-revision thing. 👑

---

🔥 OPTIONS 🔥

the main character section. buckle up, she has range.

• -h, --help — show this help message and exit. classic, iconic, always there for you. 🫶
• --version — show program's version number and exit. one number, then she's gone. 💨
• --config — list the valid config keys and their current effective values. like a vibe check for your settings. ✨
• --log-level {DEBUG,INFO,WARN,ERROR,CRITICAL} — set the log level by name. pick your volume: DEBUG, INFO, WARN, ERROR, or CRITICAL. 🔊
• -p, --port PORT — specify the port you want the server to run on. default is 0, which means random. she'll pick one, she's got taste. 🎲
• -b, --browser BROWSER — specify the browser to use, to override the system default. yes you can force her hand on this. 🌈
• --persist — prevent server shutting down on remote close request (when these would normally be supported). she stays. 💅
• --ip IP — specify the interface to listen to for the web server.

⚠️ NOTE: setting this to anything other than 127.0.0.1/localhost might comprimise the security of your computer. use with care! (yes, "comprimise" — we're quoting her exactly, the typo is canon, do NOT come for her 💀)

• -w, --workdirectory WORKDIRECTORY — specify the working directory you want the server to run from. default is the actual cwd at program start. 🏠
• --base-url BASE_URL — the base URL prefix under which to run the web app. 🦋
• --show-unchanged — show unchanged cells by default. sometimes you want the whole picture, and that's valid. 👑
• --identical-lines-margin IDENTICAL_LINES_MARGIN — margin for collapsing identical lines in editor; set to -1 to deactivate. 🌸

---

🧚 ignorables 🧚

set which parts of the notebook (not) to process. this is the "choose your own adventure" section, and honestly? obsessed.

each one of these comes as a pair — one side processes, one side ignores:

• -s, --sources, -S, --ignore-sources — process/ignore sources. 📝
• -o, --outputs, -O, --ignore-outputs — process/ignore outputs. 📤
• -a, --attachments, -A, --ignore-attachments — process/ignore attachments. 📎
• -m, --metadata, -M, --ignore-metadata — process/ignore metadata. 🏷️
• -i, --id, -I, --ignore-id — process/ignore identifiers. 🆔
• -d, --details, -D, --ignore-details — process/ignore details not covered by other options. the catch-all, the "everything else" bucket. 🗂️

lowercase = do it, uppercase = skip it. iykyk. 💖

---

and that's the whole page, bestie — nothing skipped, nothing faked, every flag accounted for. 🫶

signing off: this was nbdiff-web version 4.0.4, dated February 2026, straight from the NBDIFF-WEB(1) page. mwah. 💋✨