vsdx

What it is and what it does

vsdx is a Python library for reading and writing Microsoft Visio .vsdx files without requiring Visio itself. It lets you programmatically find, modify, and remove shapes, read and set shape properties and data, and work with pages and connectors. The library also supports templating: you can embed Jinja2 code into a .vsdx file and render it with context data to generate new diagrams dynamically.

The package depends on Jinja2 for template rendering and the deprecation library for API lifecycle management. It supports Python 3.8 through 3.14 and is classified as Beta. The library is useful for automation workflows where you need to generate or modify Visio diagrams from data, extract information from existing diagrams, or build diagram-generation pipelines without manual intervention.

Use it for:

• Automate diagram generation from templates and data sources for reports or documentation.
• Extract shape text and properties from existing .vsdx files for data processing or migration.
• Programmatically modify Visio diagrams by finding and updating specific shapes or connectors.
• Build CI/CD pipelines that generate or update architecture or flowchart diagrams from configuration.
• Create batch operations to remove, duplicate, or reorganize shapes across multiple Visio files.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

vsdx reads, modifies, and creates Microsoft Visio .vsdx files programmatically, supporting shape manipulation, templating via Jinja2, and file I/O operations.

Yes, if you need to automate Visio file manipulation without Visio installed. The low install friction, permissive license, and broad Python version support make it straightforward to adopt. The aging maintenance status (222 days since last release) is a minor concern for long-term stability, but the repository is active and no security vulnerabilities are known. Verify that the feature set covers your specific use case before committing to production.

Install

vsdx on PyPI

pip install vsdx

uv add vsdx

poetry add vsdx

Installing vsdx

Before you install

Low install friction: pure Python wheel with only two runtime dependencies (Jinja2 and deprecation). Maintenance status is aging—last release 222 days ago—but the repository is active and not archived, with recent commits as of 2026-01-04.

License in practice

Permissive license treatment means you can use this in commercial and proprietary projects without copyleft obligations.

Quickstart

from vsdx import VisioFile

with VisioFile('my_file.vsdx') as vis:
    shape = vis.pages[0].find_shape_by_text('Shape to remove')
    if shape:
        shape.remove()
    vis.save_vsdx('updated.vsdx')

Verify before relying

• Whether the package handles all Visio file format variations and edge cases reliably in production use.
• Performance characteristics when working with large or complex .vsdx files.
• Completeness of Jinja2 template support for complex conditional and loop scenarios.

Package facts

Evidence: vsdx-0.6.1-py3-none-any.whl

Tags

More Utilities packages