GlassBalance v0.3.0

First stable release of v0.3. Back up your ledger before upgrading (Save backup). Installers and updates only replace program files; your ledger and backups are never touched.

Highlights

• Native installers: Windows Setup (per-user, no administrator rights needed) and Ubuntu/Debian .deb, alongside portable ZIPs. An experimental macOS .dmg (Apple Silicon) is included.
• In-app updates: GlassBalance checks for new stable releases, shows the release notes, downloads with a progress bar, verifies the SHA-256 checksum, backs up your ledger and installs, then restarts. Clear messages when offline.
• Categories: set them in the New/Edit transaction dialog (the last category used for the same description is suggested). Categories & charts shows spending per category; double-click a category or bar to list its transactions and re-categorize them.
• Money in · out · net card with date ranges (this month, last month, last 3 months, this/last year, all time, custom). Categories & charts follows the same range.
• Recurring templates for rent, salary and subscriptions: posted only after you confirm, at most once per month.
• Undo deletion of the most recent transaction in the current session, including its comment and category.
• Import of an exported file now updates categories of existing transactions without touching amounts. Exports default to a dated name such as glassbalance-export_8nov2026.xlsx.
• From the v0.3 previews: Dark/Light/System appearance with custom accent colors, description autocomplete, transaction comments, right-click actions, Unbalanced improvements.

Fixes

• Update checks never detected a new version in earlier builds. Download v0.3.0 once from the Releases page; later updates install from inside the app.
• Deleting a transaction tracked in Unbalanced silently erased its loan history; such transactions now must be unlinked first.
• Restoring an older backup recreates missing feature tables; Light mode amounts are readable; Linux scripts are executable after cloning; editing on Ubuntu with large ledgers no longer freezes.

Known limitations

• macOS build is experimental, Apple Silicon only, and not notarized: on first launch use System Settings → Privacy & Security → Open Anyway.
• Windows builds are unsigned; SmartScreen may ask you to choose More info → Run anyway.
• Undo covers the most recent deletion in the current session only. Comments are not included in CSV/XLSX exports.

Changes since v0.3.0-beta.1

• Category field in the New and Edit transaction dialogs. New transactions suggest the category last used for the same description; your own choice is never overridden. The separate right-click item and Set category button were removed.
• Double-click a category (table row or chart bar) on Categories & charts to list its transactions for the selected date range, with in/out/net totals; move any of them to another category from that list.
• Fixed: run-linux.sh, app.py and the Linux install/uninstall scripts were not executable after cloning.
• Exports default to a dated name, e.g. glassbalance-export_8nov2026.xlsx.
• About shows the maintainer photo bundled in the app; the local picture picker and the build-time avatar download were removed (installers are ~1.8 MB smaller).
• Importing a file whose transactions already exist now updates their categories (matched by Stable import ID) after showing the count. Amounts, dates and balances are never changed; blank categories never erase existing ones.

macOS (experimental)

Apple Silicon only. Not notarized: on first launch, open System Settings → Privacy & Security and choose Open Anyway.

GlassBalance v0.3.0-beta.1

Pre-release for testing. Back up your ledger before installing.

• Money in · out · net card on the Overview with a date range: This month, Last month, Last 3 months, This year, Last year, All time or a custom range (remembered between sessions). The Categories & charts tab follows the same range.
• About moved to the top-right of the window, next to New transaction; the update notice appears there too.
• Fixed: green/red amounts in tables were hard to read in Light mode; table colors now follow the appearance.
• In-app updates: checks the latest stable release; shows release notes with Download and install / Later / Skip this version.
  Downloads with a progress bar and Cancel, verifies size and SHA-256 against the release's SHA256SUMS.txt, backs up the ledger, then installs and restarts:
  Windows installer runs silently (no admin prompt, per-user install); Ubuntu .deb asks for your password via the system dialog; macOS opens the disk image for drag-and-drop.
  Portable and source copies are pointed to the release page instead.
• Clear messages for offline, timeout, HTTPS/proxy failures, GitHub rate limits and server errors, with Try again. Startup checks stay silent when offline.
• Fixed: the update check always reported "unavailable" with current PySide6 (NoError is truthy), so updates were never detected.
• Release automation: draft GitHub releases with checksums from tags (pre-releases) and from main (stable); version defined once in glassbalance/__init__.py.
• Testers can opt into pre-release updates with the environment variable GLASSBALANCE_UPDATE_CHANNEL=prerelease.

macOS (experimental)

Apple Silicon only. Not notarized: on first launch, open System Settings → Privacy & Security and choose Open Anyway.

GlassBalance v0.3.0-alpha.1 — Personalization & Smart Ledger

GlassBalance v0.3.0-alpha.1

🎨 Personalization & Smart Ledger

GlassBalance is a free, open-source, offline-first
personal finance application for Windows and Linux.

This release introduces appearance customization,
smarter transaction management, and an integrated
software update checker.

✨ What's New

🎨 Appearance Customization

• Dark, Light, and System themes.
• Custom accent colors.
• Preset color palette.
• Expanded color picker with RGB and HEX controls.
• Persistent appearance preferences.

🔎 Smarter Transactions

• Transaction description autocomplete.
• Search autocomplete.
• Improved context-aware searching.
• Right-click transaction menu.
• Transaction comments.
• Find matching transactions.

🤝 Unbalanced Improvements

• Select and manage outstanding loans.
• Remove loans from Unbalanced without deleting
  their original transactions.
• Search borrowing and lending records.
• Link repayments with explicit confirmation.
• Support partial repayments.

🔔 Update Checker

• Check for updates from the About window.
• Display installed and latest stable versions.
• Optional background update checks.
• Update notification indicator.
• Direct access to official GitHub releases.
• No automatic downloading or installation.

🐛 Bug Fixes

• Fixed application freezing after editing
  transactions on Ubuntu.
• Improved large-ledger table performance.
• Fixed accent-color swatches.
• Improved search behavior across tabs.
• Improved Unbalanced record management.

✅ Testing

• 17 automated tests passed.
• Development features manually tested on Ubuntu.
• Existing financial data and balances preserved.

📦 Downloads

Linux: GlassBalance-v0.3.0-alpha.2-Linux-x86_64.zip

Windows: GlassBalance-v0.3.0-alpha.2-Windows-x64.zip

Windows executables are currently unsigned and
may display a Microsoft Defender SmartScreen warning.

⚠️ Pre-release Notice

This is an alpha release. Please back up your
financial database before upgrading.

🔮 Coming Next

• Transaction categories.
• Undo deleted transactions.
• Improved financial analytics.
• Automatic local backups.

PDF bank statements and receipt processing are
planned for v0.4.0.

👨‍💻 Creator & Maintainer

@Onimee58

📜 License

MIT License

GlassBalance v0.2.0 — First Stable Release

GlassBalance is a free, open-source, offline-first personal finance application for Windows and Linux.

Originally inspired by a personal Excel-based ledger, GlassBalance has grown into a native desktop application for recording transactions, tracking balances, and managing borrowing and lending.

After multiple alpha releases and cross-platform beta testing, v0.2.0 is the first stable release in the 0.2 series.

✨ Features

💰 Personal finance tracking

• Record, edit, and delete income and expenses.
• Automatically calculate running balances.
• Select transaction dates and browse financial history.
• View monthly summaries and a balance-history chart.

🔎 Balance Search

• Search transactions by person, business, or keyword (for example, walmart).
• See total money in, total money out, and the net of matching transactions.
• Review all matching entries together.

🤝 Unbalanced — borrowing and lending

• Track loans and money borrowed from others.
• Track outstanding amounts and partial repayments.
• Detect possible repayments from transaction descriptions.
• Require confirmation before linking or settling a repayment.
• Unlink incorrect repayment matches.

Loan links do not change the balance in the main transaction ledger.

📊 Import and export

• Import original or curated Excel histories and CSV files.
• Export transaction data.
• Detect duplicate entries during supported imports.

🔐 Offline-first and backups

• Keep financial records in a local SQLite database.
• Create and restore local backups.
• Create and restore password-protected encrypted backups.
• Use the application without creating an online account.

