Skip to content

Support opening builds from builds folder via command line argu…#1807

Open
C1rdec wants to merge 5 commits intoPathOfBuildingCommunity:devfrom
C1rdec:feature/open-build-by-name
Open

Support opening builds from builds folder via command line argu…#1807
C1rdec wants to merge 5 commits intoPathOfBuildingCommunity:devfrom
C1rdec:feature/open-build-by-name

Conversation

@C1rdec
Copy link
Copy Markdown

@C1rdec C1rdec commented Apr 28, 2026

Add Command-Line Support for Opening Local Builds

Overview

This change adds support for opening existing local .xml builds via command-line arguments.

Previously, Path of Building only supported opening builds through the pob2:// protocol, which is limited to importing builds from external sources. There was no way for external tools to open a build that already exists in the local builds folder.

Usage

PathOfBuilding.exe "<path>/Path of Building (PoE2)/Builds/MyBuild.xml"

Benefits

  • Enables integration with external tools such as PoeLurker
  • Enables desktop shortcuts to open specific builds directly

Compatibility

  • Existing pob2:// protocol behavior is unchanged
  • Launching without arguments behaves as before
  • Invalid or missing files are handled gracefully (no crash)

Testing

  • ✅ Launch with valid .xml filename → build opens correctly
  • ✅ Launch with no arguments → default behavior unchanged
  • ✅ Launch with pob2:// URI → protocol handler still works
  • ✅ Launch with invalid .xml filename → no crash, fails gracefully

@C1rdec C1rdec changed the title feat: support opening builds from builds folder via command line argu… Support opening builds from builds folder via command line argu… Apr 28, 2026
@Wires77
Copy link
Copy Markdown
Member

Wires77 commented Apr 28, 2026

Do people really set up shortcuts for a single build on their computer? How is PoeLurker planning on implementing this?

@C1rdec C1rdec marked this pull request as draft April 28, 2026 03:44
@C1rdec
Copy link
Copy Markdown
Author

C1rdec commented Apr 28, 2026

Do people really set up shortcuts for a single build on their computer? How is PoeLurker planning on implementing this?

I’d probably use shortcuts myself, but for PoeLurker I’m currently listing PoB builds and linking a build to a character in an overlay, and the only way to open the Skill Tree is via the official website URL embedded in the XML. It would be really convenient if users could open the build directly in PoB.

@C1rdec
Copy link
Copy Markdown
Author

C1rdec commented Apr 28, 2026

2026-04-27_23-48-42

@C1rdec C1rdec marked this pull request as ready for review April 28, 2026 04:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants