{"id":30548559,"url":"https://github.com/gsejas/breath_master","last_synced_at":"2026-02-14T19:03:14.992Z","repository":{"id":311582625,"uuid":"1036429090","full_name":"GSejas/breath_master","owner":"GSejas","description":"VSCode Ext game with animated breathwork guide, ethically concious, privacy first, /w gamified features","archived":false,"fork":false,"pushed_at":"2025-08-25T09:22:35.000Z","size":23409,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-25T11:38:29.444Z","etag":null,"topics":["breathing","focus","game","gamified","theory"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=GSejas.breath-master","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GSejas.png","metadata":{"files":{"readme":"README-BREATH-MASTER.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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-08-12T04:22:32.000Z","updated_at":"2025-08-25T09:22:24.000Z","dependencies_parsed_at":"2025-08-25T11:48:40.847Z","dependency_job_id":null,"html_url":"https://github.com/GSejas/breath_master","commit_stats":null,"previous_names":["gsejas/breath_master"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/GSejas/breath_master","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSejas%2Fbreath_master","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSejas%2Fbreath_master/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSejas%2Fbreath_master/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSejas%2Fbreath_master/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GSejas","download_url":"https://codeload.github.com/GSejas/breath_master/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSejas%2Fbreath_master/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29452593,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T15:52:44.973Z","status":"ssl_error","status_checked_at":"2026-02-14T15:52:11.208Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["breathing","focus","game","gamified","theory"],"created_at":"2025-08-28T03:36:12.935Z","updated_at":"2026-02-14T19:03:14.986Z","avatar_url":"https://github.com/GSejas.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧘‍♀️ Breath Master - Mindful Coding with Ethical Gamification\n\nAre you? The next Breath Master? Transform your coding experience with gentle breathing guidance and optional progress tracking that respects your privacy and autonomy. Gamify, gently, and add flow into your workflow.\n\n## ✨ Features\n\n### **Core Breathing**\n- **5 Preset Patterns**: Chill, Medium, Active, Boxing, Relaxing\n- **Custom Patterns**: Create your own with simple format: `4-4-4-4` (inhale-hold-exhale-pause)\n- **Visual Breathing Cues**: Subtle status bar animation guides your breath\n- **Dual Indicators**: Left (breathing) and right (pattern controls) status bar items\n\n### **Ethical Gamification** (Opt-in)\n- **Privacy-First**: All data stays on your machine, never uploaded\n- **Meditation Tracking**: Track mindful moments with breathing cycles\n- **Level Progression**: From Mindful Rookie to Breath Master\n- **Daily Streaks**: Gentle encouragement without pressure\n- **Session Timer**: See today's meditation progress\n\n### **Privacy \u0026 Control**\n- **Local-Only Storage**: Data never leaves your computer\n- **Full Export**: JSON export of your progress anytime\n- **Complete Control**: Clear data, adjust privacy settings\n- **No Accounts**: Works entirely offline\n\n### **Onboarding \u0026 Engagement**\n- **Welcome Tour**: Gentle introduction to all features\n- **Exponential Backoff**: Messages become less frequent over time\n- **User-Controlled**: Set engagement to off/subtle/moderate/active\n- **12 Principles Compliant**: Follows ethical design principles\n\n## 🚀 Quick Start\n\n1. **Install**: Search \"Breath Master\" in VS Code extensions\n2. **Breathe**: Watch the gentle pulse in your status bar\n3. **Cycle Patterns**: Click the right status bar item to try different rhythms\n4. **Optional Tour**: Run \"Breath Master: Show Welcome Tour\" from command palette\n5. **Optional Tracking**: Enable gamification in settings if desired\n\n## ⚙️ Settings\n\n```json\n{\n  \"breathMaster.pattern\": \"chill\",           // Breathing pattern\n  \"breathMaster.customPattern\": \"4-4-4-4\",   // Custom timing (seconds)\n  \"breathMaster.intensity\": 0.6,             // Visual intensity\n  \"breathMaster.enableGamification\": false,  // Opt-in tracking\n  \"breathMaster.dataPrivacy\": \"local-only\"   // Privacy control\n}\n```\n\n## 🎯 Commands\n\n- `Breath Master: Toggle` - Start/stop breathing animation\n- `Breath Master: Cycle Pattern` - Try different breathing patterns\n- `Breath Master: Show Welcome Tour` - Replay the introduction\n- `Breath Master: Toggle Meditation Session` - Start/stop tracking\n- `Breath Master: Export Your Data` - Save your progress\n- `Breath Master: Clear All Data` - Fresh start\n\n## 🧘‍♂️ Breathing Patterns\n\n| Pattern | Timing | Purpose |\n|---------|--------|---------|\n| **Chill** | 6-0-8-0 | Relaxation and stress relief |\n| **Medium** | 5-0-5-0 | Coherent breathing balance |\n| **Active** | 4-2-4-1 | Energy and focus boost |\n| **Boxing** | 4-4-4-4 | Tactical breathing for concentration |\n| **Relaxing** | 4-7-8 | Deep relaxation technique |\n| **Custom** | Your choice | Create your perfect rhythm |\n\n## 🏆 Level System (Optional)\n\nProgress through mindful titles as you build a breathing practice:\n\n🌱 **Mindful Rookie** → 🌿 **Breathing Novice** → 🍃 **Calm Coder** → 🌳 **Zen Developer** → ✨ **Mindful Master** → 🧘 **Breathing Sage** → ⭐ **Code Mystic** → 🌌 **Breath Master**\n\n## 🔐 Privacy Promise\n\nBreath Master follows the [12 Principles of Ethical Design](./12-PRINCIPLES-ANALYSIS.md):\n\n- ✅ **Transparent**: You know exactly what data exists\n- ✅ **User Control**: You decide what features to use\n- ✅ **Local-First**: No cloud, no accounts, no tracking\n- ✅ **Consensual**: Clear opt-in for any data collection\n- ✅ **Respectful**: No manipulation or dark patterns\n\n## 🛠️ For Developers\n\n### Custom Patterns\nFormat: `\"inhale-hold-exhale-pause\"` in seconds\n- Example: `\"4-4-4-4\"` = 4 seconds each phase\n- Example: `\"6-0-8-0\"` = 6 second inhale, 8 second exhale\n- Validation ensures safe breathing patterns\n\n### Data Export Format\n```json\n{\n  \"exportDate\": \"2025-08-11T...\",\n  \"breathMaster\": {\n    \"meditation\": {\n      \"totalXP\": 150,\n      \"currentStreak\": 5,\n      \"todaySessionTime\": 600000\n    },\n    \"onboarding\": {\n      \"hasSeenTour\": true,\n      \"gamificationOptIn\": true\n    }\n  }\n}\n```\n\n## 🤝 Contributing\n\nThis extension demonstrates ethical technology design. Contributions should maintain:\n- User agency and control\n- Privacy-first approach\n- Respectful engagement\n- Transparent functionality\n\n## 📄 License\n\nMIT License - Build mindful technology freely\n\n---\n\n\u003e *\"Code with breath, build with intention, ship with mindfulness.\"*\n\n**Made with 🫁 for developers who care about well-being and ethical tech.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsejas%2Fbreath_master","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgsejas%2Fbreath_master","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsejas%2Fbreath_master/lists"}