Skip to content
OmniRef

Beginner guide

Reflectors, modules, modes — in plain English

The radio world is cryptic. This page explains OmniRef the way we wish someone had explained it to us on day one.

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.

What is a reflector?

A reflector is a shared online meeting room for digital voice radios. You (or your hotspot) connect over the internet. Everyone on the same room hears the conversation. OmniRef is the open-source server that hosts those rooms.

What is a module?

A module is a named room inside the reflector. OmniRef gives each one a letter and a purpose:

  • A — Main Room. The everyday hangout — general QSOs and meeting new operators.
  • B — Chat. Casual conversation when you want a quieter, talkative room.
  • C — Nets. Scheduled nets and structured check-ins.
  • D — Regional. Local and regional traffic for clubs and nearby operators.
  • E — Tech & Testing. Experiments, new modes, and troubleshooting without cluttering the main room.
  • Z — Echo Test. Hear yourself back so you can check audio before you go live.

What is a mode?

A mode is the digital voice format your radio speaks — DMR, D-STAR, Fusion/YSF, M17, AllStar, and others. Different radios speak different formats. Same-mode means everyone on a module uses the same format. That is the default, and it needs no special conversion hardware.

What about cross-mode conversion?

Cross-mode means translating between formats so different radios can share a conversation. Some codecs need an AMBE dongle. OmniRef treats this as opt-in: attach a dongle on the same machine, or reach one over the network, only if you want conversion. Same-mode never requires it — and never charges a codec license fee.

What do you run?

An all-Rust core as a single binary or Docker image, plus a Next.js dashboard. Configure with JSON Schema and omniref validate. For AI-assisted setup, see AGENTS.md / SKILL.md. For hosting options, see /host.