Skip to content

christophebourguignat/wavelingo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Wavelingo

Real-time shortwave radio translator — Listen to ham radio stations worldwide and get live translations, right in your browser (desktop or smartphone).

Beta Telegram

What is Wavelingo?

Wavelingo connects to KiwiSDR receivers around the world, streams their audio in real time, transcribes spoken content, and translates it into your chosen language — all from a single web interface (dektop, tablet or smartphone).

✨ Features

  • 🗺️ Interactive World Map — Browse and select KiwiSDR receivers worldwide (new added regularly)
  • 📻 Live Radio Streaming — Connect to any KiwiSDR (if it is available) and listen to shortwave frequencies (0–30 MHz) with LSB/USB modulation
  • 🎙️ Real-time Transcription — Automatic speech-to-text
  • 🌍 Live Translation — Transcribed text is translated on-the-fly into 9 languages
  • 📱 Responsive Design — Tabbed mobile layout and split-panel desktop layout

🚀 User Guide

Quick Start

  1. Select a receiver — Click a marker on the map to pick a KiwiSDR station
  2. Set the frequency — Enter a frequency in kHz. Modulation is auto-selected (LSB below 10 MHz, USB above)
  3. Connect — Click Connect to start streaming audio from the receiver
  4. Translate — Click Translate to begin real-time transcription and translation
  5. Choose your language — Use the language selector to pick your target translation language

Tips

  • If a server is busy or down, try another one — status messages will guide you
  • The audio level meter shows signal activity in real time
  • Translations appear as subtitle-style text below the original transcription. You can change the target language at any time and all translations will be updated.
  • Bold green text in translations highlights named entities (call signs, location, ...)

Beta Limitations

  • Transcription sessions are limited in time
  • Join the Telegram group for updates and support

🛠️ Tech Stack

Layer Technology
Frontend React 18, TypeScript, Vite
UI Tailwind CSS, shadcn/ui, Lucide icons
Maps Leaflet + React-Leaflet
Themes next-themes
Radio Backend KiwiSDR WebSocket API via Edge Functions (SSE streaming)
Transcription ElevenLabs Scribe v2 (real-time WebSocket)
Translation Gemini 3 Flash via Lovable cloud backend
Infrastructure Supabase Edge Functions

📁 Project Structure

src/
├── components/
│   ├── ControlPanel.tsx      # Radio connection, frequency, volume controls
│   ├── MapPanel.tsx           # Leaflet map with KiwiSDR markers
│   ├── SubtitlesPanel.tsx     # Transcription + translation display
│   └── ThemeToggle.tsx        # Dark/light mode switch
├── hooks/
│   ├── useKiwiSDR.ts          # KiwiSDR streaming via SSE
│   ├── useTranscription.ts    # ElevenLabs Scribe integration
│   └── useTranslation.ts      # Translation pipeline
├── lib/
│   └── constants.ts           # Server list, languages, types
├── pages/
│   └── Index.tsx              # Main app layout (mobile + desktop)
supabase/functions/
├── kiwi-stream/               # Proxies KiwiSDR WebSocket → SSE
├── elevenlabs-scribe-token/   # Generates Scribe auth tokens
└── translate/                 # AI-powered translation endpoint

📋 TODO / Roadmap

  • Add more KiwiSDR receivers (and support other types of SDR)
  • Add frequency presets for popular ham bands
  • Support additional languages
  • Support other speech-to-text and transcription LLMs (including open weights)
  • Transcript export (text/SRT)
  • Signal strength (RSSI) display
  • Waterfall / spectrum visualization

Image

Image

Image Image

👤 Authors

F4DAN

Claude Code

Buy Me a Coffee at ko-fi.com

📄 License

MIT

Copyright 2026 Christophe Bourguignat

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

Real-time shortwave radio translator

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages