Releases

Latest Release

v2.4.0 (Latest Release)

Release Date: July 20, 2026

Additions

  • Combine multiple ROIs in optimization — flex-search and exhaustive-search can now target the union of several same-type regions (cortical by name including cross-hemisphere, subcortical by label, or multiple spheres) through a searchable region picker with region chips.
  • TI safety metrics (Cassarà et al. 2025) — peak carrier field and SAR-driver maps are now written as subject- and MNI-space NIfTI volumes alongside TI_max.
  • Surface-based group statistics — run group comparisons and correlations directly on the fsaverage cortical surface with cluster-based permutation testing and inflated-cortex rendering; TI fields now auto-project to fsaverage after each simulation.
  • CT and NIfTI ingestion — preprocessing can now import head CT scans and pre-converted NIfTI files (T1w/T2w/CT/DWI), not only DICOMs.
  • 3D Visualizer subcortical field export — export subcortical structures colored by a simulation field (PLY) using a searchable label picker.
  • Simulator skip/replace policy — choose to skip or overwrite existing simulation outputs instead of aborting with an error.
  • Montage visualizer clarity — connection arcs now show which channels interfere (TI partners), with a channel color legend.
  • Faster simulations — mesh-to-NIfTI conversion is parallelized, cutting end-to-end simulation time by roughly 30%.

Fixes

  • DICOM import crash — fixed a crash on projects seeded with macOS junk (AppleDouble) files.
  • QSIPrep preprocessing failures — the root BIDS dataset description is now always created, and a missing T1w is reported up front instead of failing deep in the workflow.
  • 3D exporter file loss — fixed the exporter deleting cortical region files after export.
  • FreeSurfer data volume versioning — the volume is now versioned by image tag so image updates correctly re-seed it.

Desktop App (latest): macOS Intel · macOS Apple Silicon · Windows · Linux AppImage · Linux deb

Other:

For installation instructions, see the Installation Guide.

Additions

  • New Source tool (extension): build MNE EEG forward solutions and project TI fields onto the fsaverage template.
  • Preprocessing now automatically converts DWI DICOMs to BIDS NIfTI alongside T1w/T2w.

Fixes

  • FreeSurfer recon-all no longer falsely reports its output as already existing on a fresh project.

Desktop App (latest): macOS Intel · macOS Apple Silicon · Windows · Linux AppImage · Linux deb

Other:

For installation instructions, see the Installation Guide.

Fixes & Maintenance

Flex-search and Simulation Workflow
  • Flex-search simulation identity and UI naming — simulator-generated flex-search runs now keep a unique storage key while showing compact, readable run labels and hover metadata in the GUI, following the run-id/run-name split used by tools such as MLflow.
  • Flex-search valid skin region controls — flex-search now exposes skin_region_margin_mm, optional landmark guarding, GUI controls, and report imagery so users can inspect and tune the valid scalp placement region used by optimization.
Reports and Visualization
  • Report and visualization follow-ups — simulation reports use clearer missing-visualization states and simulations continue when optional montage visualization cannot be generated.
  • Analyzer discovery improvements — Analyzer refreshes simulation lists when shown and after simulation completion, with clearer messages when TI/mTI post-processing outputs are missing.
NIfTI Viewer
  • Electrode NIfTI overlays — the NIfTI Viewer can create and auto-load a single label-mask overlay showing saved electrode placements from documentation/config.json. Labels are channel-based, use the same color order as montage PNGs, and are saved next to montage images under TI/montage_imgs/ or mTI/montage_imgs/ depending on simulation mode.
GUI Reliability
  • GUI lifecycle reliability — preprocessing, simulation, flex-search, ex-search, Analyzer, and NIfTI Viewer tabs now refresh dependent outputs more consistently and avoid reporting success after failed subprocesses.
Preprocessing and QSI
  • DICOM preprocessing hardening — DICOM discovery now searches nested .dcm/.dicom files and supports basic compressed inputs (.zip, .tar, .tar.gz, .tgz) in the documented sourcedata/sub-{id}/{T1w,T2w}/dicom/ layout.
  • Preprocessing existing-output handling — the GUI now detects existing outputs before rerunning DICOM conversion, CHARM, FreeSurfer recon-all, QSIPrep, QSIRecon, or DTI extraction. Users can cancel, skip existing outputs, or explicitly replace them and rerun. The same policy is available to scripts through skip_existing_outputs and replace_existing_outputs.
  • QSI Docker preflight — QSIPrep and QSIRecon now validate Docker/DooD setup early, before starting long-running container work.
  • QSI containers updated — QSIPrep and QSIRecon now target PennLINC 26.0.0, with CLI compatibility handling for QSIPrep concat and QSIRecon --input-type qsiprep.
Telemetry and Release Operations
  • Telemetry error grouping — operation telemetry now emits a per-run run_id plus a stable, path-sanitized error_fingerprint, making recurring failures easier to group without sending tracebacks or local paths.
  • Telemetry-driven preflight checks — common user/environment problems are validated before telemetry-tracked work starts for simulation, flex-search, and empty preprocessing subject selections, reducing noisy error reports while preserving real exceptions.
  • Telemetry consent persistence — GUI telemetry consent is stored in the user-level config mount and should no longer reappear every launch once answered.
  • Launcher telemetry normalization — host OS and architecture values are canonicalized across the Electron launcher and loader.py, keeping telemetry slices consistent across entrypoints.
  • Community link — README and release help links now point to the active TI-Toolbox Discord server.
  • Release-gate tests — added Dockerfile.test-based integration checks plus a self-contained comprehensive release-gate entry point using only test-environment fixtures.

Desktop App (latest): macOS Intel · macOS Apple Silicon · Windows · Linux AppImage · Linux deb

Other:

For installation instructions, see the Installation Guide.

Getting Help

If you encounter issues with any release:

  1. Check the Installation Guide for setup instructions
  2. Review the Troubleshooting section
  3. Search existing issues
  4. Ask in GitHub Discussions
  5. Join the TI-Toolbox Discord server