DEV Community

Masih Maafi
Masih Maafi

Posted on

Rustidian 0.1.7: try my Rust notes app with npx

Rustidian is a Markdown notes app I'm building in Rust for Linux. It opens Obsidian-format vaults as plain folders, with a native egui interface instead of Electron. Version 0.1.7 went out this morning, and the main change is that you can now try it without picking a package format first.

One line to try it

npx rustidian
Enter fullscreen mode Exit fullscreen mode

Or keep it installed with npm i -g rustidian. Both need Linux x86_64.

I didn't want npm to become a second build of the app. So the package is a small Node script, about 140 lines. On the first run it downloads rustidian-linux-x86_64.tar.gz and SHA256SUMS from the matching GitHub release. Then it hashes the archive and compares the result with the checksum file. If they match, it extracts the archive into one folder and starts the binary. Later runs skip the download and start right away. The binary you get is the same one that the .deb and the tarball ship, built and checked by the release workflow.

The launcher source is short if you want to read it before you run it.

What changed in the app

  • It remembers where you were. Reopening Rustidian brings back the last vault, its tabs, and the scroll position of each page.
  • Links outside the vault. A link to a note in another folder, or through a symlink, opens as a tab next to the note you're reading. Before, it went to the browser.
  • Rendering fixes. Inline data: images show up instead of "Image unavailable". SVG text uses Rustidian's fonts, draws off the UI thread, and stays crisp at the page's size.
  • Numbered lists. Enter on a numbered item now renumbers the items below it, so no number repeats.
  • A new icon. The pink Signature logo, without the inner glow, is now the icon in the packages.

A contributor's fix

The AppImage had no writable demo vault to open on first launch. Oikantik Basu (Golden007-prog) sent PR #8. It copies the bundled demo vault into the app's data folder, so you can open the AppImage and start editing at once. It came with tests, and it's in this release. Thank you, Oikantik.

Other ways to install

The Debian package is still the main route. Download the .deb and SHA256SUMS, then run:

sha256sum --check --ignore-missing SHA256SUMS
sudo apt install ./rustidian-linux-amd64.deb
rustidian
Enter fullscreen mode Exit fullscreen mode

The release page also has the AppImage and a portable tarball. You need glibc 2.39 or newer, so Ubuntu 24.04 or later.

What it doesn't do yet

Obsidian community plugins don't run, and Canvas and Bases are missing. Try it on a copy of your vault first. If something breaks, an issue helps a lot, and PR #8 shows that a first contribution can be small and still matter.

Top comments (0)