Hosi Variator - REAPER ReaScript User Guide

📖 Overview

Hosi Variator is a ReaScript using ReaImGui to create a modern interface that allows randomization of multiple media item properties in REAPER with precise control and preset management system.

✅ Requirements & Installation

• REAPER DAW with Lua scripting enabled
• ReaImGui extension (install via ReaPack)
• Copy Hosi_Variator_v1.1.lua to Scripts folder
• Load from Actions → Load ReaScript

---

🎯 Usage Instructions

Step 1: Preparation

1. Select media items on track
2. Place edit cursor at center point (reference position)
3. Run script 

Step 2: Configure Parameters

5-Column Interface:

• Parameters: Enable/disable checkbox
• Amount (0-100%): Randomization intensity
• Bias (-100/+100): Randomization direction
• Curve: Distribution type (Linear/Bell Curve/Exponential)
• Rand: Quick randomize individual parameter

---

⚙️ Parameter Details

Parameter	Range/Unit	Description	Notes
Position	±2 seconds	Horizontal position from cursor	Creates stereo width
Volume	±12 dB	Audio level	>6dB = significant difference
Pan	-1 to +1	Stereo panning	100% = full stereo field
Pitch	±12 semitones	Pitch shift	>5 semitones = major change
Rate	0.5x to 1.5x	Playback speed	Affects item length
Fade In/Out Length	0-0.1 seconds	Fade duration	Creates smooth texture
Fade Shapes	0-6 index	Fade curve shape	7 different shapes

Curve Types:

• Linear: Even distribution
• Bell Curve: Center-focused (natural sounding)
• Exponential: Low-value biased (dramatic effects)

Bias System:

• 0: Balanced/neutral
• Positive (+): Bias toward higher values
• Negative (-): Bias toward lower values

---

🎵 Effective Usage Tips

🌿 Natural Sound (Organic)

Goal: Subtle variation without breaking musical structure

• Position: 30-50% | Volume: 20-40%
• Pan: 50-70% | Pitch: 10-30%
• Rate: 10-20% | Curve: Bell Curve
• Bias: 0 | Applications: Acoustic instruments, vocals

🎭 Dramatic Effects (Cinematic)

Goal: Strong contrast, impactful results

• Position: 80-100% | Volume: 70-100%
• Pan: 100% | Pitch: 50-100%
• Rate: 40-80% | Curve: Exponential
• Bias: ±30-50 | Applications: Sound FX, impacts, risers

🌊 Ambient/Texture (Atmospheric)

Goal: Soft background layer, wide spatial feel

• Enable all Fade parameters
• Volume: 60-80% | Position: 40-60%
• Pitch: 20-40% | Pan: 80-100%
• Rate: 20-40% | Curve: Bell Curve
• Applications: Pads, atmospheres, textures

🥁 Drums/Percussion

Goal: Natural groove, humanization

• Position: 20-40% (micro-timing)
• Volume: 30-60% (dynamics)
• Pan: 40-80% (kit spread)
• Pitch: 15-35% (tuning variation)
• Rate: 5-15% | Bias: -10 to +10

🎸 Melodic Instruments

Goal: Humanize performance, add expression

• Position: 10-30% | Volume: 25-50%
• Pan: 30-60% | Pitch: 5-20%
• Rate: 5-20% | Curve: Bell Curve

🎤 Vocal Samples

Goal: Choir effects, crowd simulation

• Position: 50-80% | Volume: 40-70%
• Pan: 70-100% | Pitch: 30-60%
• Rate: 10-30%

---

💾 Preset Management

Save Presets:

1. Save Preset → Enter name → Save
2. Auto-saved to: [REAPER Resource]/Hosi_Variator_Presets.lua

Manage Presets:

• Filter: Search by name
• Load: Apply selected preset
• Rename: Change preset name
• Delete: Remove preset

Preset Strategy:

• "Subtle": 20-40% across parameters
• "Medium": 40-70% across parameters
• "Extreme": 70-100% across parameters
• "Genre-Specific": Drums, Ambient, Cinematic, etc.

---

🎮 Special Features

Shortcuts & Controls:

• Spacebar: Play/Stop + reset cursor to initial position
• Right-click sliders: Reset to 0
• "R" buttons: Randomize individual parameters

Utility Buttons:

• Randomize: Random all Amount values
• Reset: Return to default settings
• Mutate: Execute randomization
• Donate: PayPal support link
• User Guide: Online documentation

Auto Features:

• Free Item Positioning: Automatically enabled
• Vertical randomization: Automatic (not in GUI)
• Undo support: Ctrl+Z to revert
• Real-time preview: Instant feedback

---

🚀 Advanced Workflow Tips

Layer Technique:

1. Base Layer: Subtle (20-40%)
2. Accent Layer: Medium (50-70%)
3. Effect Layer: Extreme (80-100%)

Safety Practices:

• Backup projects before use
• Start small with low Amount values
• Test with 1 item before batch processing
• Save working presets regularly

Genre Applications:

• Electronic: Linear curves, high Position/Pan
• Orchestral: Bell curves, moderate settings
• Hip-Hop: Focus on Drums preset, micro-timing
• Ambient: Full fade parameters, wide stereo
• Rock/Pop: Balanced approach, musical intervals

Professional Techniques:

• Layered Randomization: Apply different presets to different layers
• Reference Mixing: Keep one item untouched as reference
• Gradual Processing: Build complexity incrementally
• Genre Templates: Create specific presets for each music style

---

⚠️ Important Notes

• Script uses initial cursor position as reference point
• Rate changes affect item length automatically
• Extreme values may produce unexpected results
• Console output can be disabled via ENABLE_CONSOLE_OUTPUT = false
• Free Item Positioning is automatically enabled on target tracks
• Vertical position is randomized automatically (hardcoded)

---

🎯 Best Practices Summary

For Beginners:

1. Start with Subtle preset (20-40% values)
2. Focus on 2-3 parameters initially
3. Use Bell Curve for natural results
4. Save successful configurations as presets

For Advanced Users:

1. Combine multiple curve types for complex results
2. Use bias strategically to guide randomization
3. Create genre-specific preset libraries
4. Experiment with extreme settings for creative effects

Performance Optimization:

• Process items in small batches for large projects
• Disable unused parameters to improve performance
• Use reference tracks to maintain musical context
• Test settings on duplicate tracks first

Hosi Variator is a powerful tool for sound design, beat making, post-production, and cinematic audio, excelling at creating organic variations and humanization effects that bring digital audio to life!

 DOWNLOAD https://youtu.be/J759-Vym_wo

Donate me: https://paypal.me/nkstudio