A macOS desktop app (Tauri 2 + Svelte 5) for filtering and rendering QQL art seeds locally. You give it an ETH address, choose trait/characteristic filters, and it generates and renders matching seeds on your machine.
Built on top of @wchargin's qqlrs Rust renderer (vendored here as qqlrs-main/, with local modifications — see Licensing).
| Path | What it is |
|---|---|
qqlrs-main/ |
The QQL renderer (Rust lib + CLI). Third-party (@wchargin), MIT/Apache-2.0, with local modifications that surface extra layout/structure info for filtering. Don't break its golden tests. |
qql-studio/ |
The Tauri desktop app. This is the original code. Rust backend in src-tauri/, Svelte 5 frontend in src/. |
qql-studio depends on qqlrs-main via a relative path (qql = { path = "../../qqlrs-main" }), so both folders must live together.
- Rust (stable, via rustup)
- Node.js 18+ and npm
- macOS (the only target wired up today). For Universal builds:
rustup target add x86_64-apple-darwin aarch64-apple-darwin.
cd qql-studio
npm install
npm run tauri devcd qql-studio
npm run tauri build -- --target universal-apple-darwinProduces a .app and .dmg under src-tauri/target/universal-apple-darwin/release/bundle/. The build is unsigned, so first launch needs a right-click → Open (or xattr -dr com.apple.quarantine "/Applications/QQL Studio.app").
cd qqlrs-main && cargo test --release # renderer (incl. 3 golden tests — must pass)
cd qql-studio/src-tauri && cargo test --lib
cd qql-studio && npm run check # frontend type-checkQQL encodes 13 categorical traits in the last bytes of a 32-byte seed (ETH address + nonce + trait bits). qqlrs-main was extended to return rich LayoutSummary / RenderData (point counts, colors, radius buckets, quadrant distribution, and per-structure info for Formation / Orbital / Shadows pieces). The app's Rust backend filters candidate seeds in parallel against these characteristics and renders matches to PNG; the Svelte frontend drives the controls and a concurrency-limited render queue.
qqlrs-main/retains its upstream dual license — seeqqlrs-main/LICENSE-MITandqqlrs-main/LICENSE-APACHE. Modifications are noted in code.qql-studio/— license TBD by the team.