neom_generator
Neom Generator - Frequency Generation and Binaural Beat Engine for Open Neom.
neom_generator is a core module within the Open Neom ecosystem, dedicated to the generation and manipulation of frequencies and audio patterns. It provides the foundational tools for creating personalized sound experiences, enabling users to interact with the "Neom Chamber" for guided meditation, conscious well-being, and biofeedback applications.
This module is designed for mobile app integration with a future vision for wearables and IoT devices, aligning with the broader Tecnozenism philosophy of integrating technology and human consciousness.
Features & Responsibilities
Frequency Generation
- Core logic for generating specific audio frequencies
- Binaural beat synthesis with configurable differential
- Isochronic tone generation
- Real-time parameter modulation
Audio Visualization
- Oscilloscope View: Real-time waveform display
- Lissajous Patterns: Phase relationship visualization
- Flocking Animation: Particle-based visual feedback
- Breathing Guide: Animated breath synchronization
Neom Chamber Management
- Create and manage frequency preset collections
- Privacy options (public/private chambers)
- Binaural configuration presets
- Session recording and export
Control Panels
- Spatial Control: 3D audio positioning (X, Y, Z axes)
- Breath Control: Breathing rate synchronization
- Neuro State Control: EEG band targeting (Delta, Theta, Alpha, Beta, Gamma)
- Modulation Control: Amplitude and frequency modulation
- Visual Mode Control: Scientific vs artistic display modes
Voice Frequency Detection
- Microphone input analysis
- Real-time pitch detection
- Biofeedback visualization
Architecture
lib/
├── engine/
│ ├── neom_audio_engine.dart
│ ├── neom_frequency_painter_engine.dart
│ └── neom_sine_engine.dart
├── ui/
│ ├── neom_generator_controller.dart
│ ├── neom_generator_page.dart
│ ├── breathing/
│ │ └── neom_breathing_fullscreen_page.dart
│ ├── chamber/
│ │ ├── chamber_controller.dart
│ │ └── chamber_page.dart
│ ├── flocking/
│ │ └── neom_flocking_fullscreen_page.dart
│ ├── oscilloscope/
│ │ ├── neom_oscilloscope_fullscreen_page.dart
│ │ └── neom_oscilloscope_fullscreen_painter.dart
│ ├── painters/
│ │ ├── frequency_painter.dart
│ │ ├── lissajous_painter.dart
│ │ ├── neom_binaural_beat_painter.dart
│ │ ├── neom_breathing_painter.dart
│ │ ├── neom_flocking_painter.dart
│ │ └── oscilloscope_painter.dart
│ ├── panels/
│ │ ├── neom_breath_control_panel.dart
│ │ ├── neom_modulation_control_panel.dart
│ │ ├── neom_neuro_state_control_panel.dart
│ │ ├── neom_spatial_control_panel.dart
│ │ └── neom_visual_mode_control_panel.dart
│ └── widgets/
│ ├── generator_widgets.dart
│ └── session_time_meter.dart
├── utils/
│ ├── constants/
│ │ ├── generator_translation_constants.dart
│ │ ├── neom_generator_constants.dart
│ │ └── neom_slider_constants.dart
│ └── enums/
│ ├── eeg_band.dart
│ ├── neom_frequency_target.dart
│ └── neom_numeric_target.dart
└── neom_generator.dart
Dependencies
dependencies:
neom_core: ^2.0.0 # Core services and models
neom_commons: ^2.0.0 # Shared UI components
sint: ^1.0.0 # State management (SINT framework)
flutter_soloud: ^3.1.6 # High-performance audio engine
sleek_circular_slider: ^2.0.1 # Custom circular sliders
font_awesome_flutter: ^10.8.0 # Icon set
Usage
Launching the Generator Page
import 'package:neom_generator/ui/neom_generator_page.dart';
// Navigate to generator
Sint.toNamed(AppRouteConstants.generator);
// Or embed directly
NeomGeneratorPage(showAppBar: true)
Using the Generator Controller
import 'package:neom_generator/ui/neom_generator_controller.dart';
final controller = Sint.find<NeomGeneratorController>();
// Set frequency
controller.setFrequency(432.0);
// Set binaural beat differential
controller.setBinauralBeat(10.0); // 10 Hz for Alpha state
// Play/Stop
controller.playStopPreview();
Creating a Chamber Preset
import 'package:neom_generator/ui/chamber/chamber_controller.dart';
final chamberController = Sint.find<ChamberController>();
// Create new chamber
await chamberController.createChamber(
name: "Morning Meditation",
baseFrequency: 432.0,
binauralBeat: 7.83, // Schumann resonance
isPublic: false,
);
EEG Bands and Frequencies
| Band | Frequency | State |
|---|---|---|
| Delta | 0.5 - 4 Hz | Deep sleep, healing |
| Theta | 4 - 8 Hz | Meditation, creativity |
| Alpha | 8 - 12 Hz | Relaxation, calm focus |
| Beta | 12 - 30 Hz | Alert, active thinking |
| Gamma | 30+ Hz | Peak performance, insight |
ROADMAP 2026
Q1 2026 - Advanced Audio Engine
Q2 2026 - Biofeedback Integration
Q3 2026 - Session Management
Q4 2026 - Social Features
State Management
neom_generator uses the SINT framework (GetX replacement) for:
- Reactive audio parameter binding
- Real-time visual state updates
- Controller lifecycle management
- Route-based dependency injection
Contributing
We welcome contributions! If you're interested in audio processing, visualization, or meditation technology, your help can enhance the Neom Generator experience.
License
This project is licensed under the Apache License, Version 2.0, January 2004. See the LICENSE file for details.
Libraries
- data/firestore/chamber_firestore
- data/implementations/harmonic/harmonic_footprint_controller
- data/implementations/harmonic/resonance_bridge
- data/implementations/incienso_recorder
- data/implementations/incienso_session_reporter
- data/implementations/incienso_tracker
- data/incienso_catalog
- data/translations/generator_de_translations
- data/translations/generator_en_translations
- data/translations/generator_es_translations
- data/translations/generator_fr_translations
- domain/models/harmonic/footprint_snapshot
- domain/models/harmonic/group_resonance
- domain/models/harmonic/harmonic_capture
- domain/models/harmonic/harmonic_compatibility
- domain/models/harmonic/harmonic_footprint
- domain/models/harmonic/sonic_avatar
- domain/models/harmonic/vocal_emotional_state
- domain/models/harmonic/vocal_range
- domain/models/incienso
- domain/models/incienso_review
- domain/models/incienso_session
- domain/use_cases/audio_generator_service
- domain/use_cases/chamber_preset_service
- domain/use_cases/harmonic_footprint_service
- domain/use_cases/neom_analyzer_service
- domain/use_cases/neom_generator_service
- engine/neom_breath_engine
- engine/neom_breathing_engine
- engine/neom_flocking_engine
- engine/neom_fractal_engine
- engine/neom_frequency_painter_engine
- engine/neom_isochronic_engine
- engine/neom_modulator_engine
- engine/neom_neuro_state_engine
- engine/neom_sine_engine
- engine/web_audio_context_impl
- engine/web_audio_context_stub
- generator_routes
- ui/breathing/neom_breathing_controller
- ui/breathing/neom_breathing_fullscreen_page
- ui/chamber/chamber_controller
- ui/chamber/chamber_page
- ui/chamber/chamber_preset_controller
- ui/chamber/chamber_presets_page
- ui/experiences/neom_experiences_page
- ui/flocking/neom_flocking_controller
- ui/flocking/neom_flocking_fullscreen_page
- ui/fractal/neom_fractal_controller
- ui/fractal/neom_fractal_fullscreen_page
- ui/harmonic/footprint_timeline_widget
- ui/harmonic/harmonic_footprint_painter
- ui/harmonic/harmonic_footprint_widget
- ui/incienso/incienso_detail_sheet
- ui/miniplayer/mini_neom_player
- ui/neom_generator_controller
- ui/neom_generator_page
- ui/oscilloscope/neom_oscilloscope_controller
- ui/oscilloscope/neom_oscilloscope_fullscreen_page
- ui/oscilloscope/neom_oscilloscope_fullscreen_painter
- ui/painters/circuit_wave_painter
- ui/painters/frequency_painter
- ui/painters/lissajous_3d_painter
- ui/painters/lissajous_painter
- ui/painters/mic_waveform_painter
- ui/painters/neom_binaural_beat_painter
- ui/painters/neom_breathing_painter
- ui/painters/neom_flocking_painter
- ui/painters/neom_fractal_painter
- ui/painters/oscilloscope_painter
- ui/painters/perimeter_wave_painter
- ui/panels/neom_breath_control_panel
- ui/panels/neom_modulation_control_panel
- ui/panels/neom_neuro_state_control_panel
- ui/panels/neom_spatial_control_panel
- ui/panels/neom_visual_mode_control_panel
- ui/web/neom_generator_web_page
- ui/widgets/camara_neom_tutorial
- ui/widgets/generator_widgets
- ui/widgets/incienso_review_modal
- ui/widgets/mic_monitor_widget
- ui/widgets/session_time_meter
- utils/constants/generator_translation_constants
- utils/constants/neom_chamber_preset_pack
- utils/constants/neom_generator_constants
- utils/constants/neom_slider_constants
- utils/enums/eeg_band
- utils/enums/neom_frequency_target
- utils/enums/neom_neuro_state
- utils/enums/neom_numeric_target
- utils/enums/neom_spatial_mode
- utils/enums/neom_visual_mode