{"id":20501942,"url":"https://github.com/sourcetortoise/zzz","last_synced_at":"2026-02-24T11:30:47.589Z","repository":{"id":262549065,"uuid":"880439516","full_name":"sourcetortoise/zzz","owner":"sourcetortoise","description":"A sleep computer to promote lucid dreaming","archived":false,"fork":false,"pushed_at":"2024-11-13T17:24:59.000Z","size":146,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-25T15:29:51.859Z","etag":null,"topics":["dreaming","lucid","raspberry-pi","sleep"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sourcetortoise.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-10-29T18:16:42.000Z","updated_at":"2025-01-06T21:28:37.000Z","dependencies_parsed_at":"2025-10-25T15:17:35.917Z","dependency_job_id":null,"html_url":"https://github.com/sourcetortoise/zzz","commit_stats":null,"previous_names":["mirthturtle/zzz"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/sourcetortoise/zzz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcetortoise%2Fzzz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcetortoise%2Fzzz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcetortoise%2Fzzz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcetortoise%2Fzzz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sourcetortoise","download_url":"https://codeload.github.com/sourcetortoise/zzz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sourcetortoise%2Fzzz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29780604,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T10:45:18.109Z","status":"ssl_error","status_checked_at":"2026-02-24T10:45:09.911Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["dreaming","lucid","raspberry-pi","sleep"],"created_at":"2024-11-15T19:18:11.211Z","updated_at":"2026-02-24T11:30:47.572Z","avatar_url":"https://github.com/sourcetortoise.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zzz – sleep computer\n\nFeeling tired? Why not stay up and hack together a machine to help you experience [lucid dreams](https://en.wikipedia.org/wiki/Lucid_dream).\n\n![zzz in operation](https://github.com/mirthturtle/zzz/blob/main/bedside.jpg \"zzz in operation\")\n\n`zzz` uses a trigger-style mouse to play distinctive sounds. Wear it during sleep and test your reality in dreams by squeezing your finger or thumb. If you hear the sounds, you can recognize that you're asleep and take control of the dream.\n\n## Equipment\n\nYou will need:\n- A [Raspberry Pi](https://www.raspberrypi.com/)\n- An ergonomic handheld trigger mouse\n- Speaker or headphones\n\n## Setup\n\nClone the repo to your Pi. Install Python:\n```\nsudo apt update\nsudo apt install python3 python3-pip\n```\nInstall dependencies:\n```\npip3 install pygame evdev\n```\nDepending on your Pi OS version you may need to add `--break-system-packages` here; this is fine if your Pi will be a dedicated `zzz` machine and you don't care about your Python environment; otherwise, create a virtual environment.\n\nPut sounds in the `sound` directory and link them to your desired buttons in `zzz.py`.\n\nAdjust volume with `alsamixer`.\n\n## Running\n\nRun `sh run.sh` in the project directory.\n\nTimestamped logs are collected in `sleep.log`.\n\n## License\n\nThis program is licensed by GPL-3.0.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsourcetortoise%2Fzzz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsourcetortoise%2Fzzz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsourcetortoise%2Fzzz/lists"}