Skip to content

visiowings

VBA Editor for Microsoft Visio with VS Code integration.

Edit Visio VBA modules in your favourite editor with live sync, Git support, and modern tooling. Inspired by xlwings.

At a glance

  • 🔁 Live sync — save in VS Code, see the change in Visio.
  • 🔄 Bidirectional — changes in Visio flow back to VS Code (optional).
  • 📚 Multi-document — drawings, stencils, and templates side by side.
  • 🦆 Rubberduck — @Folder annotations preserved as directories.
  • 🌍 Locale-aware — automatic codepage detection for cp1252, cp1251, cp932, cp936, cp949, cp950, …
  • 📦 Single command install — pipx install visiowings.

Get started

  • Installation

    Install with pipx and connect to a running Visio instance.

    Installation guide

  • Configuration

    Persist defaults in .visiowings.toml and use visiowings init.

    Configuration

  • Codepages

    Locale matrix and how visiowings picks the right encoding.

    Codepages

  • Releasing

    The fully automated release pipeline (Sigstore + Trusted Publishing).

    Releasing

  • Dev environment

    just recipes, nox matrix, pre-commit, shared editor config.

    Development environment

  • Optimization plan

    What landed in Phases A–H and how the modern pipeline came together.

    Optimization plan

Project status

visiowings is currently in 0.x; small breaking changes between minor versions are possible while the API stabilises. The full source code lives on GitHub.

Issues and pull requests are very welcome — please read CONTRIBUTING first.