Skip to content

Magellan v2.2.3

Choose a tag to compare

@bartojesse bartojesse released this 09 Feb 03:13
· 5 commits to main since this release
3bd667c

Release Notes (2.1.2 → 2.2.3)

Highlights

  • Record edit locks with heartbeats: Edit locks can be enabled in settings, use heartbeats to keep leases alive, and can be stored in a shared sidecar database for multi-user installs.
  • Expanded map legend modes: Info maps now support coloring and filtering by data types and user access types in the legend mode selector.
  • Map layout tuning: Added quick controls and advanced sliders for spacing, hub behavior, and disconnected node layout to fine-tune map physics output.

Improvements

  • External DB bootstrap settings: The app reads bootstrap settings from instance/launcher_settings.json to resolve the database path when no DB_PATH env var is set, keeping external DB paths portable between launches.
  • Legend clarity options: Added a settings toggle for displaying legend item counts to show how many nodes or links match each filter.

Documentation

  • SQLite multi-user editing playbook: New guidance on optimistic concurrency, heartbeat presence, and locking options for shared SQLite deployments.

Installation

Recommended installation (Windows)

  1. Open the Microsoft Store and install Python 3.11+.
  2. Download and run the Magellan installer/executable.
  3. Launch Magellan and follow the Setup Wizard:
  • Create a new database for a fresh install, or
  • Connect to an existing database if you already have one.
  1. Finish the wizard and start working.
     

Shared database (multi-user)

  1. Place the SQLite database on a shared network path (SMB/NAS).
  2. Ensure all users have read/write access to the database file location.
  3. In the Setup Wizard, point Magellan to the shared database path.
  4. In Settings, enable Edit Locks for safer concurrent editing.
     

Configuration tips

  • Use a real shared file path for multi-user installs; avoid syncing tools that interfere with SQLite locks.
  • If you need to relocate the database later, rerun the Setup Wizard and select the new path.
     

Troubleshooting

  • If the Setup Wizard cannot find or create the database, verify the folder is reachable and writable.
  • For shared databases, confirm the network path is stable and accessible to all users.