https://github.com/secret-guest/sandcastle
Pink Noise Generator with dream programming (oniromancy)
https://github.com/secret-guest/sandcastle
audio auditory cycles dali dream dreaming noise oniromancy pink programming rem salvador sleep sleepenhancement sleeplucid stimulation suggestions
Last synced: 10 months ago
JSON representation
Pink Noise Generator with dream programming (oniromancy)
- Host: GitHub
- URL: https://github.com/secret-guest/sandcastle
- Owner: SECRET-GUEST
- Created: 2025-07-30T05:06:16.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-07-30T06:06:11.000Z (10 months ago)
- Last Synced: 2025-07-30T07:18:47.526Z (10 months ago)
- Topics: audio, auditory, cycles, dali, dream, dreaming, noise, oniromancy, pink, programming, rem, salvador, sleep, sleepenhancement, sleeplucid, stimulation, suggestions
- Language: Python
- Homepage:
- Size: 7.66 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://www.python.org/)
[](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/windows-commands)
[](https://www.microsoft.com/en-us/windows)
```
███████╗ █████╗ ███╗ ██╗██████╗ ██████╗ █████╗ ███████╗████████╗██╗ ███████╗
██╔════╝██╔══██╗████╗ ██║██╔══██╗██╔════╝██╔══██╗██╔════╝╚══██╔══╝██║ ██╔════╝
███████╗███████║██╔██╗ ██║██║ ██║██║ ███████║███████╗ ██║ ██║ █████╗
╚════██║██╔══██║██║╚██╗██║██║ ██║██║ ██╔══██║╚════██║ ██║ ██║ ██╔══╝
███████║██║ ██║██║ ╚████║██████╔╝╚██████╗██║ ██║███████║ ██║ ███████╗███████╗
╚══════╝╚═╝ ╚═╝╚═╝ ╚═══╝╚═════╝ ╚═════╝╚═╝ ╚═╝╚══════╝ ╚═╝ ╚══════╝╚══════╝
```
# 🎧 **Pink Noise Generator & Oniromancy**
## Une version francaise est disponible dans la branche FR
---
---
## 📌 **Overview**
This program generates **filtered pink noise** to improve sleep quality, and can automatically integrate **audio suggestions** (voice, sounds) at the optimal times during REM sleep cycles to help **influence dreams (oniromancy)**.
The interface provides simple guidance on:
* **Sleep cycles** and their durations.
* The role of the **fade-out**.
* Automatic placement of audio suggestions.
---
## 🚀 **Usage**
1. **Run the program**
Double-click:
```
START.bat
```
*(No manual installation required — everything is handled automatically.)*
2. **Follow the on-screen instructions**
* Enter the **total duration** of the pink noise (in seconds).
* Enter the **fade-out duration** (in seconds).
* Choose whether to **add voice suggestions**.
3. **If suggestions are enabled**
* Place your `.wav` files in:
```
scripts/Assets/SFX/Suggests/
```
* They will be automatically integrated and normalized in the final audio.
---
## 🖥 **Optional: Automatic Shutdown**
You can schedule your PC to shut down automatically after the pink noise finishes:
```powershell
shutdown /s /t 8000
```
Where:
* `/s` = Shutdown (complete power off)
* `/t` = Time delay before shutdown (in seconds)
**Examples:**
* `shutdown /s /t 7200` → shutdown after **2 hours**
* `shutdown /s /t 14400` → shutdown after **4 hours**
**Cancel a scheduled shutdown:**
```powershell
shutdown /a
```
---
## 📂 **File Structure**
```
Project/
│ START.bat → Launches the entire program
│
└───scripts
├───Assets
│ └───SFX
│ ├───SE → System sounds
│ └───Suggests → User voice suggestions (.wav)
│
└───src
│ bruit_rose.py → Pink noise generation + suggestion integration
│ intro.py → Intro explaining sleep cycles
│ loadingSpinner.py→ Console loading animation
│ requirements.txt → Auto-installed dependencies
```
---
## ⏳ **Cycles & Suggestion Placement**
Suggestions are automatically placed just before or during the REM phase of each cycle (\~90 min):
| Cycle | REM Start (approx.) | Placement suggestion | Durée en secondes (min → max) |
| ----- | ------------------- | -------------------- | ----------------------------- |
| 1 | 70–90 min | \~1h15 – 1h30 | 4500 – 5400 s |
| 2 | 160–180 min | \~2h45 – 3h | 9900 – 10800 s |
| 3 | 250–270 min | \~4h15 – 4h30 | 15300 – 16200 s |
---
## ⚠️ **Warning**
* Without fade-out, REM is amplified → more creativity but **less physical recovery**.
* Overusing this method can cause **fatigue and sleep disruption**.
* Inspired by Salvador Dalí’s micro-sleep technique (*Les Rêveries d’un mangeur de pain*).
---
## 📜 **References**
* Ngo, Hong-Viet V., et al. *Enhancing Slow Wave Sleep with Auditory Stimulation*. Frontiers in Human Neuroscience, 2017.
* Dalí, Salvador. *Les Rêveries d’un mangeur de pain*.
* *Journal of Cognitive Neuroscience*, 2015 — study on internal voice perception.
---
💡 **Tip**: Use your **own voice** for suggestions. The brain identifies it as an internal thought → stronger impact.