{"id":30043100,"url":"https://github.com/secret-guest/sandcastle","last_synced_at":"2025-08-07T04:55:34.779Z","repository":{"id":307235584,"uuid":"1028805323","full_name":"SECRET-GUEST/sandcastle","owner":"SECRET-GUEST","description":"Pink Noise Generator with dream programming (oniromancy)","archived":false,"fork":false,"pushed_at":"2025-07-30T06:06:11.000Z","size":8031,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-30T07:18:47.526Z","etag":null,"topics":["audio","auditory","cycles","dali","dream","dreaming","noise","oniromancy","pink","programming","rem","salvador","sleep","sleepenhancement","sleeplucid","stimulation","suggestions"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SECRET-GUEST.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-30T05:06:16.000Z","updated_at":"2025-07-30T06:06:01.000Z","dependencies_parsed_at":"2025-07-30T07:19:15.762Z","dependency_job_id":"61ea8de5-ac2f-4fc9-8c12-65e96588f691","html_url":"https://github.com/SECRET-GUEST/sandcastle","commit_stats":null,"previous_names":["secret-guest/sandcastle"],"tags_count":null,"template":false,"template_full_name":"SECRET-GUEST/READMEtemplate","purl":"pkg:github/SECRET-GUEST/sandcastle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SECRET-GUEST%2Fsandcastle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SECRET-GUEST%2Fsandcastle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SECRET-GUEST%2Fsandcastle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SECRET-GUEST%2Fsandcastle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SECRET-GUEST","download_url":"https://codeload.github.com/SECRET-GUEST/sandcastle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SECRET-GUEST%2Fsandcastle/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269201306,"owners_count":24377459,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-07T02:00:09.698Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","auditory","cycles","dali","dream","dreaming","noise","oniromancy","pink","programming","rem","salvador","sleep","sleepenhancement","sleeplucid","stimulation","suggestions"],"created_at":"2025-08-07T04:55:33.254Z","updated_at":"2025-08-07T04:55:34.734Z","avatar_url":"https://github.com/SECRET-GUEST.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Python](https://img.shields.io/badge/Python-3.10+-blue)](https://www.python.org/)\n[![Batch Script](https://img.shields.io/badge/script-batch-DDFF00)](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/windows-commands)\n[![WinDdos](https://img.shields.io/badge/WinDdos-blue)](https://www.microsoft.com/en-us/windows)\n\n```\n███████╗ █████╗ ███╗   ██╗██████╗  ██████╗ █████╗ ███████╗████████╗██╗     ███████╗\n██╔════╝██╔══██╗████╗  ██║██╔══██╗██╔════╝██╔══██╗██╔════╝╚══██╔══╝██║     ██╔════╝\n███████╗███████║██╔██╗ ██║██║  ██║██║     ███████║███████╗   ██║   ██║     █████╗  \n╚════██║██╔══██║██║╚██╗██║██║  ██║██║     ██╔══██║╚════██║   ██║   ██║     ██╔══╝  \n███████║██║  ██║██║ ╚████║██████╔╝╚██████╗██║  ██║███████║   ██║   ███████╗███████╗\n╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═════╝  ╚═════╝╚═╝  ╚═╝╚══════╝   ╚═╝   ╚══════╝╚══════╝\n                                                                                   \n```\n\n![ALPHA](https://img.shields.io/badge/ALPHA-red)\n\n# 🎧 **Pink Noise Generator \u0026 Oniromancy**\n\n## Une version francaise est disponible dans la branche FR\n---\n---\n\n## 📌 **Overview**\n\nThis 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)**.\n\nThe interface provides simple guidance on:\n\n* **Sleep cycles** and their durations.\n* The role of the **fade-out**.\n* Automatic placement of audio suggestions.\n\n---\n\n## 🚀 **Usage**\n\n1. **Run the program**\n   Double-click:\n\n```\nSTART.bat\n```\n\n*(No manual installation required — everything is handled automatically.)*\n\n2. **Follow the on-screen instructions**\n\n* Enter the **total duration** of the pink noise (in seconds).\n* Enter the **fade-out duration** (in seconds).\n* Choose whether to **add voice suggestions**.\n\n3. **If suggestions are enabled**\n\n* Place your `.wav` files in:\n\n```\nscripts/Assets/SFX/Suggests/\n```\n\n* They will be automatically integrated and normalized in the final audio.\n\n---\n\n## 🖥 **Optional: Automatic Shutdown**\n\nYou can schedule your PC to shut down automatically after the pink noise finishes:\n\n```powershell\nshutdown /s /t 8000\n```\n\nWhere:\n\n* `/s` = Shutdown (complete power off)\n* `/t` = Time delay before shutdown (in seconds)\n\n**Examples:**\n\n* `shutdown /s /t 7200` → shutdown after **2 hours**\n* `shutdown /s /t 14400` → shutdown after **4 hours**\n\n**Cancel a scheduled shutdown:**\n\n```powershell\nshutdown /a\n```\n\n---\n\n## 📂 **File Structure**\n\n```\nProject/\n│   START.bat           → Launches the entire program\n│\n└───scripts\n   ├───Assets\n   │   └───SFX\n   │       ├───SE           → System sounds\n   │       └───Suggests     → User voice suggestions (.wav)\n   │\n   └───src\n       │   bruit_rose.py    → Pink noise generation + suggestion integration\n       │   intro.py         → Intro explaining sleep cycles\n       │   loadingSpinner.py→ Console loading animation\n       │   requirements.txt → Auto-installed dependencies\n```\n\n---\n\n## ⏳ **Cycles \u0026 Suggestion Placement**\n\nSuggestions are automatically placed just before or during the REM phase of each cycle (\\~90 min):\n\n| Cycle | REM Start (approx.) | Placement suggestion | Durée en secondes (min → max) |\n| ----- | ------------------- | -------------------- | ----------------------------- |\n| 1     | 70–90 min           | \\~1h15 – 1h30        | 4500 – 5400 s                 |\n| 2     | 160–180 min         | \\~2h45 – 3h          | 9900 – 10800 s                |\n| 3     | 250–270 min         | \\~4h15 – 4h30        | 15300 – 16200 s               |\n\n---\n\n## ⚠️ **Warning**\n\n* Without fade-out, REM is amplified → more creativity but **less physical recovery**.\n* Overusing this method can cause **fatigue and sleep disruption**.\n* Inspired by Salvador Dalí’s micro-sleep technique (*Les Rêveries d’un mangeur de pain*).\n\n---\n\n## 📜 **References**\n\n* Ngo, Hong-Viet V., et al. *Enhancing Slow Wave Sleep with Auditory Stimulation*. Frontiers in Human Neuroscience, 2017.\n* Dalí, Salvador. *Les Rêveries d’un mangeur de pain*.\n* *Journal of Cognitive Neuroscience*, 2015 — study on internal voice perception.\n\n---\n\n💡 **Tip**: Use your **own voice** for suggestions. The brain identifies it as an internal thought → stronger impact.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecret-guest%2Fsandcastle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsecret-guest%2Fsandcastle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecret-guest%2Fsandcastle/lists"}