PioViewer URI Links Feature
What are PioViewer URI Links?
PioViewer URI links are special shortcuts that allow you to quickly open PioViewer from external sources like web browsers or other documents / applications.
These links look like: pioviewer://path
Setting Up URI Links
First Time Setup
When you start PioViewer, you may be prompted to enable URI links. Click "Yes" to enable this feature. You can also enable it later through the settings.
What This Enables
Once enabled, clicking on any pioviewer://
link will:
- Launch PioViewer or depending on the settings - bring already running PioViewer to the foreground
- Perform the requested action (open a trainer session, load a tree, etc.)
Types of Links
1. Trainer Session Links
Format: pioviewer://trainer/session/[session-number]
Example: pioviewer://trainer/session/42
What it does: Opens a specific trainer session directly, just like clicking the Play button for that session in the trainer.
How to create a link:
- Go to the trainer session overview
- Click "Copy Link"
2. Tree File Links
Format: pioviewer://tree/load?path=[file-path]
Example: pioviewer://tree/load?path=C%3A%5CPoker%5CStudy%5C3bet-pot.cfr
What it does: Opens a specific tree file in PioViewer.
With node navigation: You can also include a specific node to navigate to:
pioviewer://tree/load?path=[file-path]&nodeId=[node-id]
Note: The file path needs to be URL-encoded (spaces become %20, backslashes become %5C, etc.)
3. Test Link
Format: pioviewer://hello
What it does: Shows a test message to verify that URI links are working properly.
How to Use URI Links
Simply click on any pioviewer://
link on a webpage or in other program / document.
Creating Your Own Links
For Trainer Sessions:
- Note the session ID from your trainer
- Format:
pioviewer://trainer/session/
followed by the ID - Example: Session ID 25 becomes
pioviewer://trainer/session/25
For Tree Files:
- Copy the full path to your .cfr file
- Use an online URL encoder to encode the path
- Format:
pioviewer://tree/load?path=
followed by the encoded path
Notes
- URI links only work with your local PioViewer installation and are local to your PioViewre installation and file system. They don't make much sense to share with other people
Disabling URI Links
If you want to disable URI links:
- Go to PioViewer settings
- Look for URI protocol or file associations options
- Disable the pioviewer:// protocol handler
Note: This will prevent all pioviewer:// links from working until re-enabled.