Skip to content

USAGE.md

Latest commit

 

History

History
278 lines (185 loc) · 10.2 KB

USAGE.md

File metadata and controls

278 lines (185 loc) · 10.2 KB
Raw

SBaGenX Logo SBaGenX Usage Guide

This guide will help you get started with SBaGenX, a powerful tool for generating binaural beats and isochronic tones to assist with meditation, relaxation, and altering states of consciousness.

📑 Table of Contents

  1. 🧠 Introduction to Brainwave Entrainment
  2. 💡 Basic Concepts
  3. ⌨️ Command Line Basics
  4. 📝 Creating Simple Sequences
  5. 📚 Example Sequences for Different Purposes
  6. 🎵 Using Background Sounds
  7. 🔍 Advanced Tips

🧠 Introduction to Brainwave Entrainment

Brainwave entrainment is a method to stimulate the brain into entering a specific state by using a pulsing sound, light, or electromagnetic field. The pulses elicit the brain's 'frequency following' response, encouraging the brainwaves to align to the frequency of the given beat.

SBaGenX supports two main types of brainwave entrainment:

  1. Binaural Beats: When two slightly different frequencies are played in each ear, the brain perceives a third "beat" frequency equal to the difference between the two tones. For example, if 200Hz is played in one ear and 210Hz in the other, the brain perceives a 10Hz beat. Binaural beats require headphones to be effective.

  2. Isochronic Tones: These are single tones that are turned on and off at regular intervals. The brain responds to this rhythmic stimulation and begins to resonate with the frequency. Isochronic tones can be effective with or without headphones.

📊 Brainwave Frequency Bands

Different frequency ranges correspond to different mental states:

  • Delta (0.5-4 Hz): Deep sleep, healing, deep meditation
  • Theta (4-8 Hz): Dreaming sleep, meditation, creativity
  • Alpha (8-13 Hz): Relaxed alertness, calm, learning
  • Beta (13-30 Hz): Active thinking, focus, alertness
  • Gamma (30+ Hz): Higher mental activity, peak concentration

💡 Basic Concepts

📝 Understanding the Syntax

SBaGenX uses a specific syntax to define tones:

  • Binaural beats: [carrier frequency]+[beat frequency]/[amplitude]

    • Example: 200+10/20 - A 200Hz carrier with a 10Hz beat at 20% amplitude

  • Isochronic tones: [carrier frequency]@[pulse frequency]/[amplitude]

    • Example: 300@10/20 - A 300Hz carrier pulsing at 10Hz at 20% amplitude

  • Mix: mix/[amplitude]

    • Example: mix/80 - A mix with 80% amplitude (requires a -m [file] option to be specified)

  • Spin: spin:[width]+[frequency]/[amplitude]

    • Example: spin:500+8.0/50 - A spinning effect with 500μs width, rotating at 8Hz with 50% amplitude
    • Note: Uses pink noise as the base sound for a natural, balanced spatial effect

  • Bspin: bspin:[width]+[frequency]/[amplitude]

    • Example: bspin:500+8.0/50 - A spinning effect with 500μs width, rotating at 8Hz with 50% amplitude
    • Note: Uses brown noise as the base sound for a deeper, more bass-heavy spatial effect

  • Wspin: wspin:[width]+[frequency]/[amplitude]

    • Example: wspin:500+8.0/50 - A spinning effect with 500μs width, rotating at 8Hz with 50% amplitude
    • Note: Uses white noise as the base sound for a brighter, more present spatial effect

  • Mixspin: mixspin:[width]+[frequency]/[intensity]

    • Example: mixspin:500+8.0/50 - A spinning effect with 500μs width, rotating at 8Hz with 50% intensity
    • Note: Requires mix/<amplitude> to be specified in the same tone set

  • Mixpulse: mixpulse:[pulse]/[intensity]

    • Example: mixpulse:10/50 - A pulse effect with a rate of 10Hz and 50% intensity
    • Note: Requires mix/<amplitude> to be specified in the same tone set

  • Noise: [type]/[amplitude]

    • Examples: pink/40, white/30, brown/50

Combining Elements

You can combine multiple elements to create complex soundscapes:

pink/40 200+10/20 300@8/15

This combines pink noise at 40% amplitude, a binaural beat with a 200Hz carrier and 10Hz beat at 20% amplitude, and an isochronic tone with a 300Hz carrier pulsing at 8Hz at 15% amplitude.

mix/80 mixspin:500+8.0/50

This creates a spinning effect on the audio input (mix) at 80% amplitude, with the spin rotating at 8Hz and an intensity of 50%.

mix/80 mixpulse:10/50

This creates a pulse effect on the audio input (mix) at 80% amplitude, with the pulse rate of 10Hz and an intensity of 50%.

⌨️ Command Line Basics

Here are some basic commands to get started:

# Play a simple binaural beat in the alpha range (10Hz)
sbagenx -i pink/40 200+10/20

# Play a simple isochronic tone in the theta range (6Hz)
sbagenx -i 300@6/20

# Create a spinning effect with brown noise for deep relaxation
sbagenx -i bspin:300+4/50

