Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sortilune

Sortilune — Oracle

A private Windows desktop studio for reflection, decisions, and creative play with traceable randomness. Sortilune combines daily constellations, card draws, decision receipts, writing prompts, generative artwork, live planetary sound, small practices, multi-step projects, and a searchable local archive in one portable app.

License: MIT Platform Distribution Built with Tauri Telemetry

The name Sortilune (sortilege + lune) means “moon-cast lots”: the lots are drawn from public scientific signals when available, with their source recorded beside the result.

What is in the app

Area Feature What it does
Home Today Builds one replayable daily constellation from a verified NIST pulse, with Oracle, Constraint, Diary, Symphony, and practice cues.
Consult Oracle Draws from Tarot, I-Ching, Runes, or the original Cosmic deck and creates a deterministic illustration.
Consult Constraint Draws a small creative or observational discipline to accept, pass, or save.
Decide Decider Chooses between weighted options and creates a portable result receipt.
Decide Lottery Provides coin, dice, wheel, name, number, and shuffle tools with optional receipts.
Create Diary Saves locally editable Markdown entries anchored to reflective prompts.
Create Canvas Produces six kinds of entropy-seeded SVG artwork, PNG exports, and an optional wallpaper action.
Observe Symphony Turns earthquakes, weather, and beacon pulses into a live score that can be replayed and exported as WAV or MIDI.
Verify Beacon Creates and rechecks a reproducible checksum bound to a public NIST pulse. It is not a trusted timestamp.
Workspace Projects Guides three built-in multi-step creative workflows and keeps every saved result connected.
Workspace Practices Offers gentle recurring activities with pause, rest-day, skip, and private reflection support.
Memory Archive Searches, filters, annotates, groups, and inspects local records without rewriting their source files.
Memory Journal Export Turns selected Archive, Today, and Project material into self-contained HTML or Windows Print-to-PDF output.
Settings Content packs Imports, enables, disables, updates, exports, and removes validated local content packs.

The adaptive navigation rail, command palette (Ctrl+K), three themes, compact layouts, keyboard focus states, and reduced-motion support are shared across the app.

Quick start

  1. Download Sortilune-0.2.0-windows-x64.exe from the Releases page, or build it from source.
  2. Double-click the executable. No installer, account, admin rights, Python, Docker, or GPU is required.
  3. Start on Today, or use the navigation rail to open another feature.

Requirements: Windows 10 version 1803 or newer, or Windows 11, with Microsoft WebView2 Runtime. The portable executable expects WebView2 to be installed; supported Windows versions normally include it.

Local data and privacy

There are no accounts, analytics, telemetry, crash uploads, background services, autostart hooks, or automatic update checks. Sortilune runs only while its window is open.

User data stays under %APPDATA%\com.sortilune.desktop\:

  • archive\ contains readable JSON, Markdown, and artwork files;
  • Projects, Practices, pack state, annotations, and derived Archive cache data use versioned local files;
  • deleting or replacing the portable executable does not delete this app-data directory.

The app contacts only five allowlisted public-service hosts: NIST Beacon, USGS Earthquake, Open-Meteo, random.org, and ANU Quantum. Requests do not contain prompts, decisions, diary text, project notes, or Archive content. Most tools fall back to clearly labeled on-device cryptographic randomness when offline; features that explicitly require live NIST or live planetary data fail visibly instead.

See Privacy and network behavior and Data and export formats for the exact release contract.

Sources and provenance

Source Use
NIST Randomness Beacon 2.0 Verified public pulses for Today, Beacon, strict Decider, and the preferred entropy chain
USGS Earthquake feed Seismic entropy and Symphony events
Open-Meteo Weather entropy and Symphony wind state
random.org Atmospheric-noise entropy
ANU Quantum Quantum-number entropy when its public endpoint is available
crypto.getRandomValues() Clearly labeled local fallback

Source metadata is part of saved results. A matching Beacon checksum proves internal consistency with the referenced public pulse; it does not prove authorship or creation time.

Build and test

The supported release target is the portable Windows executable:

npm ci
npm run tauri:build:portable

The artifact is src-tauri\target\release\sortilune.exe. Full prerequisites, quality commands, and smoke-test instructions are in BUILD.md.

Sortilune uses TypeScript and JavaScript modules in a Vite WebView2 frontend, with a small Rust/Tauri boundary for scoped HTTP, local persistence, native dialogs, filesystem observation, and wallpaper application. Runtime modules are lazy-loaded by route; imported content is data-only and cannot execute code.

Documentation

Known limits

  • This release is built and certified as a personal, single-user Windows portable app. macOS and Linux are not release-certified targets.
  • It has no cloud sync, account system, collaboration service, in-app encryption, or auto-updater.
  • Journal PDF output uses the installed Windows print dialog; HTML is the durable self-contained export.
  • Imported packs customize content, not executable code or entropy sources.

Credits and license

Sortilune depends on public services and datasets from NIST, USGS, Open-Meteo, random.org, ANU, and Natural Earth. Full attributions and third-party notices are in CREDITS.md.

MIT — copyright (c) 2026 aivrar.

About

Creative ritual studio with traceable draws seeded by NIST pulses, quantum and atmospheric noise, earthquakes, and live weather—Tarot, I Ching, decisions, prompts, generative art, and soundscapes.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages