Skip to content

Repository files navigation

Schumann Audio Generator

Python Version License

A professional-grade audio generator producing the Earth's Schumann resonance frequency (7.83 Hz) using multiple scientifically-backed methods for meditation, relaxation, and brainwave entrainment.

🌍 What is the Schumann Resonance?

The Schumann resonances are a set of spectrum peaks in the extremely low frequency (ELF) portion of the Earth's electromagnetic field spectrum. The fundamental frequency is approximately 7.83 Hz, often called the "Earth's heartbeat." This frequency naturally occurs in the cavity between the Earth's surface and the ionosphere, created by lightning discharges around the globe.

🎧 Generation Methods

This generator supports four different methods to produce the 7.83 Hz Schumann resonance:

1. 🎯 Binaural Beats (Classic Method)

Two slightly different frequencies presented separately to each ear create an auditory illusion where your brain perceives the difference frequency.

  • How it works: Left ear (136.10 Hz) + Right ear (143.93 Hz) = Perceived 7.83 Hz beat
  • Requires: Headphones or earbuds
  • Best for: Traditional brainwave entrainment, most researched method
  • Character: Subtle, requires focused listening

2. 🌊 Amplitude Modulation (Recommended)

A carrier frequency is modulated at 7.83 Hz, creating a rhythmic volume oscillation.

  • How it works: Carrier wave amplitude oscillates at 7.83 Hz
  • Requires: Any audio system (speakers or headphones)
  • Best for: General use, natural listening experience
  • Character: Smooth, wave-like pulsations

3. πŸ’« Isochronic Tones (Most Noticeable)

Distinct audio pulses turning on and off at 7.83 Hz.

  • How it works: Tone pulses 7.83 times per second
  • Requires: Any audio system (speakers or headphones)
  • Best for: Active focus sessions, pronounced effect
  • Character: Rhythmic, clearly perceptible beats

4. πŸ”Š Subharmonic (Experimental)

Pure 7.83 Hz tone with audible harmonics.

  • How it works: Direct generation of 7.83 Hz with harmonic overtones
  • Requires: High-quality sound system with subwoofer
  • Best for: Specialized audio setups, experimentation
  • Character: Deep, resonant vibrations

✨ Features

  • Four generation methods: Choose the approach that works best for you
  • Ultra-high quality audio: 96 kHz sample rate, 24-bit depth
  • Maximum frequency precision: float64 calculations for exact Schumann resonance
  • Smooth fade in/out: Cosine curve transitions to prevent audio clicks
  • Safe listening levels: Pre-configured comfortable amplitude
  • Batch generation: Create all four methods at once for comparison
  • Studio-grade output: Professional WAV format compatible with all audio software

πŸ“‹ Requirements

  • Python 3.12 or higher
  • NumPy
  • SciPy

πŸš€ Installation

  1. Clone the repository:
git clone https://github.com/tboy1337/Schumann-Audio-Generator.git
cd Schumann-Audio-Generator
  1. Create a virtual environment (recommended):
python -m venv venv

# On Windows:
venv\Scripts\activate

# On macOS/Linux:
source venv/bin/activate
  1. Install dependencies:
pip install -r requirements.txt

🎡 Usage

Quick Start - CLI (Recommended)

Install the package and generate audio from the command line:

pip install -e .

# Generate all four methods (60-second default, saved to output/)
schumann-generate

# Generate a single 30-minute AM file at studio quality
schumann-generate --method am --duration 1800 --output-dir output

Python API

from schumann_audio_generator import generate_schumann_resonance, save_audio

audio_data = generate_schumann_resonance(
    method='am',
    duration=1800,
    sample_rate=96000,
    amplitude=0.25,
    fade_duration=3.0,
)

save_audio('output/schumann_am_96kHz_24bit.wav', audio_data, 96000, bit_depth=24)

Generate Single Method via CLI

schumann-generate --method am --duration 1800 --output-dir output

Customization Options

Edit parameters in the generate_schumann_resonance() function:

audio_data = generate_schumann_resonance(
    method='am',           # Generation method
    duration=1800,         # Duration in seconds (30 minutes)
    sample_rate=96000,     # Sample rate (44100, 48000, 96000, 192000)
    amplitude=0.25,        # Volume (0.1-0.5 recommended)
    fade_duration=3.0      # Fade in/out time in seconds
)

πŸŽ›οΈ Method Comparison

Method Headphones? Speakers? Subtlety Effectiveness Research
Binaural βœ… Required ❌ No Very subtle Well-studied Extensive
AM βœ… Yes βœ… Yes Moderate Proven Moderate
Isochronic βœ… Yes βœ… Yes Obvious Well-studied Extensive
Subharmonic βœ… Yes βœ… Yes* Variable Experimental Limited

*Requires quality bass reproduction

🎯 Which Method Should You Use?

Use Binaural Beats if:

  • You have quality headphones
  • You want the most researched approach
  • You prefer subtle, background entrainment
  • You're familiar with binaural beat meditation

Use Amplitude Modulation if:

  • You want to use speakers or headphones
  • You prefer a natural, wave-like sound
  • You want versatility in playback options
  • This is your first time trying Schumann resonance audio

Use Isochronic Tones if:

  • You want a clearly noticeable rhythm
  • You're using speakers (no headphones needed)
  • You prefer active, rhythmic entrainment
  • You want the most pronounced effect

Use Subharmonic if:

  • You have a high-quality audio system with subwoofer
  • You want to experiment with direct low-frequency stimulation
  • You're interested in exploring different approaches
  • You have experience with sub-bass frequencies

πŸ“Š Technical Specifications

Parameter Value Description
Schumann Frequency 7.83 Hz Earth's fundamental resonance
Carrier Frequency 136.10 Hz Om/Ohm frequency (C#)
Sample Rate 96 kHz Studio-quality audio
Bit Depth 24-bit Maximum dynamic range
Precision float64 Exact frequency calculation
Fade Duration 3 seconds Smooth cosine curve
Output Format WAV Uncompressed, lossless
File Size ~622 MB Per 30-minute file

πŸ§ͺ Output Files

Running the default script generates four files:

schumann_binaural_96kHz_24bit.wav
β”œβ”€β”€ Method: Binaural beats
β”œβ”€β”€ Channels: Stereo (L: 136.10 Hz, R: 143.93 Hz)
└── Best with: Headphones

schumann_am_96kHz_24bit.wav
β”œβ”€β”€ Method: Amplitude modulation
β”œβ”€β”€ Channels: Stereo (identical, 7.83 Hz envelope)
└── Best with: Speakers or headphones

schumann_isochronic_96kHz_24bit.wav
β”œβ”€β”€ Method: Isochronic tones
β”œβ”€β”€ Channels: Stereo (identical, 7.83 Hz pulses)
└── Best with: Speakers or headphones

schumann_subharmonic_96kHz_24bit.wav
β”œβ”€β”€ Method: Subharmonic generation
β”œβ”€β”€ Channels: Stereo (7.83 Hz + harmonics)
└── Best with: Subwoofer system

πŸ”¬ Science Behind the Methods

Binaural Beats

When two tones with slightly different frequencies are presented separately to each ear, the brain creates a perceived "beat" at the difference frequency. This phenomenon, discovered by Heinrich Wilhelm Dove in 1839, is thought to influence brainwave patterns through a process called frequency following response (FFR).

Amplitude Modulation

Modulating a carrier wave's amplitude at 7.83 Hz creates a rhythmic volume change that the brain can track. This is similar to how we perceive tremolo in music and can induce similar entrainment effects without requiring stereo separation.

Isochronic Tones

Distinct pulses of sound at regular intervals (7.83 times per second) create a clear rhythmic stimulus. Unlike binaural beats, isochronic tones work through a single channel and are thought to be more effective for some individuals due to their pronounced nature.

Subharmonic Generation

Producing the actual 7.83 Hz frequency with harmonic overtones attempts to directly stimulate the nervous system through bone conduction and tactile sensation, though human hearing can't detect frequencies below ~20 Hz.

Theta Range (4-8 Hz)

The Schumann resonance at 7.83 Hz falls within the theta brainwave range, associated with:

  • Deep relaxation and meditation
  • Enhanced creativity and intuition
  • Improved focus and concentration
  • Reduced stress and anxiety
  • Better sleep quality
  • Increased mind-body connection
  • Access to subconscious patterns

Note: While many users report positive effects, scientific studies on brainwave entrainment show mixed results. Effects can be subjective and vary by individual. Always approach with realistic expectations.

🎯 Best Practices

For Optimal Results:

  1. Try all methods - Everyone responds differently to entrainment techniques
  2. Use quality audio equipment - Clear reproduction improves effectiveness
  3. Listen at comfortable volume - 30-50% volume is recommended
  4. Find a quiet environment - Minimize distractions for best results
  5. Be patient - Effects may take 5-15 minutes to notice
  6. Use during appropriate activities - Meditation, focus work, relaxation
  7. Stay hydrated - Some users report enhanced effects when well-hydrated
  8. Start with shorter sessions - Begin with 10-15 minutes

Safety Notes:

  • ⚠️ Not recommended for people with epilepsy or seizure disorders
  • ⚠️ Consult a doctor if you have any neurological conditions
  • ⚠️ Do not use while operating machinery or driving
  • ⚠️ Start with lower volumes and shorter durations
  • ⚠️ Discontinue use if you experience discomfort or dizziness
  • ⚠️ Pregnant women should consult a healthcare provider first

Method-Specific Tips:

Binaural:

  • Must use headphones (left/right separation required)
  • Keep volume moderate - should feel like background sound
  • Best for meditation and sleep preparation

Amplitude Modulation:

  • Works with any audio system
  • Can be used as background during work or study
  • Most versatile for daily use

Isochronic:

  • More noticeable than other methods - can be distracting
  • Good for active focus sessions
  • Try shorter durations first (10-20 minutes)

Subharmonic:

  • Test your system's bass capabilities first
  • May cause physical vibrations - this is normal
  • Best used with eyes closed in a relaxed position

πŸ“ Project Structure

Schumann-Audio-Generator/
β”œβ”€β”€ schumann_audio_generator/   # Main package
β”‚   β”œβ”€β”€ constants.py            # Frequencies and method definitions
β”‚   β”œβ”€β”€ validation.py           # Input validation
β”‚   β”œβ”€β”€ synthesis.py            # Audio generation
β”‚   β”œβ”€β”€ audio_io.py             # WAV export (16/24-bit)
β”‚   └── cli.py                  # Command-line interface
β”œβ”€β”€ scripts/verify.py           # Local dev verification pipeline
β”œβ”€β”€ tests/                      # Test suite (>90% coverage)
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ requirements-dev.txt
β”œβ”€β”€ pyproject.toml
β”œβ”€β”€ README.md
└── LICENSE

πŸ› οΈ Advanced Customization

Carrier Frequency Options

Different carrier frequencies create different tonal qualities:

# In schumann_audio_generator/constants.py, modify CARRIER_FREQ:

CARRIER_FREQ = 136.10  # Om/Ohm (C#) - Spiritual, grounding (default)
CARRIER_FREQ = 174     # Solfeggio - Pain relief, security
CARRIER_FREQ = 200     # Balanced - Neutral, comfortable
CARRIER_FREQ = 285     # Solfeggio - Healing, regeneration
CARRIER_FREQ = 396     # Solfeggio - Liberation from fear
CARRIER_FREQ = 432     # A tuning - Natural, harmonious

Duration Presets

duration = 600      # 10 minutes - Quick session
duration = 1200     # 20 minutes - Standard meditation
duration = 1800     # 30 minutes - Deep meditation (default)
duration = 3600     # 60 minutes - Extended focus or sleep prep
duration = 7200     # 2 hours - Sleep through the night

Quality Settings

# Ultra-high quality (large files)
sample_rate = 192000
bit_depth = 24

# High quality (recommended)
sample_rate = 96000
bit_depth = 24

# Standard quality (smaller files)
sample_rate = 48000
bit_depth = 16

# Minimal quality (very small files)
sample_rate = 44100
bit_depth = 16

πŸ”§ Troubleshooting

Files are too large

Solution 1 - Reduce sample rate:

sample_rate = 48000  # Instead of 96000

Solution 2 - Reduce bit depth:

bit_depth = 16  # Instead of 24

Solution 3 - Shorten duration:

duration = 600  # 10 minutes instead of 30

Can't hear the effect

Binaural method:

  • Ensure you're using headphones
  • Check that left/right channels aren't reversed
  • Try increasing volume slightly

AM/Isochronic methods:

  • Try the isochronic method (most noticeable)
  • Increase modulation depth in the code
  • Listen in a quiet environment

Subharmonic method:

  • Verify your system can reproduce low frequencies
  • Try using headphones instead of speakers
  • Increase the amplitude of harmonics in the code

Audio sounds distorted

  • Reduce amplitude (try 0.15-0.20 instead of 0.25)
  • Check your audio system isn't adding its own effects/EQ
  • Ensure files aren't being resampled by your player

Python errors

"Module not found" error:

pip install -r requirements.txt

"Permission denied" error:

  • Run terminal/command prompt as administrator
  • Check folder write permissions
  • Try saving to a different location

πŸ“š Further Reading & Resources

Scientific Research

Educational Resources

Tools & Applications

Development

Install dev dependencies and run the full local verification pipeline:

pip install -e ".[dev]"
py scripts/verify.py          # full local gate
py scripts/verify.py --install  # install + verify

🀝 Contributing

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

Ideas for Contributions:

  • Add GUI interface for parameter selection
  • Implement visualization of waveforms and frequency spectrum
  • Add multiple Schumann harmonics (7.83, 14.3, 20.8, 27.3 Hz)
  • Create presets for different use cases (sleep, focus, meditation)
  • Add other brainwave frequencies (alpha, beta, delta, gamma)
  • Implement batch generation with different carrier frequencies
  • Add MP3/OGG export options
  • Create mobile app version
  • Add real-time generation and playback
  • Implement audio analysis tools
  • Add pink/brown noise background options
  • Create nature sound overlays

How to Contribute:

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

πŸ“œ License

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

πŸ™ Acknowledgments

  • Heinrich Wilhelm Dove - Discovery of binaural beats (1839)
  • Winfried Otto Schumann - Discovery of Schumann resonances (1952)
  • Dr. Gerald Oster - Modern binaural beat research (1973)
  • The Python scientific computing community (NumPy, SciPy)
  • All researchers studying brainwave entrainment and sound therapy

⭐ Support

If you find this project helpful, please consider:

  • ⭐ Starring the repository on GitHub
  • πŸ› Reporting bugs or issues
  • πŸ’‘ Suggesting new features
  • πŸ“– Improving documentation
  • πŸ”— Sharing with others who might benefit

πŸ“ž Contact & Feedback

Have questions or feedback? Feel free to:

  • Open an issue on GitHub
  • Submit a pull request
  • Share your experience using the generator

Made with 🎡 for meditation, focus, and connection to Earth's natural frequency

"In every walk with nature, one receives far more than he seeks." - John Muir

About

A professional-grade audio generator producing the Earth's Schumann resonance frequency (7.83 Hz) using multiple scientifically-backed methods for meditation, relaxation, and brainwave entrainment

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages