Repository navigation
QuartzControl 1.0.0-beta.2
Pre-releaseThe second beta. It answers the first round of feedback — most of all a macOS package that would
not start, and a preview that showed a 404 for every project with notes of its own. Feedback is
still welcome — an issue is the easiest way.
What changed since 1.0.0-beta.1
Fixed
- macOS: “QuartzControl is damaged” is gone. Beta 1 carried a broken signature, which macOS
reports as a damaged download. The app is now ad-hoc signed across the whole bundle; the first
launch is refused like any app without a Developer ID and can be allowed (see below). - No bouncing icon in the Dock during every build and every preview on macOS.
- The AppImages start without extra libraries. Their startup program is now statically
linked. The arm64 AppImage of beta 1 neededlibz.so, which Debian only ships with its
development packages, and did not start without it. - The preview no longer shows a 404 without saying why. Quartz builds no start page when
content/index.mdis missing, which is the normal case for copied notes or a linked vault. The
app now says so on the overview, on Preview & build and on the content folder, and offers to
create the start page — with a title, and naming the folder first when that folder is a linked
vault, that is, your own notes. - The Quartz core update card showed your project's own last commit as “installed”. It now
shows the newest Quartz commit the project contains, and how many are missing. - A plugin entry without
enabled:is shown as off — that is what the build does. Saving used
to switch such an entry on silently. - The frame editor asks before deleting an area that still holds something, tells you on every
breakpoint when one of your own areas is hidden there, and no longer takes the keyboard focus
away when switching breakpoints.
New
- A running build is visible everywhere — elapsed time and Quartz' current phase on Preview &
build and on the overview, still there after leaving the page. A second click joins the running
build instead of starting another one into the same folder. - The window reopens where it was, size and monitor included. If that monitor is gone, it opens
on the main one. - The project image can appear in the site header, through a Layout Box, with an optional
second image for dark mode. - The start screen lays its project tiles out by the width of the column, not the window, and
says each thing once. - “Backups” is now “Snapshots”, the word everything on that page already used.
- The handbook has a page on network connections — every address the app talks to, when, and
why (Reference → Network connections). - The example template links its footer to the published handbooks, and its sidebar links work
when the site lives under a sub-path.
Which file
| System | File |
|---|---|
| macOS, Apple Silicon | QuartzControl-1.0.0-beta.2-arm64.dmg — or .zip |
| macOS, Intel | QuartzControl-1.0.0-beta.2-x64.dmg — or .zip |
| Linux, x86_64 | QuartzControl-1.0.0-beta.2-x86_64.AppImage or quartzcontrol_1.0.0-beta.2_amd64.deb |
| Linux, arm64 | QuartzControl-1.0.0-beta.2-arm64.AppImage or quartzcontrol_1.0.0-beta.2_arm64.deb |
| Flatpak | QuartzControl-1.0.0-beta.2-x86_64.flatpak or …-aarch64.flatpak |
Every file names its architecture, including the Intel and amd64 ones.
Before the first start
macOS. The app is ad-hoc signed and not notarised; there is no Developer ID certificate, so
macOS refuses the first launch. Allow it under System Settings → Privacy & Security → Security →
“Open Anyway”, within about an hour of the refused launch. The context menu (right-click → Open)
no longer does this since macOS 15. Or clear the quarantine flag:
xattr -dr com.apple.quarantine /Applications/QuartzControl.app
Still on 1.0.0-beta.1 and macOS says it “is damaged”? Only the command above helps for that
version — or install this one.
Linux. Make the AppImage executable and run it, or install the deb with
sudo apt install ./quartzcontrol_1.0.0-beta.2_amd64.deb. For the Flatpak:
flatpak install --user QuartzControl-1.0.0-beta.2-x86_64.flatpak
--filesystem=home is set, so projects under your home directory work as they are. A content
folder on another drive needs a one-off flatpak override --filesystem=<path>.
What is inside every package
- Node and npm — Electron's own runtime (Node 24.18.1, npm 11.17.0), exposed as three shims on
the PATH. Nothing to install. - git 2.53.0 — used only when the machine has none that answers; otherwise the system's own wins.
- The user handbook — 461 files in two languages, readable offline, linked from every screen.
- An example template — for creating a project when there is no network.
Known limits
- Not notarised on macOS, as above.
- No self-update. The start screen reports when a newer version exists and links to it; the
download and the replacement are yours to do. - No Windows. Deliberate, and the reasons are in the README.
- A YAML error in the frontmatter of a single note stops the dev server. That is Quartz; the app
shows the server as crashed. - On a machine without a working GL context — a VM, typically — the window appears a moment
later than usual through a fallback path, and the console says so.
Checksums (SHA-256)
934d530c164f6fd5fe5ec9f24f96a2e27e5e1e17a8fd4d8c61c882c1812fec1a QuartzControl-1.0.0-beta.2-arm64.dmg
9ab9e67f6de1e891cebfa57cb3c31bb8571a432f2589c32de34cb238486ae3e5 QuartzControl-1.0.0-beta.2-arm64.zip
8b30041ca69db77cfe1047a0ce4852cd98acd177dc718f3a5ce44842948b5d73 QuartzControl-1.0.0-beta.2-x64.dmg
4398643971c467ecd6116cf0d2bdb50e7319a94ef2925e530bd32c1eaec41352 QuartzControl-1.0.0-beta.2-x64.zip
6e6073eff421cd4066fdb1e8ab4a3c66023018016c2d39741eda085a485a8958 QuartzControl-1.0.0-beta.2-arm64.AppImage
bbf483bdbfcd7cee561e5e6748a9ced559f500d74ed478279efd79f82d49f75e QuartzControl-1.0.0-beta.2-x86_64.AppImage
489bb406195c3824582ecd02a20fd130d8dcedcad959aeeec98c5791331cf18b quartzcontrol_1.0.0-beta.2_arm64.deb
0151800357fd6c4a330c65401df4ed2036dc0b3a118690fad3b59fc26f98ae07 quartzcontrol_1.0.0-beta.2_amd64.deb
7664d3da7c0c64d2fb96a2a9e51ed69734d9eb85346f6a9985ca8c9b45194462 QuartzControl-1.0.0-beta.2-aarch64.flatpak
6984b757019d5c1f2de4a69504fa7100d8e1a5fe96e4cb47010f0ad02c132451 QuartzControl-1.0.0-beta.2-x86_64.flatpak