v2.2.0

Animated Diagrams 2.2.0

Mermaid support. Paste a Mermaid diagram and get an animation, or export your diagram back to Mermaid for
GitHub, GitLab, Notion, Obsidian or Confluence.

✨ What's new

Import from Mermaid (File → Import from Mermaid…, Ctrl+Shift+I)

• sequenceDiagram → animated scenario: participants become nodes and edges are created between them;
  messages become request / response / error / event steps (2xx / 4xx / 5xx codes set success or error);
  activate shows the "Active" state, Note becomes a note, par runs steps in parallel; loop, alt, opt,
  critical and break become chapters; autonumber and title are supported.
• flowchart / graph → diagram: shapes map to element types (database, queue, decision, document, cloud…),
  edges keep labels, arrows, dotted and thick lines; style, classDef and linkStyle colors are kept;
  nodes are laid out the way Mermaid lays them out.
• Markdown: ```mermaid blocks in .md files are read. A flowchart gives the layout, a sequenceDiagram
  gives the scenario.
• Syntax errors show the line and column. The text is prefilled from the clipboard.
• .mmd, .mermaid and .md files open via Open, drag and drop or the command line.
• Powered by merman, a Rust implementation compatible with mermaid.js;
  no browser or Node.js needed.

Export to Mermaid (File → Export → Mermaid)

• Flowchart (.mmd): shapes, labels, arrows, line styles and colors. Exact positions are kept in
  %% ad:pos comments for a lossless re-import.
• Sequence diagram (.mmd): the scenario as messages, notes, par blocks, timers (⏱), states (●) and
  chapters (⚑).
• Markdown (.md): both diagrams, ready for a README.

CLI and MCP

animated-diagrams --export checkout.gif checkout.mmd          # sequenceDiagram → animated GIF
animated-diagrams --export docs/flow.md diagram.json          # diagram → Markdown with Mermaid
animated-diagrams --export seq.mmd --mermaid sequence diagram.json

• New MCP tools: import_mermaid (text or file) and to_mermaid (returns the text without writing a file).
  export_animation accepts format: "mermaid" with mermaidKind.
• An agent can sketch a flow as a sequenceDiagram, import it and refine it.

Fixes

• MCP: messages added without edgeId now fly along the edge between their nodes, not the first edge of the
  document. Changing a message's sender or receiver moves it to the matching edge.
• Labels on curved edges are no longer clipped at the edge of exported frames.
• Files passed on the command line open after the main window appears.

Project

• Roadmap: planned releases up to 4.4.

📦 Downloads

Platform	File
Windows 10 / 11 (x64)	animated-diagrams-2.2.0-win64.exe (installer) or animated-diagrams-2.2.0-win64.zip (portable)
Ubuntu 24.04	animated-diagrams_2.2.0-1ubuntu24.04_amd64.deb
Debian 13	animated-diagrams_2.2.0-1debian13_amd64.deb
Fedora 43	animated-diagrams-2.2.0-1.fc43.x86_64.rpm

Checksums are in SHA256SUMS.txt.

sudo apt install ./animated-diagrams_2.2.0-1ubuntu24.04_amd64.deb   # Ubuntu 24.04
sudo apt install ./animated-diagrams_2.2.0-1debian13_amd64.deb      # Debian 13
sudo dnf install ./animated-diagrams-2.2.0-1.fc43.x86_64.rpm        # Fedora 43

Windows installer: updates 2.1.0 in place — same folder and shortcuts, settings and user plugins kept.
Silent update: animated-diagrams-2.2.0-win64.exe /VERYSILENT /SUPPRESSMSGBOXES.

🛠 Building from source

Mermaid import needs Rust 1.95+ (cargo): merman is built from crates.io via Corrosion and linked statically.
Without Rust, configure with -DWITH_MERMAID=OFF; export to Mermaid still works.

⚠️ Known limitations

• Only flowchart / graph and sequenceDiagram are imported; other Mermaid types (classDiagram, gantt, …) are
  skipped with a warning. subgraph frames are not imported (their nodes are).
• Mermaid is a static format: timing and effects are simplified on export. Use GIF, video, PowerPoint or the
  HTML player for animation.
• The Windows installer is not code-signed. SmartScreen may warn: More info → Run anyway.
• The detailed guides in docs/ are in Russian for now.

Documentation: README ·
Mermaid guide

Full Changelog: v2.1.0...v2.2.0

Full Changelog: v2.1.0...v2.2.0