MorseWave

Retro Telegraph Reimagined - A high-performance Morse code encoder/decoder built with Rust and WebAssembly.

Overview

MorseWave combines vintage telegraph aesthetics with modern web technology to create an immersive Morse code learning and communication tool. Built with Rust for core logic and compiled to WebAssembly for browser performance, it features a retro-futuristic CRT interface with real-time audio and visual feedback.

Features

Core Functionality

• Text to Morse Encoding - Convert any text message to Morse code instantly
• Morse to Text Decoding - Translate Morse code back to readable text
• Real-time Validation - Automatic syntax checking for Morse code input
• Character Support - Full alphabet, numbers, and common punctuation

Audio & Visual

• Audio Transmission - Play Morse code with authentic 800Hz sine wave tones
• LED Indicator - Visual feedback synchronized with audio playback
• Signal Monitor - Real-time waveform visualization on canvas
• Adjustable Speed - 5-40 WPM (Words Per Minute) control
• Volume Control - 0-100% audio level adjustment

Interactive Features

• Manual Telegraph - Send Morse code with dot/dash buttons
• Keyboard Shortcuts - Fast input with J/K keys or dot/dash symbols
• Auto-transmit Mode - Automatic playback on encoding
• Transmission Log - History of all messages with timestamps
• One-click Copy - Copy encoded Morse to clipboard

User Interface

• Retro-Futuristic Design - CRT screen effects with phosphor green glow
• Scanline Animation - Authentic vintage monitor simulation
• Responsive Layout - Works on desktop and mobile devices
• Morse Reference Table - Quick lookup for all supported characters
• Persistent Settings - LocalStorage for history and preferences

Technology Stack

Installation

Prerequisites

• Rust 1.70 or higher
• Python 3.x (for local server)
• Modern web browser with WASM support

Quick Start

1. Clone the repository:

git clone https://github.com/chronocoder/morsewave.git
cd morsewave

2. Build and run:

build.bat

The build script will:

• Install wasm-pack if needed
• Compile Rust to WebAssembly
• Start a local server
• Open your browser automatically

Manual Build

cargo install wasm-pack
wasm-pack build --target web --out-dir www/pkg
cd www
python -m http.server 8080

Open http://localhost:8080 in your browser.

Running After Build

For subsequent runs, use the start script:

start.bat

Usage

Basic Encoding

1. Type your message in the TRANSMITTER panel
2. Click ENCODE to convert to Morse code
3. Click ▶ TRANSMIT to play audio
4. Watch the LED and signal monitor for visual feedback

Basic Decoding

1. Enter Morse code in the RECEIVER panel
   • Use . for dot
   • Use - for dash
   • Use / for word space
2. Click DECODE to translate
3. View the decoded message

Manual Telegraph

• Click DOT button or press . or J key
• Click DASH button or press - or K key
• Click SPACE or press Space bar
• Watch real-time decoding as you type

Keyboard Shortcuts

Morse Code Reference

Letters

A .-    B -...  C -.-.  D -..   E .     F ..-.
G --.   H ....  I ..    J .---  K -.-   L .-..
M --    N -.    O ---   P .--.  Q --.-  R .-.
S ...   T -     U ..-   V ...-  W .--   X -..-
Y -.--  Z --..

Numbers

0 -----  1 .----  2 ..---  3 ...--  4 ....-
5 .....  6 -....  7 --...  8 ---..  9 ----.

Timing

• Dot duration: 1 unit
• Dash duration: 3 units
• Gap between elements: 1 unit
• Gap between letters: 3 units
• Gap between words: 7 units

Project Structure

morsewave/
├── src/
│   └── lib.rs              # Rust core logic
├── www/
│   ├── index.html          # Main interface
│   ├── favicon.svg         # Site icon
│   ├── css/
│   │   └── style.css       # Retro-futuristic styling
│   ├── js/
│   │   └── app.js          # Application logic
│   └── pkg/                # Generated WASM files
├── Cargo.toml              # Rust dependencies
├── build.bat               # Build automation
├── start.bat               # Server startup
└── README.md               # Documentation

Configuration

Speed Control

Adjust WPM (Words Per Minute) from 5 to 40:

• 5 WPM: Beginner friendly
• 20 WPM: Standard practice speed
• 40 WPM: Advanced operator speed

Formula: dot_duration_ms = 1200 / WPM

Audio Settings

• Frequency: 800 Hz sine wave
• Volume: 0-100% adjustable
• Type: Web Audio API OscillatorNode

Browser Compatibility

Requirements:

• WebAssembly support
• Web Audio API
• Canvas API
• LocalStorage

Performance

• WASM bundle size: ~50KB (optimized)
• Initial load time: <100ms
• Encoding/Decoding: <1ms
• Memory usage: <10MB
• Audio latency: <50ms

Development

Build for Release

wasm-pack build --target web --release --out-dir www/pkg

Debug Mode

wasm-pack build --target web --dev --out-dir www/pkg

Run Tests

cargo test

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• International Morse Code standard (ITU-R M.1677-1)
• Rust WebAssembly working group
• Web Audio API specification

Contact

Project Link: https://github.com/chronocoder/morsewave

MorseWave - Bridging the past and future of communication

Built with ❤️ using Rust and WebAssembly