Skip to content

dmeldrum6/Numbers-Station

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

Numbers Station - Cold War Interactive Experience

A browser-based recreation of Cold War era "numbers stations" - mysterious shortwave radio broadcasts that transmitted coded messages through sequences of spoken numbers. This interactive web application captures the authentic atmosphere of these enigmatic transmissions with realistic signal analysis, vintage terminal aesthetics, and multilingual voice synthesis.

image

🎯 Features

Authentic Cold War Atmosphere

  • Vintage CRT Terminal: Green monospace text with scanlines and static overlay
  • Classified Document Styling: "TOP SECRET" classification and military-style interface
  • Period-Appropriate Design: Retro color schemes and typography reminiscent of 1960s-80s equipment

Realistic Radio Interface

  • Live Waveform Analysis: Animated signal visualization with interference patterns
  • Signal Strength Monitoring: Dynamic strength bars with realistic fluctuations
  • Frequency Display: Shows transmission frequency with subtle variations (4625.0 kHz base)
  • Spectrum Analyzer: Real-time frequency spectrum display

Intelligent Voice Synthesis

  • Multilingual Broadcasts: Random selection from English (US), Spanish (Mexico), and Russian
  • Authentic Speech Patterns: Variable rate and pitch to simulate different operators
  • Error Handling: Graceful fallbacks for speech synthesis issues

Interactive Transmission Control

  • Real-time Statistics: Track transmission time, number count, and error rates
  • Message History: Scrollable log of all transmitted numbers with timestamps
  • Dynamic Messaging: Auto-generated message IDs and priority levels
  • Countdown Timer: Shows time until next number transmission

Responsive Design

  • Mobile Optimized: Adaptive layouts for all screen sizes
  • Cross-Platform: Works on desktop, tablet, and mobile browsers
  • Orientation Support: Handles device rotation gracefully

🚀 Getting Started

Prerequisites

  • Modern web browser with Web Audio API and Speech Synthesis support
  • No server required - runs entirely in the browser

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/numbers-station.git
  2. Open numbers-station.html in your web browser

  3. Click "INITIATE TRANSMISSION" to begin the experience

Usage

  • Start/Stop: Use the main button to control transmission state
  • Visual Feedback: Monitor signal strength, waveforms, and spectrum analysis
  • Audio Experience: Listen to the spoken number sequences (ensure audio is enabled)
  • History Tracking: Review past transmissions in the scrollable history panel

🎨 Technical Implementation

Frontend Technologies

  • HTML5: Semantic structure and responsive design
  • CSS3: Advanced animations, gradients, and visual effects
  • JavaScript: Real-time audio/visual processing and state management

Key Components

  • Canvas API: Custom waveform and signal visualization
  • Web Speech API: Multi-language voice synthesis
  • Web Audio API: Background static and audio processing
  • CSS Animations: Smooth transitions and retro CRT effects

Browser Compatibility

  • Chrome 33+ ✅
  • Firefox 49+ ✅
  • Safari 14.1+ ✅
  • Edge 79+ ✅

🔧 Customization

Modify Transmission Parameters

// Adjust number generation frequency (line ~340)
const pauseDuration = Math.random() * 3000 + 2000; // 2-5 seconds

// Change base frequency (line ~180)
const baseFreq = 4625.0; // kHz

// Add new languages (line ~300)
const allowedLangs = ['en-US', 'es-MX', 'ru-RU', 'de-DE'];

Styling Modifications

  • Colors: Modify CSS variables for different terminal themes
  • Typography: Change font families in the CSS @import section
  • Layout: Adjust grid proportions in .main-display class

📚 Historical Context

Numbers stations were real shortwave radio stations that broadcast coded messages during the Cold War era. They typically featured:

  • Repeating number sequences in various languages
  • Distinctive interval signals or musical introductions
  • Consistent broadcast schedules and frequencies
  • Unknown origins and purposes (widely believed to be espionage-related)

Famous examples include:

  • UVB-76 "The Buzzer" (Russia) - Still active today
  • Lincolnshire Poacher (UK) - Used Lincolnshire Poacher folk tune
  • Atención (Cuba) - Spanish language station
  • Gongs (China) - Featured gong sounds between transmissions

📄 License

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

🙏 Acknowledgments

  • Inspired by real Cold War numbers stations and radio enthusiasts
  • Thanks to the shortwave radio community for preserving this history
  • Built with respect for the mysterious operators of these stations

🔗 Related Projects


"This station is operated by automated equipment. Please stand by for message traffic..."

About

A browser-based recreation of Cold War era "numbers stations" - mysterious shortwave radio broadcasts that transmitted coded messages through sequences of spoken numbers.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages