FM-DX Webserver macOS Installation

Requirements

• Homebrew installed, see brew.sh.
• A suitable TEF receiver (e.g., Headless unit) connected via USB.
• A macOS-compatible audio card (required for non-Headless units).
• An open terminal window.

Preparation

Install the required packages for fm-dx-webserver:

brew install node sox ffmpeg

Check that Node.js is available:

node --version

If this command fails, link Node.js manually:

brew link node

Clone fm-dx-webserver

Clone the latest source code:

git clone https://github.com/NoobishSVK/fm-dx-webserver.git

Install Dependencies

cd fm-dx-webserver
npm install
npm audit fix

First Startup

Start the webserver:

npm run webserver

Open the interface in your browser at http://localhost:8080/. Follow the setup wizard and configure:

• Tuner connection: Direct
• USB device: Select the device starting with /dev/tty.usbmodem
• Audio device: Choose the correct input. For Headless Lite, select TEF668X Audio
• Admin password

After the message Data saved!, return to the terminal and stop the running process with Ctrl+C.

Start the webserver again in normal mode:

npm run webserver

When macOS requests permission for “Terminal” to access the audio device, click Allow.

Your fm-dx-webserver is now ready for use.

Upgrading fm-dx-webserver

Before upgrading, consider backing up your current fm-dx-webserver directory.

In your fm-dx-webserver directory run:

git pull

Restart your fm-dx-webserver, by pressing ctrl-c and running the command below.

npm run webserver

Caveat

With some TEF Headless units, a firmware upgrade may be required if the audio device cannot be selected.