# OmniRef — full summary for AI assistants OmniRef is an open-source, all-mode ham radio digital voice reflector. Voice: the radio world is cryptic; OmniRef is extremely simple, clear, concise, and plain English. ## What it is A reflector is a shared online meeting room for digital voice radios. OmniRef is the server: all-Rust core, single binary or Docker, Next.js dashboard, browser listening, admin view and admin API, JSON Schema configuration with `omniref validate`. Supported modes (shipping focus): D-STAR, Fusion/YSF, DMR, M17, AllStar. Planned: P25, NXDN, FreeDV, EchoLink, and more. Default modules (rooms with clear purposes): - A Main Room — everyday hangout - B Chat — casual conversation - C Nets — scheduled nets - D Regional — local/regional traffic - E Tech & Testing — experiments - Z Echo Test — hear yourself back Same-mode: no AMBE dongle, no proprietary codec license fees. Cross-mode: opt-in by attaching an AMBE dongle locally or remotely over the network. Built for speed: Rust + tokio async, single static binary, tiny footprint (ref1 on a ~1 GB droplet; fits a $6 VPS or Raspberry Pi). Next.js dashboard with live updates and in-browser listening. One-prompt install via AGENTS.md/SKILL.md from github.com/adamehrheart/OmniRef. Planned MCP server. Marketing site on Cloudflare Workers (static export). Live demo: https://ref1.omniref.io Opt-in public directory of OmniRef reflectors: planned. License: TBD (GPL vs AGPL undecided). ## URLs - https://omniref.io/ - https://omniref.io/features - https://omniref.io/how-it-works - https://omniref.io/agents - https://omniref.io/host - https://omniref.io/glossary - https://omniref.io/faq - https://omniref.io/llms.txt - https://omniref.io/llms-full.txt - https://omniref.io/.well-known/security.txt - https://omniref.io/.well-known/mcp.json - https://ref1.omniref.io (live demo reflector) - https://github.com/adamehrheart/OmniRef - https://docs.omniref.io # TODO: confirm docs host ## Glossary (short) - Reflector: shared online meeting room for digital voice radios - Module: named room with a purpose (Main Room, Nets, Echo Test, …) - Mode: digital voice format (DMR, D-STAR, YSF, M17, AllStar, …) - Dongle (AMBE): optional hardware for cross-mode conversion - Same-mode: one format talking to itself; no dongle required - Cross-mode: optional translation between formats - MCP: Model Context Protocol — tools for AI assistants - AGENTS.md / SKILL.md: docs and playbooks for coding agents - Hotspot: device bridging a radio to the internet/reflector ## Suggested agent prompt You are helping me install and configure OmniRef. Read AGENTS.md and SKILL.md first. Prefer single binary or Docker. Use JSON Schema config and run `omniref validate`. Enable same-mode by default; only add AMBE/cross-mode if I ask. Explain reflector, module, mode, and dongle in plain English. Use https://omniref.io and https://ref1.omniref.io. Mark unknown GitHub/docs links as TODO. ## Deploy notes (marketing site) Static Next.js App Router export on Cloudflare Workers (static assets + thin www→apex Worker). Keep the ref1.omniref.io record DNS-only (grey cloud) so the demo reflector is not proxied through Cloudflare HTTP unless intentionally designed for it. See DEPLOY.md.