Skip to content
OmniRef

Open source · All-mode · Built for speed

OmniRefThe fast, open-source reflector that makes digital voice simple.

OmniRef is an all-mode ham radio digital voice reflector — D-STAR, Fusion/YSF, DMR, M17, AllStar, and more — with a Rust core for speed, rooms in plain English, and a one-prompt install for your AI coding assistant.

D-STARFusion / YSFDMRM17AllStarP25 · plannedNXDN · plannedFreeDV · plannedEchoLink · planned

Why it is the most modern reflector

Latest technology for speed and clarity — without the cryptic radio folklore. Plain English first; serious engineering underneath.

  • Built for speed

    Rust + tokio async, a single static binary, and a tiny memory footprint — fast enough for a $6 droplet or a Raspberry Pi.

  • Next.js dashboard

    Live updates and in-browser listening so you see who is where — and hear the room — without cryptic status dumps.

  • Modules with jobs

    A Main Room, B Chat, C Nets, D Regional, E Tech & Testing, Z Echo Test — rooms named by purpose.

  • Same-mode, zero fee

    Same digital format talks to the same format with no AMBE hardware and no codec license fees.

  • Cross-mode is opt-in

    Attach an AMBE dongle locally or over the network only when you want modes to translate.

  • One-prompt install

    AGENTS.md and SKILL.md let an AI coding assistant install OmniRef end to end. Modern open standards throughout.

Latest technology

Built for speed

OmniRef is built on current tooling for performance: an all-Rust core with tokio async, a single static binary, a Next.js dashboard with live updates and in-browser listening, and modern open standards. It runs on a ~$6/month droplet or a Raspberry Pi — ref1.omniref.io lives on about 1 GB of RAM.

  • Low latency voice

    An async Rust core (tokio) keeps the reflector lean so audio paths stay snappy — built for live radio, not bloated middleware.

  • Handles many users

    One process, modern concurrency, and clear modules. Clubs and public rooms share the same fast path without a stack of mystery services.

  • Fast startup

    A single static binary (or Docker) comes up quickly. Validate config, start the service, and you are on the air.

  • Tiny footprint

    Small memory use so it fits a cheap VPS or a Raspberry Pi. The live demo at ref1 runs on a ~1 GB droplet.

How it works

Connect → pick a module → talk. Same-mode by default. Cross-mode only when you opt in.

How OmniRef connects radios to modulesRadioHotspotOmniRefA MainB ChatC NetsD Regional

Radios and hotspots → OmniRef hub → plain-English modules

  1. Step 1

    Connect

    Your radio or hotspot joins an OmniRef reflector — a shared online room for digital voice.

  2. Step 2

    Pick a module

    Choose a module by purpose: Main Room, Nets, Echo Test, and more — named in plain English.

  3. Step 3

    Talk same-mode

    Stay in one mode (DMR↔DMR, D-STAR↔D-STAR…). No dongle, no codec license fees.

  4. Step 4

    Opt into cross-mode

    Need different modes together? Attach an AMBE dongle locally or remotely — cross-mode is opt-in only.

One-prompt install

Install with one prompt to your AI coding assistant

Paste this into Cursor, Claude Code, or any agent that can read AGENTS.md and SKILL.md in github.com/adamehrheart/OmniRef. Replace <IP> and <name> — the assistant can install and configure end to end.

One-prompt install
Install OmniRef on my server at <IP> for my club <name> using github.com/adamehrheart/OmniRef
Classic shell alternative
git clone https://github.com/adamehrheart/OmniRef.git && cd OmniRef && cat AGENTS.md

Prefer the AI prompt above. The shell line clones the repo so you can follow AGENTS.md yourself.

Longer setup prompt

Same idea, with explicit goals and plain-English radio terms.

Detailed agent prompt
You are helping me install and configure OmniRef from https://github.com/adamehrheart/OmniRef — an open-source all-mode ham radio digital voice reflector (D-STAR, Fusion/YSF, DMR, M17, AllStar; more modes planned).

Read AGENTS.md and SKILL.md in the repository first. Prefer the single static Rust binary or Docker image. Use JSON Schema config and run `omniref validate` before starting the service.

Goals:
1. Install OmniRef on my server (replace <IP> / club name if I give them).
2. Configure modules with clear purposes: A Main Room, B Chat, C Nets, D Regional, E Tech & Testing, Z Echo Test.
3. Enable same-mode reflecting with no AMBE dongle (default). Only add cross-mode / AMBE if I explicitly ask.
4. Expose the Next.js dashboard (live updates + in-browser listening) and say how to open the admin view.
5. Print exact next steps to connect a hotspot/radio and how to reach the echo test module.

Explain every radio term in plain English the first time you use it (reflector, module, mode, dongle). Use https://omniref.io and https://ref1.omniref.io for the live demo.

MCP: assistants that can operate, not just read

MCP (Model Context Protocol) is a standard way for AI assistants to call tools. OmniRef plans an MCP server so an assistant can check reflector status and manage modules — with your permission — instead of only skimming docs. Combined with AGENTS.md, SKILL.md, and omniref validate, operations stay as clear as the dashboard.

Discovery placeholders live under /.well-known/ for future MCP endpoints. See /agents.

Live demo

The public demo reflector runs on a small ~1 GB droplet — proof the stack stays light. Connect and try the dashboard as it lands.

Open ref1.omniref.io

An opt-in public directory of OmniRef reflectors is planned.

FAQ

What is OmniRef?
OmniRef is an open-source, all-mode ham radio digital voice reflector. It links radios using D-STAR, Fusion/YSF, DMR, M17, AllStar, and more planned modes into plain-English modules (rooms) you can host yourself — as a single Rust binary or Docker container — with a Next.js dashboard and browser listening.
What is a reflector, in plain English?
A reflector is a shared online meeting room for digital voice radios. Operators connect their radios or hotspots; everyone on the same module hears the conversation. OmniRef is the modern, open-source server that hosts those rooms.
Do I need an AMBE dongle?
No for same-mode use. OmniRef works same-mode with no hardware dongle and no license fees. Cross-mode voice conversion is optional: attach an AMBE dongle locally or reach one over the network only if you want different modes to talk to each other.
Which modes are supported?
Shipping focus: D-STAR, Fusion/YSF, DMR, M17, and AllStar. Planned: P25, NXDN, FreeDV, EchoLink, and more as the project grows.
What are modules A–Z?
Modules are named rooms with clear jobs: A Main Room, B Chat, C Nets, D Regional, E Tech & Testing, Z Echo Test. You join the room that matches what you are doing — nets on C, audio checks on Z — instead of memorizing cryptic numbers alone.
All questions