WINTER GARDEN LEDGER - YOUR OWN OFFLINE COPY

Extract the entire ZIP before opening it. It is a clean copy: no statements,
saved preferences, merchant rules, financial information, or backups are included.
All artwork, the PDF reader, and the Windows runtime are bundled. Once downloaded,
you can disconnect from the internet and keep using the ledger.

WINDOWS 10/11 (64-BIT)
Double-click Open Winter Garden Ledger.cmd. Nothing needs to be installed.
It opens your default browser using a private 127.0.0.1 address on this computer.
The local service shuts down shortly after its browser tabs are closed.

MAC OR LINUX
Install Python 3.11 or later first if it is not already available. In a terminal,
open this extracted folder and run:
    python3 -B app/local_launcher.py
The included Windows Python runtime is not used on Mac or Linux. A modern browser
is required on all platforms. Opening an HTML file directly is not the launcher.

YOUR INFORMATION
Open Session > Add statement PDFs reads your own files. Your statements, budgets,
merchant corrections, and preferences are saved in the data folder created beside
app. They are ordinary unencrypted local files. Keep this folder outside cloud
sync if you do not want another service to sync it. The app itself never sends
your financial information to a remote service. The local service is bound only
to your computer; do not expose it as a public internet server.

Clear Session hides your current view until you explicitly reopen it. It does
not delete saved files. Remove statements individually in Open Session. Back up
the data folder yourself and copy the whole folder to move your saved ledger.
Download ZIP always makes a clean application copy; it is NOT a session backup.

SOURCE AND OPTIONAL LINKS
The editable frontend is in app/src. The local server and storage code are the
Python files in app. app/build.py rebuilds the local page using those sources.
Original image pixels and the PDF reader are in app/assets.zip. The Python and
PDF.js licenses are included. You can inspect the code before loading statements.
BuyMeACoffee.com and reference links require internet only if you click them.

MUSIC
The included music is optional. Add or remove .mid/.midi files in audio; reload
to rescan. BGSFX.mp3 (or BGSFX.wav) supplies ambience; STORM.mp3 supplies the Mire
storm. Missing audio simply stays silent. The pan-flute button starts muted.
Audio choices and volume settings save locally.

UPDATES
Keep your existing data folder when replacing application files with a new copy.
Do not copy someone else's data folder. Each folder has its own saved ledger.


NAMED SAVED SESSIONS
Open Session now lets you create, name, rename and switch between saved ledgers.
Your existing session is kept as My Ledger. Each named ledger has separate PDFs,
budgets, merchant rules, accepted readings, audio/motion/player choices and scores.
Clear Session asks first, then hides the current view without deleting its files.
It stays closed after refresh/relaunch until opened explicitly in Open Session.
On desktop, launch Open Winter Garden Ledger.cmd as usual. Original files stay
directly inside data; named sessions live under data/sessions/<random ID>.
Copy the entire app folder with data to move all ledgers to another computer.
On the web, each named ledger stays in this browser, origin and deployment path.
A full .wgl backup contains the current named ledger only. Create a new named
session before restoring a different backup if you want to keep both ledgers.
Session names are local, not login accounts, passwords or access restrictions.
