SoulMatrix: a local-first Destiny Matrix dashboard for live presenting

The presenting problem SoulMatrix is built around

SoulMatrix is a local-first, zero-dependency web application for numerologists, spiritual consultants and live stream presenters, and the design goal is visible in the file layout: two HTML pages, a spreadsheet, and a compiler script. The presenter enters a client date of birth, the tool computes a Destiny Matrix octagram, plots it on an interactive SVG chart and fills each node with an interpretation pulled from a master database. What makes it a streaming tool rather than a calculation toy is the second window. The Script Board opens as a pop-out, mirrors the active selection in real time without a network round trip, and lets the presenter read detailed interpretations on a private screen while the audience sees only the chart. The README names OBS, TikTok Live and dual-monitor setups as the intended contexts.

How a birth date becomes an octagram of clickable nodes

The calculation produces an octagram chart whose positions are individually clickable, and the README describes a set of special views layered on top of it. Couples compatibility mode adds corresponding coordinates of two charts and reduces the result modulo 22 into the Major Arcana, then renders the outcome in four dedicated tabs called General, Love Dynamics, Relationship Karma and Shared Finance. An outer ring carries decadic life milestone labels from 0/80 down to 70, and 56 intermediate age timeline nodes are mapped along the perimeter lines of the octagram SVG, each one clickable and wired into the same database lookup. The practical consequence is that the presenter navigates by position rather than by menu: a click on a node is what selects the matching script text on the other screen.

The Excel compiler that produces the interpretation data

Interpretations do not live in the code. The master copy is a spreadsheet at data/interpretations.xlsx, and a second compiled file, data/interpretations_deep.csv, holds deep dive readings. The update path is a two step Windows toolchain: the spreadsheet is edited, then run_update.bat executes the compiler, which is available as update_interpretations.py or a PowerShell variant. The compiler backs up the previous CSV, parses the workbook sheets, prints a compilation count when it finishes, and writes data/interpretations.csv, the file the page actually loads. The dashboard reads that CSV through fetch or a FileReader, which is why the two files live side by side in the repository and why the tool needs a local web server rather than a double click on an HTML file.

Offline sync between the dashboard and the Script Board

The two windows talk over a BroadcastChannel, and the architecture diagram marks that link as an offline broadcast between soul_matrix.html and script_board.html. When the Script Board opens it asks the dashboard for the active session, the dashboard answers with the calculated nodes and the database configuration, and from then on a click on a node broadcasts the selected position to the board, which scrolls to that position and highlights the matching text. The channel is bidirectional in the sense that the board can request the session state, but it never leaves the browser, and it is not a network protocol. A font zoom controller on the board offers Small, Medium, Large and Extra Large sizes for the script text, and those preferences are stored locally in the browser.

Running SoulMatrix on a Windows machine

The runtime is plain HTML, CSS and JavaScript served from disk, and the repository ships two batch launchers. First bring the interpretation data up to date after editing the spreadsheet:

run_update.bat

That wrapper calls the compiler and reports how many entries it compiled. Then start the local session, which is what the workflow diagram describes as starting an HTTP server:

run_locally.bat

The dashboard then reads data/interpretations.csv into memory, you enter the client date of birth and press Calculate, and the Script Board button opens the second window. There is also a hosted copy at the project's GitHub Pages address, which is the quick way to look at the chart and the interface, plus an index.html at the repository root and a build_release.bat for packaging.

Where the local-first design gets in the way

Several limits follow directly from the architecture rather than from the numerology. BroadcastChannel synchronises windows inside one browser on one machine, so the presenter and the audience screen must be two displays attached to the same PC, and a remote second machine is out of reach. The launchers are Windows batch files, and the README badge lists Windows as the supported operating system, so a macOS or Linux operator has no documented route in. The compatibility tables, the 56 age timeline nodes and the interpretation text are all hand maintained in a spreadsheet, which makes the Excel file a real piece of operational state rather than a convenience. There is also no published build, so a fresh install is a clone plus a local server rather than an app download.

SoulMatrix next to a generic chart or script

The nearest alternative is not another numerology tool, it is doing the same job with general purpose tooling: a spreadsheet with formulas for the arithmetic plus a charting overlay on the streaming software, or a Python script that computes the octagram and writes a static SVG the presenter drops into OBS. The difference in approach is that a script produces a picture while SoulMatrix produces a live, clickable object with a second reading surface attached to it, and its database layer lets a practitioner change the wording of a reading between sessions without touching code. A custom script is easier to version and easier to schedule; SoulMatrix is easier to change during a live call, which is the only context in which it earns its complexity.

Licence, releases and who can reuse it

The licensing picture is the weakest part of the repository: the top level entries contain no licence file and the licence field is unresolved, so the terms for reuse, modification or redistribution are not stated anywhere in the project and need to be settled with the author directly. The last push was on 2026-08-20, the repository is not archived, and no GitHub releases exist, so CHANGELOG.md, TODO.md and HOW-TO-UPDATE.md are the only records of what changed and what is still planned. Practically, that means an adopter inherits a tool whose data format and launch scripts are documented but whose legal status and version history are not.

Editorial conclusion

SoulMatrix suits a numerologist or presenter who works from a fixed interpretation database, runs a local Windows machine and presents on two screens. It does not suit a web only audience, a macOS or Linux operator, or anyone who needs two different machines to share a session, because the sync channel is local to one browser and the launchers are Windows batch files. Before adopting it, confirm the licence with the author, since the repository ships no licence file, and check that the interpretation CSV files in data/ are present, because the dashboard reads them at startup.

Frequently asked questions

Official sources

1. AhmadHassan-BTed/SoulMatrix on GitHub
2. Issues
3. Project website
4. README