# Combine different spin effects for complex spatial experience
sbagenx -i wspin:300+8/40 bspin:300+4/40

# Create a spinning effect on background music
sbagenx -m ambient-music.mp3 -i mix/80 mixspin:500+8.0/50

# Play a sequence file
sbagenx my-sequence.sbg

# Render a sigmoid beat/pulse curve as PNG (no audio playback)
sbagenx -G -p sigmoid t40,10,5 -01ds+:l=0.125:h=0

🔧 Common Options

  • -i [tones]: Play the specified tones immediately
  • -m [file]: Mix with a background sound file (FLAC, MP3, OGG, WAV)
  • -A [spec]: Mix amplitude modulation for -p drop/-p sigmoid (d=<v>:e=<v>:k=<v>:E=<v>, optional)
  • -o [file]: Output to a file instead of playing (.raw by default, or encode with .mp3, .ogg, .flac)
  • -K [kbps]: MP3 bitrate (8-320, default 192)
  • -J [q]: MP3 quality (0-9, lower is better, default 2)
  • -X [q]: MP3 VBR quality (0-9, lower is better; enables VBR mode)
  • -U [q]: OGG Vorbis quality (0-10)
  • -Z [lvl]: FLAC compression level (0-12, still lossless)
  • -L [time]: Limit playback to the specified time (e.g., 0:30 for 30 minutes)
  • -G: With -p sigmoid, render the beat/pulse sigmoid curve as PNG and exit

📝 Creating Simple Sequences

Sequences allow you to program changes in tones over time. Here's how to create a simple sequence file:

  1. Create a text file with a .sbg extension
  2. Define your tone sets
  3. Specify when each tone set should play

Example: Simple Meditation Sequence

## Simple 30-minute meditation sequence

-SE

# Define tone sets
ts-start: pink/40 200+10/15
ts-deep: pink/40 200+6/20
ts-end: pink/40 200+10/15
off: -

# Timeline
00:00:00 off ->
00:00:15 ts-start
00:10:00 ts-start ->
00:15:00 ts-deep
00:20:00 ts-deep ->
00:25:00 ts-end
00:29:00 ts-end ->
00:30:00 off

Save this as meditation.sbg:

For Windows and macOS users, you can run the sequence by double-clicking the file. For Linux users, you can run it from the command line:

sbagenx meditation.sbg

This sequence will:

  1. Start with alpha waves (10Hz) for 10 minutes
  2. Transition to theta waves (6Hz) for 15 minutes
  3. Return to alpha waves (10Hz) for 5 minutes
  4. Turn off after 30 minutes

📚 Example Sequences for Different Purposes

Here are some example sequences for various purposes in the examples/plus directory. You can save these as .sbg files and run them with SBaGenX.

🎵 Using Background Sounds

You can enhance your experience by adding background sounds like nature recordings or ambient music. SBaGenX supports FLAC, MP3, OGG, and WAV files.

Command Line Example

sbagenx -m forest-sounds.mp3 -i pink/20 200+8/15

In Sequence Files

## Meditation with background sounds

-SE
-m river1.ogg

# Define tone sets
ts-start: mix/80 200+10/15
ts-deep: mix/80 200+6/20
ts-end: mix/80 200+10/15
off: -

# Timeline
00:00:00 off ->
00:00:15 ts-start
00:10:00 ts-start ->
00:15:00 ts-deep
00:20:00 ts-deep ->
00:25:00 ts-end
00:29:00 ts-end ->
00:30:00 off

Note the use of mix/80 instead of pink/40. This tells SBaGenX to mix the background sound at 80% amplitude.

🔍 Advanced Tips

🎯 Finding Your Ideal Frequencies

Everyone responds differently to brainwave entrainment. Experiment with different frequencies to find what works best for you:

  • If 10Hz alpha doesn't feel relaxing, try 9Hz or 11Hz
  • If you're not falling asleep with delta frequencies, try adjusting between 1-4Hz
  • Experiment with different carrier frequencies (100-400Hz range)

📊 Considerations about Amplitude

  • Keep binaural beats subtle (10-25% amplitude)
  • Isochronic tones can be slightly louder (15-30% amplitude)
  • Background noise should usually be louder than the tones

⏱️ Session Duration

  • For beginners, start with 15-20 minute sessions
  • Gradually increase to 30-60 minutes as you become more comfortable
  • For sleep aid sequences, 45-90 minutes can help you through the initial sleep cycles

🔄 Creating a Practice

For best results, use brainwave entrainment regularly:

  • Daily practice helps your brain become more responsive
  • Try different sequences for different times of day
  • Keep notes on which frequencies and durations work best for you

Remember that brainwave entrainment is a tool to help you achieve certain mental states, but the experience is ultimately personal. Experiment, adjust, and find what works best for you.

🎉 Conclusion

SBaGenX is a powerful tool for exploring altered states of consciousness, enhancing meditation, improving focus, and aiding relaxation. This guide covers the basics to get you started, but there's much more to explore. As you become more familiar with the program, you can create increasingly sophisticated sequences tailored to your specific needs.

For more technical details, see the SBaGenX Manual.

And for the scientific background behind SBaGenX, check out RESEARCH.md.

Happy exploring!