{"id":683,"date":"2026-06-29T03:59:26","date_gmt":"2026-06-29T03:59:26","guid":{"rendered":"https:\/\/www.mickeydesigns.com\/home\/?p=683"},"modified":"2026-06-29T03:59:38","modified_gmt":"2026-06-29T03:59:38","slug":"pyropulse-help-and-troubleshooting-guide","status":"publish","type":"post","link":"https:\/\/www.mickeydesigns.com\/home\/pyropulse-help-and-troubleshooting-guide\/","title":{"rendered":"PyroPulse Help and Troubleshooting Guide"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\">PyroPulse Help and Troubleshooting Guide<\/h1>\n\n\n\n<!-- PyroPulse \u2014 Help & Troubleshooting -->\n<!-- Paste this into a Custom HTML block in WordPress -->\n\n<style>\n.pp-guide { max-width: 800px; margin: 0 auto; font-size: 16px; line-height: 1.7; color: inherit; }\n.pp-guide h2 { font-size: 1.4em; margin: 2em 0 0.5em; padding-bottom: 0.3em; border-bottom: 1px solid #e0e0e0; }\n.pp-guide h3 { font-size: 1.1em; margin: 1.6em 0 0.4em; }\n.pp-guide p { margin: 0 0 1em; }\n.pp-guide ul, .pp-guide ol { margin: 0 0 1em 1.5em; padding: 0; }\n.pp-guide li { margin-bottom: 0.4em; }\n.pp-guide code { font-family: monospace; font-size: 0.9em; background: #f4f4f4; padding: 2px 5px; border-radius: 3px; }\n.pp-guide pre { background: #f4f4f4; border-left: 3px solid #ccc; padding: 1em; overflow-x: auto; border-radius: 3px; margin: 0 0 1em; }\n.pp-guide pre code { background: none; padding: 0; }\n.pp-guide table { width: 100%; border-collapse: collapse; margin: 0 0 1.5em; font-size: 0.95em; }\n.pp-guide th { background: #f4f4f4; text-align: left; padding: 8px 12px; border: 1px solid #ddd; font-weight: 600; }\n.pp-guide td { padding: 8px 12px; border: 1px solid #ddd; vertical-align: top; }\n.pp-guide blockquote { border-left: 3px solid #ccc; margin: 1em 0; padding: 0.6em 1.2em; background: #fafafa; color: #555; border-radius: 0 3px 3px 0; }\n.pp-guide blockquote p:last-child { margin: 0; }\n.pp-guide a { color: inherit; }\n.pp-guide strong { font-weight: 600; }\n.pp-toc { background: #fafafa; border: 0.5px solid #ddd; border-radius: 4px; padding: 1rem 1.25rem; margin: 0 0 2em; }\n.pp-toc h3 { margin: 0 0 0.6em; }\n.pp-toc ol { margin: 0; }\n<\/style>\n\n<div class=\"pp-guide\">\n\n<p>PyroPulse is a spatial fireworks app for Apple Vision Pro. This guide covers setup, every feature, and the most common questions and fixes.<\/p>\n\n<p>If you don&#8217;t see your issue here, contact support at <code>info@mickeydesigns.com<\/code> and include your visionOS version and a brief description of what you were doing when the problem happened.<\/p>\n\n<div class=\"pp-toc\">\n  <h3>Table of Contents<\/h3>\n  <ol>\n    <li><a href=\"#getting-started\">Getting Started<\/a><\/li>\n    <li><a href=\"#tabs\">The Four Tabs<\/a><\/li>\n    <li><a href=\"#music-synced\">Apple Music Synced Shows<\/a><\/li>\n    <li><a href=\"#freestyle\">Freestyle Mode<\/a><\/li>\n    <li><a href=\"#audio\">Volume &amp; Spatial Audio<\/a><\/li>\n    <li><a href=\"#troubleshooting\">Troubleshooting<\/a><\/li>\n    <li><a href=\"#privacy\">Privacy<\/a><\/li>\n    <li><a href=\"#support\">Still Need Help?<\/a><\/li>\n  <\/ol>\n<\/div>\n\n<h2 id=\"getting-started\">Getting Started<\/h2>\n\n<h3>What you need<\/h3>\n\n<ul>\n  <li>An Apple Vision Pro running a recent version of visionOS.<\/li>\n  <li>(Optional) An Apple Music subscription and at least one song in your library, if you want music-synced shows.<\/li>\n<\/ul>\n\n<h3>First launch<\/h3>\n\n<ol>\n  <li>Open PyroPulse. The main control window appears with four tabs: Show, Launch, Music, Settings.<\/li>\n  <li>At the bottom of the window you&#8217;ll see a glass button labeled &#8220;Show Immersive Space.&#8221; Tap it to enter the fireworks scene.<\/li>\n  <li>From the Launch tab, tap any firework to fire your first shell.<\/li>\n<\/ol>\n\n<p>To leave the show at any time, tap the same button (now labeled &#8220;Hide Immersive Space&#8221;) at the bottom of the window.<\/p>\n\n<h2 id=\"tabs\">The Four Tabs<\/h2>\n\n<h3>Show<\/h3>\n\n<p>Pick your viewpoint \u2014 where you&#8217;re &#8220;standing&#8221; relative to the show. You can change this mid-show.<\/p>\n\n<ul>\n  <li><strong>Front Row<\/strong> \u2014 bursts fill the sky just above you.<\/li>\n  <li><strong>Directly Overhead<\/strong> \u2014 stand under a shower of sparks.<\/li>\n  <li><strong>Distant Skyline<\/strong> \u2014 a balcony view, far away.<\/li>\n  <li><strong>Surround<\/strong> \u2014 fireworks launch from every direction.<\/li>\n  <li><strong>Lakeside<\/strong> \u2014 mid-distance, drifting low over the water.<\/li>\n  <li><strong>Parade Ground<\/strong> \u2014 small eye-level ground bursts.<\/li>\n<\/ul>\n\n<h3>Launch<\/h3>\n\n<p>Tap any of the ten firework types to fire one immediately:<\/p>\n\n<p>Classic, Willow, Chrysanthemum, Strobe, Rainbow, Sparkle, Cascade, Ring, Glitter, Finale.<\/p>\n\n<p>The most recently tapped firework is the one Pinch to Launch will fire \u2014 it&#8217;s marked with a small hand icon.<\/p>\n\n<h3>Music<\/h3>\n\n<p>Sync the show to a song from your Apple Music library, or run a 90-second freestyle show with no music. Adjust the Volume of launch whistles and explosions, and view the in-app status.<\/p>\n\n<h2 id=\"music-synced\">Apple Music Synced Shows<\/h2>\n\n<p>PyroPulse uses Apple&#8217;s MusicKit to read your library, play your chosen song, and time fireworks to the beat. The first time you tap into the Music tab you&#8217;ll be asked to grant Apple Music access.<\/p>\n\n<h3>Running a synced show<\/h3>\n\n<ol>\n  <li>Tap the Music tab.<\/li>\n  <li>Tap &#8220;Choose Song&#8221; to open the library window.<\/li>\n  <li>Pick any song \u2014 recently added tracks appear at the top, or use the search field to find one by title or artist.<\/li>\n  <li>Back on the Music tab, tap &#8220;Start Show.&#8221; Fireworks will follow the song from intro through the grand finale.<\/li>\n  <li>Use Pause Show \/ Resume or Stop at any time.<\/li>\n<\/ol>\n\n<h3>What the status pill means<\/h3>\n\n<ul>\n  <li><strong>Ready<\/strong> \u2014 song picked, waiting for you to start.<\/li>\n  <li><strong>Live<\/strong> \u2014 show is currently playing.<\/li>\n  <li><strong>Paused<\/strong> \u2014 playback is paused; tap Resume to continue.<\/li>\n  <li><strong>Encore<\/strong> \u2014 the song finished. Pick another or restart.<\/li>\n  <li><strong>Authorizing<\/strong> \u2014 waiting for Apple Music permission.<\/li>\n  <li><strong>Access denied<\/strong> \u2014 Apple Music access is not granted (see fix below).<\/li>\n  <li><strong>Freestyle<\/strong> \u2014 a music-less show is currently running.<\/li>\n<\/ul>\n\n<h2 id=\"freestyle\">Freestyle Mode (No Music Needed)<\/h2>\n\n<p>If you don&#8217;t have Apple Music, don&#8217;t want to grant access, or just want a quick show, use Freestyle.<\/p>\n\n<ol>\n  <li>Go to the Music tab.<\/li>\n  <li>Tap &#8220;Run Freestyle.&#8221;<\/li>\n  <li>A 90-second beat-driven show plays with no music \u2014 same firework variety, same finale pacing.<\/li>\n<\/ol>\n\n<p>Tap Stop to end it early.<\/p>\n\n<h2 id=\"audio\">Volume &amp; Spatial Audio<\/h2>\n\n<p>Every shell whistles up from its launch point, and every boom rings out from exactly where the explosion lights up.<\/p>\n\n<ul>\n  <li>Adjust loudness from the Settings tab with the Volume slider.<\/li>\n  <li>Set it to 0 for a fully silent show.<\/li>\n  <li>The slider affects both the launch whistle and the explosion boom.<\/li>\n<\/ul>\n\n<h2 id=\"troubleshooting\">Troubleshooting<\/h2>\n\n<h3>&#8220;The immersive space won&#8217;t open&#8221;<\/h3>\n\n<ul>\n  <li>Make sure your Vision Pro has room \u2014 it asks for clearance the first time you enter an immersive scene.<\/li>\n  <li>Tap the Show Immersive Space button at the bottom of the main window once and wait a moment.<\/li>\n  <li>If it still won&#8217;t appear, fully quit PyroPulse (look at the app, press and hold the Digital Crown, confirm) and reopen.<\/li>\n<\/ul>\n\n<h3>&#8220;I tap firework buttons but nothing happens&#8221;<\/h3>\n\n<p>The launch buttons are only active while the immersive space is open. Look for the &#8220;Show Immersive Space&#8221; ornament at the bottom of the window and tap it first.<\/p>\n\n<h3>&#8220;Fireworks look small or far away&#8221;<\/h3>\n\n<p>That&#8217;s expected for the Distant Skyline and Lakeside viewpoints \u2014 they&#8217;re designed to feel like watching from across a park or lake. For closer bursts, switch to Front Row or Directly Overhead on the Show tab. You can change viewpoint mid-show.<\/p>\n\n<h3>&#8220;Fireworks are too low or too close&#8221;<\/h3>\n\n<p>Try Distant Skyline for a high, far-away horizon, or Directly Overhead to put the bursts above you. Parade Ground is intentionally small and at eye level \u2014 switch away from it if you want a traditional sky show.<\/p>\n\n<h3>&#8220;I see &#8216;Apple Music access needed&#8217; or &#8216;Access denied'&#8221;<\/h3>\n\n<p>PyroPulse needs Apple Music permission to read your library and play songs.<\/p>\n\n<p>To fix:<\/p>\n\n<ol>\n  <li>From the Music tab, tap &#8220;Open Settings.&#8221; (Or open the Settings app manually.)<\/li>\n  <li>Find PyroPulse in the app list.<\/li>\n  <li>Tap Media &amp; Apple Music (or &#8220;Apple Music&#8221;) and turn it on.<\/li>\n  <li>Return to PyroPulse \u2014 the library should load automatically.<\/li>\n<\/ol>\n\n<p>If you don&#8217;t want to grant access, use Run Freestyle instead for a music-less show.<\/p>\n\n<h3>&#8220;My library is empty or missing songs&#8221;<\/h3>\n\n<ul>\n  <li>PyroPulse shows the first 100 most-recently-added songs from your Apple Music library, sorted with newest first.<\/li>\n  <li>If you don&#8217;t see a song, type its title or artist in the search field in the library window \u2014 search will find any matching track in the loaded list.<\/li>\n  <li>If the list is genuinely empty, you may not have any songs added to your Apple Music library yet. Open the Music app and add a song to your library, then tap the Refresh button in PyroPulse&#8217;s library window.<\/li>\n<\/ul>\n\n<h3>&#8220;The song plays but fireworks aren&#8217;t firing&#8221;<\/h3>\n\n<ul>\n  <li>Check that the immersive space is open (tap &#8220;Show Immersive Space&#8221; at the bottom of the main window). The Synced Show times fireworks regardless, but they only appear inside the immersive scene.<\/li>\n  <li>If the status pill says Paused, tap Resume.<\/li>\n  <li>Some songs are extremely short \u2014 the intro and build sections may use up most of the runtime before the peak begins. Try a longer track (anything 2+ minutes works well).<\/li>\n<\/ul>\n\n<h3>&#8220;Fireworks are out of sync with the music&#8221;<\/h3>\n\n<p>PyroPulse uses a 120 BPM beat grid as a sensible default. Tracks that aren&#8217;t close to 120 BPM (or have heavy tempo changes) may feel slightly off the beat \u2014 the show will still pace correctly through intro, build, peak, and finale, just not snapped to each bar of your specific song.<\/p>\n\n<p>If the drift is severe, Stop and Start the show again to resync from the beginning.<\/p>\n\n<h3>&#8220;There&#8217;s no sound&#8221;<\/h3>\n\n<ul>\n  <li>Open the Settings tab and confirm the Volume slider is above 0.<\/li>\n  <li>Check that your Vision Pro isn&#8217;t muted at the system level.<\/li>\n  <li>Audio is spatial, so it&#8217;s possible the firework you launched is positioned to one side \u2014 try a Front Row viewpoint where bursts are centered.<\/li>\n  <li>If sound is still missing, fully quit and relaunch PyroPulse.<\/li>\n<\/ul>\n\n<h3>&#8220;Pinch to Launch isn&#8217;t working&#8221;<\/h3>\n\n<ul>\n  <li>Confirm the toggle on the Launch tab is on.<\/li>\n  <li>Make sure the immersive space is open.<\/li>\n  <li>Look at where you want the burst to land, then pinch \u2014 the firework arcs up from below to that point.<\/li>\n  <li>If pinch is on but the floating in-space panel isn&#8217;t visible, look slightly down and forward \u2014 it sits about a meter in front of you at chest level.<\/li>\n<\/ul>\n\n<h3>&#8220;I see an error banner at the top of the window&#8221;<\/h3>\n\n<p>The banner shows messages from playback or audio. Tap the X on the right to dismiss it. Common causes:<\/p>\n\n<ul>\n  <li>&#8220;Couldn&#8217;t start playback&#8221; \u2014 usually transient; tap Start Show again.<\/li>\n  <li>&#8220;Apple Music access was not granted&#8221; \u2014 see the access fix above.<\/li>\n  <li>Audio-related messages mean the spatial audio engine couldn&#8217;t initialize; restarting the app generally clears this.<\/li>\n<\/ul>\n\n<h3>&#8220;Performance feels slow during the finale&#8221;<\/h3>\n\n<p>PyroPulse automatically throttles particle density when many fireworks are in flight at once, but very dense moments can still be heavy. If you notice stutter:<\/p>\n\n<ul>\n  <li>Avoid mashing the Finale button repeatedly back-to-back \u2014 wait a couple of seconds between manual launches.<\/li>\n  <li>Close other immersive apps before opening PyroPulse.<\/li>\n<\/ul>\n\n<h3>&#8220;The app crashed or froze&#8221;<\/h3>\n\n<ul>\n  <li>Fully quit PyroPulse (look at the app, press and hold the Digital Crown, confirm Quit).<\/li>\n  <li>Reopen the app.<\/li>\n  <li>If it crashes again, restart your Vision Pro.<\/li>\n  <li>If the problem persists, please email support with your visionOS version and what you were doing right before the crash.<\/li>\n<\/ul>\n\n<h2 id=\"privacy\">Privacy<\/h2>\n\n<ul>\n  <li>PyroPulse does not require an account or sign-in.<\/li>\n  <li>PyroPulse does not collect, transmit, or share any personal data.<\/li>\n  <li>Apple Music access is used only on your device, to read your library and play your selected song. Nothing about your music is sent anywhere.<\/li>\n  <li>Your most recently selected song is remembered locally so the picker can highlight it next time you open the app.<\/li>\n<\/ul>\n\n<h2 id=\"support\">Still Need Help?<\/h2>\n\n<p>Email <code>info@mickeydesigns.com<\/code> with:<\/p>\n\n<ul>\n  <li>Your visionOS version (Settings \u2192 General \u2192 About).<\/li>\n  <li>A short description of what happened and what you were doing.<\/li>\n  <li>Whether the issue is reproducible.<\/li>\n<\/ul>\n\n<p>We aim to reply within two business days.<\/p>\n\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>PyroPulse Help and Troubleshooting Guide PyroPulse is a spatial fireworks app for Apple Vision Pro. This guide covers setup, every feature, and the most common questions and fixes. If you don&#8217;t see your issue here, contact support at info@mickeydesigns.com and include your visionOS version and a brief description of what you were doing when the &#8230; <a title=\"PyroPulse Help and Troubleshooting Guide\" class=\"read-more\" href=\"https:\/\/www.mickeydesigns.com\/home\/pyropulse-help-and-troubleshooting-guide\/\" aria-label=\"Read more about PyroPulse Help and Troubleshooting Guide\">Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":684,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"elementor_header_footer","format":"standard","meta":{"footnotes":""},"categories":[20],"tags":[],"class_list":["post-683","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-help"],"_links":{"self":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/683","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/comments?post=683"}],"version-history":[{"count":1,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/683\/revisions"}],"predecessor-version":[{"id":685,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/683\/revisions\/685"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/media\/684"}],"wp:attachment":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/media?parent=683"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/categories?post=683"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/tags?post=683"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}