Lyra Remote

A browser client for Lyra-SDR. Lyra stays the rig. This page connects straight to the Lyra that is already running and runs the receiver, and a voice session, from the computer you are sitting at.

Download Lyra (the radio): github.com/N8SDR1/Lyra-SDR-cpp/releases

Download this page: github.com/N8SDR1/Lyra-Remote/releases — unzip Lyra-Remote.zip and double-click Open Lyra Remote.cmd.

How it works, including another computer, transmit, digital programs, and the password, is on the wiki. The same guide is in HELP.md. What this package contains is in RELEASE_NOTES.md.

The idea of a no-install browser TCI client comes from Brent N9BC's Thetis on the Web. This is the Lyra version of that idea, kept as its own project so Brent can work on it without the client living inside the radio repository.

What it does

• Connects to Lyra's TCI WebSocket. The box at the top of the page is that address.

• Shows VFO A, VFO B, mode, split, SUB, and an S-meter. The meter is a row of labeled blocks, S1 through S9+60, with the S-unit in large type and dBm beside it. A bright edge marks the live level, and a soft trail follows it down.

• Tunes RX1 by the step under VFO A (1 Hz, 10 Hz, 100 Hz, 500 Hz, 1 kHz, 10 kHz). A click or drag on the spectrum lands on that step. The wheel over the spectrum tunes by that step. Ctrl+wheel zooms; the span buttons do the same. Click a digit on the frequency, then roll the wheel or use the arrow keys, to move that place. The wheel on the rest of VFO A, and − / +, use the selected step. Shift is ten times the step. Type a frequency and press Enter, or double-click the display (7.147 is MHz, 7147 is kHz, 7147000 or 7.147.000 is hertz).

• Sets the RX1 mode, filter width, SUB, and split. Drag a passband edge to change the filter. The top band row tunes RX1 and recalls the last frequency and mode this browser used on that band.

• With SUB on, a second set of controls appears for the other receiver: an RX2 mode row, an RX2 filter row, and an RX2 band row under Bands. Vol 2 and Mute 2 sit in Audio, on the row under Vol. Click a digit on the second frequency, or roll the wheel there, to tune RX2. Those band buttons remember RX2 on their own and do not move RX1. CW pitch shows in CW (200 to 1500 Hz, steps of 10) and is the radio’s pitch.

• Draws the RX1 spectrum and waterfall. Span, scale, color, speed, and line smoothing stay in this browser. With SUB on, RX2 gets the same S-meter.

• Plays the receiver on this computer. Listen asks Lyra for the receive-audio stream. The speaker slider is local to the browser. Vol and Mute radio change the RX1 speaker on the radio. Vol 2 and Mute 2 change the RX2 speaker on the radio. The left ear of Listen is RX1. The right ear is RX2 only after Lyra itself is rebuilt with the stereo audio tap; until then both ears are RX1.

• Transmit dock: Start voice, a password box that is not saved in the page, a microphone list, Mic (−20 to +20 dB, this browser only), Low / Mid / High, MOX, Tune, and TX RF. Connecting does not move the desk microphone. MOX sends this computer's microphone after the equalizer and the Mic slider. Tune sends a carrier from Lyra and does not use the microphone. TX RF is the same percent as the Lyra TX panel. RF out and SWR are the radio's measured readings. Mic shows this computer's level once the microphone is open, and Lyra's reading while transmitting. ALC is limiter headroom while keyed, and it fills in when the connected Lyra sends that reading. Enable PA stays on the Lyra TX panel. Noise reduction stays on the Lyra Audio panel; the audio this page plays is already past that processing.

• Arrow buttons dock the sections. ← and → place a section on the left or the right. ↑ and ↓ move it in that column. Full spans the width. This browser remembers the arrangement.

• A newer copy of this page is announced when you open it. The notice is a link to the GitHub release. The page does not download or replace itself, and the check sends no radio address and no password.

Opening index.html by double-click can listen, and it cannot prove the password or open a microphone. Use Open Lyra Remote.

Use it on this computer

1. In Lyra, open Settings → Network. Turn TCI server running on. Leave Bind address at 127.0.0.1 and Port at 40001.
2. On this same computer, double-click Open Lyra Remote.cmd. That opens http://127.0.0.1:4173/. Leave the small server window running while you use the page.
3. Leave the address box at ws://127.0.0.1:40001 and press Connect if it is not already connected.

Opening index.html as a file can still listen. It cannot prove the password or open a microphone, and some browsers refuse the radio link entirely. Use Open Lyra Remote. The launcher uses Windows itself. Python is not required.

Use it from another computer on the same network

Two addresses. They are not the same thing.

What	Address
The page, on the computer where you are sitting	http://127.0.0.1:4173/
Lyra, in the box at the top of the page	ws:// plus the Lyra computer's address, then :40001

The page is always opened on the computer in front of you. You do not browse to the radio computer to get the page.

1. Copy this folder onto the computer you want to sit at (or clone the repository there). Double-click Open Lyra Remote.cmd on that computer. The browser opens http://127.0.0.1:4173/ there.
2. On the computer that is running Lyra, open a command prompt and run ipconfig. Use the IPv4 Address on the house network, the one that looks like 192.168.1.50.
3. On that Lyra computer, open Settings → Network. Turn TCI server running on. Set Bind address to 0.0.0.0. Leave Port at 40001. 127.0.0.1 only accepts the computer Lyra is running on, so another computer cannot connect until the bind address is 0.0.0.0.
4. Allow Lyra through the Windows firewall for private networks, inbound TCP port 40001.
5. On the computer where the page is open, replace the address box with ws://192.168.1.50:40001, using the address from step 2, and press Connect.

The browser remembers the last address (lyra-remote-url). Each person does this on their own network, against their own Lyra. They do not use your address.

This stays on the house network. Do not forward port 40001 to the internet. Who may connect, and the password, are set on the Lyra computer under Settings → Remote. Lyra checks them itself. The link is direct: no outside server carries it, and no authentication service is contacted. HELP.md explains the lists, the password, and what this receiver page applies today.

Layout

Open Lyra Remote.cmd   opens the page on this computer
serve.ps1              the local page server
index.html             the page
help.html              setup and security, also linked from the page
HELP.md                the same guide, for the folder and for GitHub
RELEASE_NOTES.md       what this package contains
css/app.css
js/tci.js              TCI parser and socket
js/audio.js            receive-audio playback
js/pan.js              spectrum and waterfall
js/voice.js            microphone, equalizer, and transmit frames
js/layout.js           column layout
js/update.js           newer-release notice
js/app.js              the desk
assets/                the Lyra mark

To hand someone a copy, send Lyra-Remote.zip. They unzip it and double-click Open Lyra Remote.cmd. Nothing else has to be installed.