Binaural Dreamscapes

An interactive tool for creating and visualising binaural audio waves for meditation and astral travel.

Description

Binaural Dreamscapes is a powerful and intuitive application designed for crafting binaural audio experiences tailored for meditation and astral travel. This interactive tool allows users to adjust and visualise dual sine wave frequencies and phases in real-time, offering a seamless way to create immersive soundscapes. With its user-friendly interface, you can manipulate audio parameters and observe their effects on dynamic waveforms, making it an ideal companion for exploring altered states of consciousness and enhancing your meditative practice.

Features

Real-time adjustment of left and right audio frequencies (1-20000 Hz)
Phase control for left and right channels (0-360 degrees)
Volume control (0-100%)
Live waveform visualisation
Start/Stop audio playback
Update all parameters simultaneously
Save and load custom configurations
About and Help dialogs

Application Workflow

graph TD
    A[Start Application] --> B[Initialise GUI]
    B --> C[Set Initial Parameters]
    C --> D{User Input}
    D -->|Adjust Frequency| E[Update Frequency]
    D -->|Adjust Phase| F[Update Phase]
    D -->|Adjust Volume| G[Update Volume]
    D -->|Start Audio| H[Generate Audio]
    D -->|Stop Audio| I[Stop Audio Stream]
    D -->|Save Config| J[Save to Database]
    D -->|Load Config| K[Load from Database]
    E --> L[Update Waveform Visualisation]
    F --> L
    G --> L
    H --> L
    K --> C
    L --> D

Application Structure

classDiagram
    class BinauralDreamscapes {
        +frequency_left: float
        +frequency_right: float
        +phase_left: float
        +phase_right: float
        +volume: float
        +start_stream()
        +stop_stream()
        +update_frequency_left()
        +update_frequency_right()
        +update_phase_left()
        +update_phase_right()
        +update_volume()
        +plot_waveforms()
        +save_configuration()
        +load_configuration()
    }
    class GUI {
        +create_widgets()
        +update_ui_values()
    }
    class AudioEngine {
        +sampling_rate: int
        +audio_callback()
    }
    class DatabaseManager {
        +save_config()
        +load_config()
    }
    BinauralDreamscapes --> GUI
    BinauralDreamscapes --> AudioEngine
    BinauralDreamscapes --> DatabaseManager

Installation

Ensure you have Python 3.7 or later installed on your system.
Clone this repository or download the source code.
Navigate to the project directory in your terminal.
Install the required dependencies by running:
```
pip install -r requirements.txt
```

Usage

Launch the application by running:
```
python app.py
```
Adjust the frequencies and phases using the sliders or text inputs
Set the desired volume using the volume slider
Click "Start" to begin audio playback
Observe the live waveform visualisation
Click "Stop" to end audio playback
Use the File menu to save or load configurations

TODO

Contributing

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

CaptainCodeAU/Binaural-Dreamscapes