mrkeyoor.com_
Fri 16 Oct 16:50 UTC
Automationevaluationupdated 15 Oct 2026

supersidian review

Supersidian brings handwritten Supernote pages into dated Obsidian notes, adds live pen previews, and uses Claude Code for transcription and related-note links. It is a personal Linux desktop workflow whose README explicitly says it has no license and offers no support for other setups.

trackingstars / 7d
Verdict

Our Supersidian run passed all 25 tests after a 2-second install, but the README explicitly offers no license and no support for other setups. Treat it as a personal workflow to study until code-use permission and device compatibility are settled. Most Supernote owners should start with a community plugin that targets other users.

We ran it

Lab card: what happened when we ran supersidianScreenshot of supersidian (github.com/aicheye/supersidian)
Install✓ · 2s18 packages · 53 MB
Build✓ · 1s
Tests✓ · 1s25 passed · 0 failed of 25 (node:test)
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo84 files~7,000 lines of source · 1 MB · 0 CI workflows · tests dir

Answers from our run

Does supersidian build from source?

Dependencies installed in 2 seconds (18 packages), and the build succeeded in 1 seconds. We cloned commit 7272a1e into a clean Debian container with 3 CPUs and no project-specific setup.

Do supersidian's tests pass?

Yes: 25 of 25 passed when we ran the project's own test command (node:test). Some failures need services or credentials a bare container does not have.

Does supersidian have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use supersidian?

Teams needing licensed reusable code: the README says there is no license, and package.json marks it UNLICENSED.

What are the alternatives to supersidian?

Supernote (Unofficial), Supsidian. Our Supersidian run passed all 25 tests after a 2-second install, but the README explicitly offers no license and no support for other setups.

Setup2/5Quick npm checks; manual Linux, Python, adb, and tablet setup
Docs4/5Detailed workflow and failure limits; explicitly personal scope
Community1/5October push; no public issue activity returned or support offered
Maturity2/525 tests pass; no license and compatibility limited to author setup

Who it’s for

Supernote and Obsidian users studying a detailed example of a course-based handwriting workflow.
Linux developers evaluating live-ink and notebook-sync design on comparable hardware.
Readers prepared to clarify code-use permission and maintain a personal integration themselves.

Who it’s NOT for

Teams needing licensed reusable code: the README says there is no license, and package.json marks it UNLICENSED.
Users expecting supported desktop or device compatibility: the author supports only their own setup and documents Linux plus a specific Nomad firmware.
Anyone planning wireless adb access: the README says the tablet accepts adb connections without a key and requires USB-only adb.
Users who need every notebook to sync wirelessly regardless of activity: only notebooks saved or closed while the tablet plugin runs are sent.
People who want transcription without a Claude Code account: the documented route uses that login.

Setup reality

Our run of commit 7272a1e installed 18 packages in 2 seconds and used 53 MB on disk. The build passed in 1 second, and all 25 node:test cases passed in 1 second with 0 failures. Npm audit reported 0 known vulnerabilities across all severity levels. The Debian sandbox had 3 CPUs, 8 GB of RAM, and no secrets.

Actual use requires Linux desktop Obsidian, a host adb server, a Python environment with supernotelib, and a separately built tablet plugin on compatible Chauvet firmware. Transcription uses a Claude Code login. The documented school automation also connects Gmail and Google Calendar, while optional wireless sync needs Tailscale on both devices and USB token setup.

The author explicitly offers no license or support for other setups. Keep adb on USB because the documented tablet firmware lacks adb authentication. Our software checks did not verify physical-device sync, transcription, or companion packaging.

Supersidian is public to read and has no license

Supersidian's README opens by saying it was built for one tablet, one laptop, and one vault. It explicitly offers no support for other setups and says it has no license. You can learn from a detailed personal workflow here, but a publicly visible repository is insufficient grounds to adopt or redistribute its code.

Our 25 passing tests show that its checked software path works in a sandbox. They do not broaden that promise of support. The actual workflow is unusually specific: handwritten Supernote pages become images inside dated Obsidian lecture notes, then Claude Code transcribes them and links related material. It makes the most sense to someone whose school notes already resemble the author's course-and-term folder structure.

What happened when we ran it

Our run of commit 7272a1e installed 18 npm packages in 2 seconds and used 53 MB on disk. The build passed in 1 second, followed by 25 passing node:test cases in another 1 second, with 0 failures. We ran it on October 15, 2026 in the lab-node:22 image, using an unprivileged Debian container with 3 CPUs, 8 GB of RAM, and no secrets.

Npm audit reported 0 known vulnerabilities, including 0 critical, high, moderate, or low advisories. The checkout contained 84 files, about 7,000 source lines, and occupied 1 MB. It had a tests directory, no CI workflow files, and no Dockerfile. These are reassuring repository checks for a small tool, without evidence that a physical tablet, Obsidian session, or transcription login participated in the run.

The 53 MB footprint covers the measured npm environment. The README separately calls for a Python renderer using supernotelib, host adb access, and a tablet plugin. Our measurement does not establish that the Android companion was packaged or that an actual notebook survived a complete sync.

The desktop plugin expects Linux and a particular tablet setup

The README identifies the Obsidian component as desktop Linux software and names a Nomad running a particular Chauvet beta firmware as its device reference. Setup includes enabling sideloading, starting a host adb service, and symlinking plugin files into the vault. Flatpak users also receive an MTP access step. This is a manually assembled desktop integration rather than an install-and-forget community plugin.

A 2-second npm install therefore understates the work needed to reproduce the author's environment. The renderer needs its own Python environment, and the companion plugin needs a separate build and installation on the Supernote. Changing hardware or firmware means taking responsibility for behavior the author does not support. If you mainly want to view exported handwriting in Obsidian, the live pen integration is probably an unnecessary commitment.

Notebook pages follow their creation dates into lecture notes

Supersidian maps the tablet's term and course folders to matching vault folders, then embeds page images into notes for the dates on which the pages were created. Text typed underneath an image stays with that page across syncs, and text from a deleted page moves to the end of the managed block.

The 84-file checkout also contains the live-ink machinery that makes this more than a file converter. The tablet sends pen positions and finished outlines, and Obsidian draws them over the saved page image. Those strokes live in a temporary display layer until a saved image catches up. The README says restarting Obsidian drops unsaved live strokes, which matters if you mistake the laptop preview for a durable copy of the notebook.

Wireless sync uses Tailscale because tablet adb lacks authentication

The known limits say the tablet firmware accepts adb connections without a key and instruct users to keep adb on USB. The optional wireless path instead sends HTTPS requests through Tailscale to a localhost server on the laptop. Requests carry a token transferred over USB. That design avoids making the tablet's unauthenticated adb service the wireless entry point.

Our 25 tests do not validate your tailnet policy or firmware configuration. Wireless transfer also has a documented completeness limit: only notebooks saved or closed while the tablet plugin runs are sent. This can leave an older notebook absent from the laptop even when networking works. Establish what has actually transferred before relying on a cable-free session, and keep the source notebook as the reference when comparing pages.

Transcription depends on a Claude Code login

The transcription route runs claude -p using the user's Claude Code login rather than a separate API key. It creates collapsed page transcripts and uses extracted concepts to connect related notes. The README also describes Gmail reading for deadlines and Google Calendar updates. Those account integrations belong in the setup decision, particularly if you want handwriting conversion without connecting your school workflow to additional services.

The 1-second build cannot tell you whether a transcription preserves a formula, a name, or an assignment date. Check those against the page image. Supersidian preserves the handwriting alongside generated text, which gives you something concrete to compare. Deadline completion also remains manual according to the README, so the dashboard should not be treated as proof that coursework was submitted.

October activity does not change the unsupported status

GitHub recorded a push on October 2, 2026, with 0 stars and 0 open issues and PRs. The recent issue endpoint returned no entries, and no latest release was returned. The absence of an issue queue cannot establish reliability or an available support channel.

The passing 25-test run makes Supersidian interesting to inspect, but its stated lack of a license and support keeps it off my general recommendation list. Compare Supernote (Unofficial) for a community-plugin route, or Supsidian for a macOS workflow with selectable OCR. If this author's lecture layout is exactly what you need, clarify code-use permission before deciding to reproduce the setup.

Alternatives

ProjectWhat it isPick it when
Supernote (Unofficial)An Obsidian community plugin for viewing, importing, and exporting Supernote notes.pick this instead when you want a community-plugin route rather than reproducing a personal Linux setup.
SupsidianA macOS menu-bar app and CLI for moving Supernote notes into Obsidian with selectable OCR.pick this instead when you use macOS and prefer manual sync with an OCR provider choice.

What people are saying

  1. [velocity-scout] aicheye/supersidian

Sources

  1. Supersidian README, setup, and known limits
  2. Package metadata and unlicensed status
  3. Desktop plugin manifest
  4. Claude Code transcription implementation
  5. Local authenticated upload server
  6. Supernote (Unofficial)
  7. Supsidian

More automation reviews

genspark-claw · orc-claude-plugin · tiktok-views-bot · Ydisks-Xianyu-Helper · jev-gui-delegate · company-brain · the whole board →