XENEON EDGE Companion

Install in three steps

This page covers the companion. The ObsidianEdge widget itself is installed in iCUE (Home, then XENEON EDGE, then Widgets). It is not on the Elgato Marketplace yet. Give it a page of its own at Extra Large: the Reader page and the Navigator page want the whole panel.

1. Install the companion in Obsidian

   The quickest path today is BRAT, the community "Beta Reviewers Auto-update Tool": install BRAT from Community plugins, open its settings, choose "Add beta plugin", paste https://github.com/YnotLiveLyfe/edge-companion and add it. BRAT installs the companion and keeps it current. Once the companion is listed in Obsidian's community directory it will be one search away under Community plugins, Browse.

   By hand instead: unzip the download above and copy the edge-companion folder into <your vault>\.obsidian\plugins\. The folder holds main.js, manifest.json, styles.css and a README; the code is plain JavaScript you can read, and the source lives at github.com/YnotLiveLyfe/edge-companion.

2. Enable it in Obsidian

   Settings, then Community plugins, then turn on XENEON EDGE Companion. It listens on 127.0.0.1:47610 while Obsidian runs. Change the port in the plugin's settings if something else uses it, and set the widget's Helper port setting in iCUE to the same number.

3. Allow localhost once when iCUE asks

   The first time the widget reaches the companion, iCUE shows a permission request for a localhost address. That address is the companion on your own PC. Allow it; iCUE asks only once. The panel says "Companion connected" and follows whatever note is open in Obsidian.

Turn the XENEON EDGE's pages from the panel

iCUE turns the XENEON EDGE's pages with two keystrokes you record once in iCUE: hover the XENEON EDGE, open Screen Setup, set Previous Display Screen to Ctrl+Alt+Shift+PageUp and Next Display Screen to Ctrl+Alt+Shift+PageDown.

With those recorded, the chevrons in the widget's header turn the pages, and the companion brings the ObsidianEdge page up whenever Obsidian comes to the front while the XENEON EDGE shows another page (setting "Jump to the ObsidianEdge page when Obsidian comes forward", on by default). The keys fire only while Obsidian is the active window, so a chevron tap from another app brings Obsidian forward first. If you recorded other keys, type them into the plugin's two settings.

What the companion does, and does not do

• Reads your vault to show notes, images, links and folders on the panel.
• Acts on Obsidian only through Obsidian's own commands and editor: open a note, toggle reading view, insert a syntax card at the cursor, set a heading level, fold.
• Writes only what you ask for from the panel: a pin, a colour you set on a note or folder, and a plan file when you use Arrange. It never renames, moves or deletes a note.
• Listens on your PC's loopback addresses only (127.0.0.1 and ::1). No internet, no account, no telemetry.
• Nothing hidden: the code is plain JavaScript you can read, and the README on GitHub and in the zip lists every route it serves.
• Removal: in Obsidian, Settings, then Community plugins, then uninstall XENEON EDGE Companion, or delete its edge-companion folder from <your vault>\.obsidian\plugins\. Pins and folder colours go with it, since they live in the plugin's own data; a note colour stays in that note's color: property, and plans stay in ObsidianEdge/plans.

If the panel says "Companion not running"

• Obsidian must be running with the companion enabled; the panel reconnects by itself within a few seconds.
• Check the port: the plugin's settings in Obsidian and the widget's settings in iCUE must agree (47610 unless you changed it).
• If you missed the localhost prompt, it waits in iCUE's notification centre (the bell, top right): find the request for localhost:47610 and choose Allow. A changed port brings one new prompt for that port.
• If a finger press on the panel lands on another screen, Windows has the touch digitiser mapped to the wrong monitor: close iCUE, run "Calibrate the screen for pen or touch input", choose Setup, Touch input, and tap the XENEON EDGE when it asks.

Still stuck? Email [email protected] with the widget version from iCUE and the companion version from Obsidian's plugin list.