🎨 Native desktop experience

• Dark, glass-inspired interface with the G + Wallet icon.
• Windows and Linux builds.
• Ubuntu application-menu integration and dock icon.
• About dialog with creator credit and profile photo support.

📦 Downloads and installation

🐧 Linux (x86_64)

Asset: GlassBalance-v0.2.0-Linux-x86_64.zip

1. Download the Linux ZIP and extract it.

2. Open a terminal in the extracted application folder.

3. Run:

   bash install-linux.sh

4. Find GlassBalance in your desktop application menu.

The launcher installation is user-local and does not require administrator privileges. Ubuntu 26.04 LTS was used for desktop testing; other distributions may require additional compatibility testing.

🪟 Windows (x64)

Asset: GlassBalance-v0.2.0-Windows-x64.zip

1. Download and extract the Windows ZIP.
2. Launch GlassBalance.exe from the extracted folder.

Unsigned application notice: The Windows executable is not currently code-signed. Microsoft Defender SmartScreen may display an Unknown publisher warning. This warning alone is not a malware finding, but it is not proof of safety either. Download only from the official project release page and verify files where checksums are provided. Do not disable Windows security protections.

✅ Testing performed

The maintainer has reported successful tests for:

• Application launch on Windows and Ubuntu.
• Ubuntu launcher and dock integration.
• Transaction add, edit, delete, and running balances.
• Balance Search results and Unbalanced repayment confirmations.
• Compatibility with an existing database and clean first launch.
• Local backup restores Linux → Windows and Windows → Linux.
• Encrypted backup restores in both directions.
• Rejection of incorrect backup passwords without damaging existing data.
• Restored transaction counts and balances.

The project also passed 11 automated core tests during beta development. These checks do not guarantee the absence of bugs on all systems.

🔄 Upgrading

The application is designed to preserve existing GlassBalance transaction databases from earlier versions. Create a local backup before upgrading, and verify your balance and transaction count after the first launch.

🔮 Planned for v0.3.0

• Import monthly PDF bank statements, with review and duplicate detection.
• Light, dark, and system theme options.
• Transaction autocomplete, optional categories, and deletion undo.
• Improved charts, salary-cycle tracking, and recurring entries.
• Automatic local backups.
• Multiple accounts and encrypted cross-computer synchronization.

These are planned features, not part of v0.2.0.

👨‍💻 Creator and maintainer

Created and maintained by @Onimee58. Project initiated in October 2026.

Contributions, feedback, and bug reports are welcome at the GlassBalance repository.

📜 License

MIT License.

---

Thank you for trying GlassBalance! 💠

GlassBalance v0.2.0-alpha.3 — New Identity & Cross-Platform UI Fixes

GlassBalance v0.2.0-alpha.3

🎨 New Identity, Cross-Platform UI Fixes & Stability Improvements

GlassBalance is an open-source, offline-first personal finance
application for Windows and Linux.

This release focuses on establishing the visual identity of
GlassBalance, resolving Windows-specific interface issues,
and improving the consistency of the desktop experience.

---

✨ What's New

💠 1. Official GlassBalance Application Icon

GlassBalance now has its first official application icon!

The new G + Wallet design combines:

• A stylized letter G representing GlassBalance.
• A wallet symbol representing personal finance.
• Teal and cyan gradients matching the application interface.
• A modern glass-inspired design.

The icon is integrated into:

• Windows executable and taskbar.
• Linux desktop application.
• Application window and title bar.
• About GlassBalance dialog.

Multiple icon formats are included for cross-platform compatibility.

🪟 2. Fixed Windows Sidebar Appearance

Resolved a major visual issue affecting Windows installations.

Previously, the navigation sidebar could appear with a white
background, making text difficult to read.

Improvements:

• Consistent dark sidebar appearance on Windows.
• Explicit styling for Qt scroll areas and viewports.
• Improved navigation text visibility.
• Better consistency between Windows and Linux.

The fix has been successfully tested on Windows.

🎨 3. Interface & Branding Improvements

• Updated application branding throughout the interface.
• Improved consistency of dark interface elements.
• Updated About window with the official application icon.
• Preserved GitHub maintainer avatar support.
• Improved visual consistency across supported platforms.

🛠️ 4. Stability & Compatibility

• Preserved compatibility with existing GlassBalance databases.
• Maintained Balance Search functionality.
• Maintained Unbalanced borrowing and lending management.
• Preserved Excel/CSV import and export.
• Preserved encrypted backups and offline-first operation.
• Improved application asset packaging.

---

✅ Platform Testing

🐧 Linux

• Standalone application builds successfully.
• Native desktop interface available.
• Existing financial functionality preserved.

🪟 Windows

• Standalone executable launches successfully.
• Windows sidebar rendering issue resolved.
• Official application icon displays correctly.
• Transaction management interface renders correctly.

Both Windows and Linux builds have completed successfully
through GitHub Actions.

---

📦 Downloads

Linux (x86_64)

GlassBalance-v0.2.0-alpha.3-Linux-x86_64.zip

Download, extract, and launch the GlassBalance executable.

Windows (x64)

GlassBalance-v0.2.0-alpha.3-Windows-x64.zip

Download, extract, and run GlassBalance.exe.

Windows notice: The application is currently unsigned.
Microsoft Defender SmartScreen may display an
"Unknown publisher" warning.

Only download releases from the official GlassBalance
GitHub repository and verify their source.

---

⚠️ Alpha Release Notice

GlassBalance is still under active development.

This release has undergone automated core testing and
basic desktop testing on Windows and Linux.

Some features may still contain bugs.

Please back up your financial database before upgrading.

---

🔮 Coming Next

Planned improvements include:

• Faster transaction entry.
• Description autocomplete.
• Optional transaction categories.
• Light and dark theme support.
• Improved Unbalanced management.
• Enhanced dashboard analytics.
• Automatic local backups.
• Improved Windows distribution security.

---

👨‍💻 Creator & Maintainer

@Onimee58

GlassBalance was initiated in October 2026.

Contributions, suggestions, and bug reports are welcome.

📜 License

MIT License

---

Thank you for supporting GlassBalance! 💠

GlassBalance v0.2.0-alpha.2

GlassBalance v0.2.0-alpha.2

🔎 Balance Search, Loan Tracking & UI Improvements

GlassBalance is an open-source, offline-first personal
finance application for Windows and Linux.

This release introduces dedicated balance searching,
borrowing and lending management, and improvements
to the application's interface and branding.

---

✨ What's New

🔎 1. Balance Search

A dedicated Balance Search tab for analyzing transactions
associated with a person, business, or keyword.

Features:

• Search transactions by name or keyword.
• Case-insensitive matching.
• Total money received from matching transactions.
• Total money spent on matching transactions.
• Net balance calculation.
• View matching transactions in one place.

For example, searching "ammu" displays all matching
transactions and their combined financial totals.

🤝 2. Unbalanced — Borrowing & Lending

Introducing a dedicated Unbalanced section to track
money borrowed and lent.

Features:

• Register existing transactions as loans or borrowings.
• Track outstanding amounts by person.
• Support partial repayments.
• Detect possible repayments using keywords such as
  "refund", "repay", and "return".
• Link repayments to outstanding loans.
• Unlink repayments when corrections are needed.

Important: GlassBalance never automatically settles
a loan. Every repayment requires user confirmation.

Linking a repayment does not change the main ledger balance.

👤 3. Improved About Window

• Added GitHub profile picture support.
• Bundled lightweight maintainer avatar for offline use.
• Added the option to select a custom picture locally.
• Creator and founding maintainer attribution.
• Updated application version information.
• Direct link to the GlassBalance GitHub repository.

🎨 4. Interface Improvements

• Improved sidebar behavior on smaller windows.
• Fixed clipped information near the bottom of the sidebar.
• Improved navigation between financial sections.
• Retained the modern glass-inspired dark interface.

🛠️ 5. Build & Packaging Improvements

• Improved handling of application assets.
• Added reliable creation of the assets directory.
• Updated avatar preparation during automated builds.
• Successful GitHub Actions builds for Linux and Windows.

---

📦 Downloads

🐧 Linux (x86_64)

Download:
GlassBalance-v0.2.0-alpha.2-Linux-x86_64.zip

Extract the archive and launch the GlassBalance executable.

🪟 Windows (x64)

Download:
GlassBalance-v0.2.0-alpha.2-Windows-x64.zip

Extract the archive and launch GlassBalance.exe.

Windows compatibility testing is ongoing.

---

🔄 Upgrading

GlassBalance v0.2.0-alpha.2 maintains compatibility
with the existing local database format.

Your existing transactions should remain available
when upgrading from earlier versions.

Please create a local backup before upgrading.

---

⚠️ Alpha Release Notice

This is experimental software.

Although core automated tests and Linux testing have
been performed, some features may contain bugs.

The borrowing and lending tracker is still under
active development.

Review all suggested loan repayments carefully before
confirming them.

---

🔮 Planned Improvements

• Custom application icon
• More polished light/dark themes
• Improved transaction entry
• Transaction categories
• Advanced financial charts
• More flexible borrowing and lending management
• Improved application packaging
• Secure synchronization between computers

---

👨‍💻 Creator & Maintainer

@Onimee58

GlassBalance was initiated in October 2026.

Contributions, bug reports, and feature suggestions
are welcome!

📜 License

MIT License

---

Thank you for trying GlassBalance!

GlassBalance v0.2.0-alpha — UI Redesign

GlassBalance v0.2.0-alpha

🎉 First Alpha Release of GlassBalance v0.2

GlassBalance is an open-source, offline-first personal
finance application for Windows and Linux.

This release introduces a completely redesigned desktop
interface while preserving compatibility with v0.1.0.

✨ What's New

• Completely redesigned glass-inspired interface
• New dashboard and navigation sidebar
• Interactive balance-history visualization
• Improved income and expense overview
• Redesigned transaction table
• Improved monthly financial history
• New About GlassBalance window
• Creator and founding maintainer attribution
• Updated application branding

💰 Existing Features

• Add, edit, and delete transactions
• Automatic running balances
• Excel and CSV import/export
• Historical transaction support
• Local SQLite database
• Offline-first operation
• Local and encrypted email backups

🐧 Linux

Standalone Linux executable successfully tested on Ubuntu.

Download the Linux ZIP, extract it, and run GlassBalance.

🪟 Windows

Windows executable is provided for testing.

The Windows graphical application has not yet been
independently verified.

⚠️ Alpha Release Notice

This is an early development release.

Before upgrading, please create a backup of your
GlassBalance database.

Existing databases from v0.1.0 are supported, but users
should retain a backup before testing.

👨‍💻 Project Creator

Created and maintained by
@Onimee58.

📜 License

MIT License

🔮 Coming Next

• Custom application icon
• Light and dark themes
• Improved transaction entry
• Transaction categories
• Advanced financial analytics
• Further UI refinements

GlassBalance v0.1.0 — Initial Release

GlassBalance v0.1.0

The first public release of GlassBalance!

GlassBalance is a lightweight, open-source
personal finance tracker for Windows and Linux.

Features

• Native desktop application
• Modern dark glass-inspired interface
• Offline-first SQLite database
• Transaction tracking
• Automatic running balances
• Monthly income and expense history
• Excel and CSV imports
• Historical transaction support
• Local and encrypted email backups

Platforms

• Linux
• Windows

Downloads

Linux

Download the Linux ZIP, extract it, and launch GlassBalance.

Tested successfully on Ubuntu.

Windows

Download the Windows ZIP, extract it, and launch GlassBalance.exe.

Windows build is currently untested.

Testing

Linux standalone build verified:

• Application launches successfully
• Existing database loads
• Transactions can be added and deleted
• Data persists across application restarts

Known limitations

• Automatic synchronization is not yet available.
• Linux compatibility outside Ubuntu has not been verified.
• Windows executable requires testing.

Status

Early preview release.

The application currently runs from Python source.
Standalone installers are planned.

Creator

Project initiated and maintained by @Onimee58

License

MIT