Software Update History

Todo List

1.   "Box Breathing"
   {{in-progress,priority:high} 3/7/2025}

   Details...

   • As of Version 0.1.73:  I added adjustable visual cue and first pass at user guide document.
   • \todo  {{in-progres (lit review)}}Add Audio Cues
   • \todo {{in-progress (code, early app features)}} Investigate using microphone on headphone or VR headset to track user's breathing
   • \todo {{not-started}} Investigate using phone accelerometer to rest phone on stomach while lying down and use acc. info to track users belly breathing.
2. "Box Breathing::Load Video in Background Layer"
   {{status:in-progress/testing}, 3/1/2025 

   Details...

   Developed from Idea-2
3. "Box Breathing::background visual layer"
   {{status:brainstorm}, {priority: longterm},3/9/2025 

   Details...

   1.  loadable static image 
      

      Details...

      User loadable static image from local file system

   2.  loadable image sequence

      Details...

      User loadable image sequence (load a set of images from local file system) and automatically sequence through them.   Or assume user can create a html document fragment that references their images and includes some annotations about how long to show each image

   3.  loadable video
      

      Details...

      User loadable video from local file system or external URL
      (evolved into Todo-16)

   4.  animated WebGL scene
      

      Details...

      zax-mindscape provide animated WebGL scene

   5.  proper VR mode
      

      Details...

      VR mode for above 

4. "add monural beat [BW2025][Murdock2024] variation" | Does this make sense?
   {{status:lit-review}, {priority: low}}

   Details...

   I'd (ZJW) guess the mouse clinical studies (Tsai, etc.) use monuaral beats because it is not practical to put head phones on a mouse.  Not clear there is an advantage of monural beat options to zax-mindscape.
5. "Auto Update www.zacharywartell.net" write bash scripts to push updates to www.zacharywartell.net/zax-mindscape.
   {{not-started},{priority:low},2/28/2025}
   Details...

   _.
6. \[ux] fix bugs with positioning of popup balloon help. Some balloons are too far from the control element to move the mosue over to the balloon and click the "more..." link
   {{in-progress},{priority:medium},3/3/2025}

   Details...

   • As of Version: 0.1.73:  I made various significant improvements, I'm reasonably satisfied
7. \todo {{in-progress},{priority:medium},3/3/2025} [ux:rd] improve the responsive design for small screens (smart phone, etc.).

   Details...

   • As of Version: 0.1.73: I made some improvements here and there.  More to be done.
   • increase button size and size of text
   • possibly change control layout.
   •   -.....
8. [ux] "Waveform display aspect ratio" |  improve behavior of aspect ratio adjustment when waveform plane is resized. 
   {{in-progress},{priority:medium},2/28/2025}

   Details...

   • made small improvements ...
   • (ZJW) more ideas in my head
9. [ui] "Small Screen <audio> bug" | On small touch screens the default  <audio> volume adjusted for each audio loop appears to only allow turning the volume on/off.  On large screens w/ mouse, you can adjust the volume level too. 
   {{not-started},{priority:medium},3/3/2025}

   Details...

   • (ZJW) probably need to write my own specific version of the <audio> element with just the loop name, a volume slider and trash can button.  Probably requires re-write code to use AudioNode to play each audio loop instead of using the <audio> element as programming short cut.
10. \todo [.] "." | _ . 

    Details...

    _.
11. Auto Extracted Todo's:
    

1. \todo "Add interactive box breathing guide" |
   {{status: brainstorming-complete /* developement-in-progress */},{priority:high},3/3/2025} |
   

   1. user can adjust 4 time durations for each breathing phase, i.e. in-hold-out-hold.
   2. app provides audio feedback for each phase.
   3. {later} provide simple visual feedback for each phase

   Details...

   _.
2. \todo {{complete},{priority:high}} "Sound Streams" | Add optional secondary audio stream(s) read from "/sounds"

   Details...

   2/28/2025 - started.
   3/1/2025 - much progress.

Planned features

Informal Testing

Tested Personal (ZJW) Systems

• personal (ZJW) Windows 10 deskop
  
  • Headphones:
    
    • Sony MDREX15AP In-Ear Earbud Headphones with Mic, Black (MDREX15AP/B)
      
    • SABRENT USB Type A to 3.5mm Dual Function Audio Jack Active Adapter 20" Cable (CB-UA35)
• personal (ZJW) Windows 11 laptop
• personal (ZJW) Android phone
  
  • Headphones:
    
    • Sony MDREX15AP In-Ear Earbud Headphones with Mic, Black (MDREX15AP/B)
    • JXMOX USB Type C to 3.5mm Female Headphone Jack Adapter, USB C to Aux Audio Dongle Cable Cord Compatible with iPhone 16 Pro Max 15 Pro Max, Samsung Galaxy S24 S23 S22 Ultra, Pixel, iPad Pro, MacBook
• Oculus Quest 3:
  
  • Headphones
    
    • Sony MDREX15AP In-Ear Earbud Headphones with Mic, Black (MDREX15AP/B)

Literature Review

API References and Developer Tools

• https://developer.mozilla.org/en-US/docs/Web
• https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API
• https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/What_is_a_progressive_web_app
• https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API/Visualizations_with_Web_Audio_API
• Application, *nix audio converter,
• sudo apt-get install sox libsox-fmt-all

Binaural Beat References