{"id":692,"date":"2026-07-01T04:27:53","date_gmt":"2026-07-01T04:27:53","guid":{"rendered":"https:\/\/www.mickeydesigns.com\/home\/?p=692"},"modified":"2026-07-01T04:28:36","modified_gmt":"2026-07-01T04:28:36","slug":"ball-bells-help-troubleshooting-guide","status":"publish","type":"post","link":"https:\/\/www.mickeydesigns.com\/home\/ball-bells-help-troubleshooting-guide\/","title":{"rendered":"Ball Bells \u2014 Help &amp; Troubleshooting Guide"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\"><strong>Ball Bells \u2014 Help &amp; Troubleshooting Guide<\/strong><\/h1>\n\n\n\n<!-- Ball Bells \u2014 Help & Troubleshooting -->\n<!-- Paste this into a Custom HTML block in WordPress -->\n\n<style>\n.bb-guide { max-width: 800px; margin: 0 auto; font-size: 16px; line-height: 1.7; color: inherit; }\n.bb-guide h2 { font-size: 1.4em; margin: 2em 0 0.5em; padding-bottom: 0.3em; border-bottom: 1px solid #e0e0e0; }\n.bb-guide h3 { font-size: 1.1em; margin: 1.6em 0 0.4em; }\n.bb-guide p { margin: 0 0 1em; }\n.bb-guide ul, .bb-guide ol { margin: 0 0 1em 1.5em; padding: 0; }\n.bb-guide li { margin-bottom: 0.4em; }\n.bb-guide code { font-family: monospace; font-size: 0.9em; background: #f4f4f4; padding: 2px 5px; border-radius: 3px; }\n.bb-guide pre { background: #f4f4f4; border-left: 3px solid #ccc; padding: 1em; overflow-x: auto; border-radius: 3px; margin: 0 0 1em; }\n.bb-guide pre code { background: none; padding: 0; }\n.bb-guide table { width: 100%; border-collapse: collapse; margin: 0 0 1.5em; font-size: 0.95em; }\n.bb-guide th { background: #f4f4f4; text-align: left; padding: 8px 12px; border: 1px solid #ddd; font-weight: 600; }\n.bb-guide td { padding: 8px 12px; border: 1px solid #ddd; vertical-align: top; }\n.bb-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.bb-guide blockquote p:last-child { margin: 0; }\n.bb-guide a { color: inherit; }\n.bb-guide strong { font-weight: 600; }\n.bb-toc { background: #fafafa; border: 0.5px solid #ddd; border-radius: 4px; padding: 1rem 1.25rem; margin: 0 0 2em; }\n.bb-toc h3 { margin: 0 0 0.6em; }\n.bb-toc ol { margin: 0; }\n<\/style>\n\n<div class=\"bb-guide\">\n\n<p>A complete guide to playing, tuning, recording, and connecting Ball Bells on Apple Vision Pro. If you run into trouble, jump to the Troubleshooting section near the bottom.<\/p>\n\n<div class=\"bb-toc\">\n  <h3>Table of Contents<\/h3>\n  <ol>\n    <li><a href=\"#getting-started\">Getting Started<\/a><\/li>\n    <li><a href=\"#control-panel\">The Control Panel<\/a><\/li>\n    <li><a href=\"#playing\">Playing &amp; Arranging Bells<\/a><\/li>\n    <li><a href=\"#tuning\">Tuning to a Scale<\/a><\/li>\n    <li><a href=\"#recording\">Recording, Looping &amp; Overdubbing<\/a><\/li>\n    <li><a href=\"#saving\">Saving &amp; Sharing Your Work<\/a><\/li>\n    <li><a href=\"#midi\">Connecting MIDI<\/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<ol>\n  <li>Launch Ball Bells. You&#8217;ll see a welcome screen with a quick tour.<\/li>\n  <li>Tap &#8220;Let&#8217;s Make Some Bells.&#8221; This opens the immersive space and places a tuned arc of eight bells within arm&#8217;s reach.<\/li>\n  <li>Ring a bell two ways:\n    <ul>\n      <li><strong>Look and pinch<\/strong> \u2014 glance at a bell and pinch your thumb and index finger together.<\/li>\n      <li><strong>Reach and touch<\/strong> \u2014 extend your hand and tap the bell directly with a fingertip.<\/li>\n    <\/ul>\n  <\/li>\n  <li>The bell lights up, animates, and rings. The harder\/faster you move, the louder it sounds.<\/li>\n<\/ol>\n\n<p><strong>Tip:<\/strong> You don&#8217;t need to sign in, create an account, or connect anything. Everything works offline, out of the box.<\/p>\n\n<h2 id=\"control-panel\">The Control Panel<\/h2>\n\n<p>The window next to your bells has four tabs:<\/p>\n\n<table>\n  <thead>\n    <tr>\n      <th>Tab<\/th>\n      <th>What it does<\/th>\n    <\/tr>\n  <\/thead>\n  <tbody>\n    <tr>\n      <td><strong>Play<\/strong><\/td>\n      <td>Switch between Play\/Edit mode, add or delete bells, and open\/close the immersive space.<\/td>\n    <\/tr>\n    <tr>\n      <td><strong>Tune<\/strong><\/td>\n      <td>Pick a root note and scale, retune your bells, and save\/open bell setups.<\/td>\n    <\/tr>\n    <tr>\n      <td><strong>Record<\/strong><\/td>\n      <td>Record performances, loop, overdub, set tempo, quantize, and export.<\/td>\n    <\/tr>\n    <tr>\n      <td><strong>MIDI<\/strong><\/td>\n      <td>Send notes to other apps and devices.<\/td>\n    <\/tr>\n  <\/tbody>\n<\/table>\n\n<p>The transport bar (Record \/ Play buttons) stays visible at the bottom of the panel at all times.<\/p>\n\n<h2 id=\"playing\">Playing &amp; Arranging Bells<\/h2>\n\n<h3>Play mode vs. Edit mode<\/h3>\n\n<p>Use the Mode switch on the Play tab:<\/p>\n\n<ul>\n  <li><strong>Play mode<\/strong> \u2014 touching or pinching a bell rings it.<\/li>\n  <li><strong>Edit mode<\/strong> \u2014 pinch-grab a bell and move it anywhere in your space. Bells don&#8217;t ring while you&#8217;re arranging them.<\/li>\n<\/ul>\n\n<h3>Moving bells<\/h3>\n\n<ul>\n  <li><strong>In Edit mode:<\/strong> reach toward a bell, pinch to grab it, and drag it wherever you like \u2014 build a wide arc, stack a chord, or place bells above your desk.<\/li>\n  <li><strong>Precisely:<\/strong> select a bell and use the Position (X\/Y\/Z) sliders in the bell editor. Tap Reset in Front of Me to bring a lost bell back into view.<\/li>\n<\/ul>\n\n<h3>Adding &amp; removing bells<\/h3>\n\n<ul>\n  <li><strong>Add Bell<\/strong> (Play tab) drops in a new bell tuned to the next note in your scale.<\/li>\n  <li>Swipe a bell in the list to Delete it, or use Remove All to clear everything (this can&#8217;t be undone).<\/li>\n<\/ul>\n\n<h3>Customizing a bell<\/h3>\n\n<p>Select any bell to open its editor, where you can set:<\/p>\n\n<ul>\n  <li>Name, Color (12 choices), and Visual Size<\/li>\n  <li>Pitch (MIDI note) \u2014 the frequency updates automatically<\/li>\n  <li>Timbre \u2014 Classic Bell, Glass, Warm Chime, Gong, or Marimba<\/li>\n  <li>Decay (how long it rings) and Brightness (how much high-frequency shimmer)<\/li>\n  <li>Animation when rung \u2014 Bounce, Pulse, or Jiggle<\/li>\n  <li>MIDI channel and velocity<\/li>\n<\/ul>\n\n<p>Tap Test Ring to preview without reaching out.<\/p>\n\n<h2 id=\"tuning\">Tuning to a Scale<\/h2>\n\n<p>On the Tune tab:<\/p>\n\n<ol>\n  <li>Choose a Root note and a Scale (Major, Natural Minor, Major Pentatonic, Minor Pentatonic, Blues, or Chromatic).<\/li>\n  <li>Then apply it:\n    <ul>\n      <li><strong>Load Default Scale<\/strong> \u2014 replaces your bells with a fresh, tuned preset.<\/li>\n      <li><strong>Retune Bells to Scale<\/strong> \u2014 keeps your current bells but reassigns their pitches to the scale, in order.<\/li>\n      <li><strong>Snap Existing Pitches<\/strong> \u2014 nudges each bell to the nearest note in the scale, keeping them close to their current pitch.<\/li>\n    <\/ul>\n  <\/li>\n<\/ol>\n\n<h2 id=\"recording\">Recording, Looping &amp; Overdubbing<\/h2>\n\n<p>On the Record tab (and the transport bar):<\/p>\n\n<ol>\n  <li>Set your Tempo (BPM).<\/li>\n  <li>Tap Record, play your bells, then tap Stop.<\/li>\n  <li>Tap Play to hear it back. Tap Clear to discard it.<\/li>\n<\/ol>\n\n<p><strong>Options:<\/strong><\/p>\n\n<ul>\n  <li><strong>Loop playback<\/strong> \u2014 repeats your recording continuously. Set the Loop length in beats.<\/li>\n  <li><strong>Overdub while looping<\/strong> \u2014 with a loop playing, tap Overdub to layer new bells on top of the existing pattern.<\/li>\n  <li><strong>Metronome<\/strong> \u2014 a click track while recording or playing.<\/li>\n  <li><strong>Quantize<\/strong> \u2014 automatically snaps your strikes to Quarter, Eighth, or Sixteenth notes for a tighter feel. Set to Off to keep your exact timing.<\/li>\n<\/ul>\n\n<h2 id=\"saving\">Saving &amp; Sharing Your Work<\/h2>\n\n<ul>\n  <li><strong>Save\/Open Bells<\/strong> (Tune tab) \u2014 save a bell arrangement as a file and reload it later.<\/li>\n  <li><strong>Save\/Open<\/strong> (Record tab) \u2014 save a full performance (bells + recorded notes) as a file.<\/li>\n  <li><strong>Export MIDI<\/strong> (Record tab) \u2014 turn any recording into a standard <code>.mid<\/code> file you can drop into Logic, Ableton, GarageBand, or any DAW. Each bell&#8217;s channel, note, and velocity are preserved.<\/li>\n<\/ul>\n\n<p>Your current bells, recording, and settings are also saved automatically and restored the next time you open the app.<\/p>\n\n<h2 id=\"midi\">Connecting MIDI (Advanced, Optional)<\/h2>\n\n<p>On the MIDI tab. Both options are off by default.<\/p>\n\n<h3>CoreMIDI virtual source<\/h3>\n\n<p>Turn on CoreMIDI virtual source to make Ball Bells appear as a MIDI source named &#8220;BallBells&#8221; to other apps and connected devices. Each bell sends on its own channel with its configured note and velocity.<\/p>\n\n<h3>Raw MIDI over UDP<\/h3>\n\n<p>Turn on Raw MIDI over UDP to stream MIDI bytes to another device on your local network (for example, an ipMIDI client on a Mac).<\/p>\n\n<ul>\n  <li>Enter the Host (IP address) and Port of the receiving device.<\/li>\n  <li>The default port is 21928 (a common ipMIDI base port).<\/li>\n  <li>The status line shows the current connection state (ready, waiting, failed, etc.).<\/li>\n<\/ul>\n\n<h3>MIDI Panic<\/h3>\n\n<p>If a note gets stuck on a connected instrument, tap MIDI Panic to send an &#8220;all notes off&#8221; across every channel.<\/p>\n\n<h2 id=\"troubleshooting\">Troubleshooting<\/h2>\n\n<h3>I don&#8217;t see any bells<\/h3>\n\n<ul>\n  <li>Make sure the immersive space is open: on the Play tab, use the Open Immersive Space button.<\/li>\n  <li>A bell may have been moved out of view. Select it and tap Reset in Front of Me, or use Load Default Scale on the Tune tab to start fresh.<\/li>\n  <li>If the list is empty, tap Add Bell or Load Default Scale.<\/li>\n<\/ul>\n\n<h3>I can&#8217;t ring bells by touching them with my finger<\/h3>\n\n<ul>\n  <li>Fingertip touch and pinch-to-grab require Hand Tracking permission. The app asks for this when you open the immersive space.<\/li>\n  <li>If you declined it, you can still play by looking at a bell and pinching.<\/li>\n  <li>To grant it later: Settings \u2192 Privacy &amp; Security \u2192 Hand Tracking, and enable Ball Bells. Then reopen the immersive space.<\/li>\n<\/ul>\n\n<h3>Bells are too sensitive \/ not sensitive enough to touch<\/h3>\n\n<ul>\n  <li>Bells ring the moment a fingertip enters them. If you&#8217;re triggering them accidentally, switch to Edit mode while arranging, or space your bells farther apart.<\/li>\n  <li>Strike volume follows how fast you move \u2014 tap gently for soft notes, move quickly for loud ones.<\/li>\n<\/ul>\n\n<h3>No sound<\/h3>\n\n<ul>\n  <li>Check the Vision Pro volume with the Digital Crown, and make sure you&#8217;re not in a Focus\/mute state.<\/li>\n  <li>Ring a bell after the immersive space has fully opened \u2014 audio starts up with the space.<\/li>\n  <li>If audio was interrupted (a phone call, Siri, another app), the engine restarts automatically. If it stays silent, close and reopen the immersive space.<\/li>\n  <li>Try Test Ring in a bell&#8217;s editor to confirm sound independently of hand tracking.<\/li>\n<\/ul>\n\n<h3>The sound distorts, or some strikes don&#8217;t play<\/h3>\n\n<ul>\n  <li>This is expected protection, not a bug. To keep audio clean, Ball Bells limits how many bells ring at once and how rapidly a single bell can retrigger. Very fast swipes across many bells will intentionally drop some strikes rather than overload and distort.<\/li>\n  <li>For a cleaner sound with dense playing, lower each bell&#8217;s Brightness and shorten its Decay in the editor.<\/li>\n<\/ul>\n\n<h3>Playback sounds different from what I played<\/h3>\n\n<ul>\n  <li>If Quantize is on, your timing is snapped to the grid. Set Quantize to Off to preserve your exact performance.<\/li>\n  <li>Check that Tempo and Loop length match what you intended before recording.<\/li>\n<\/ul>\n\n<h3>I can&#8217;t tap Record<\/h3>\n\n<ul>\n  <li>Recording is disabled during playback unless Overdub while looping is turned on. Stop playback first, or enable overdub.<\/li>\n<\/ul>\n\n<h3>My MIDI device isn&#8217;t receiving notes<\/h3>\n\n<ul>\n  <li>Confirm the correct option is enabled on the MIDI tab and check the on-screen status line.<\/li>\n  <li><strong>CoreMIDI:<\/strong> the virtual source is named &#8220;BallBells&#8221; \u2014 select it as an input in the receiving app.<\/li>\n  <li><strong>UDP:<\/strong> double-check the Host IP and Port, and that both devices are on the same network. A failed status usually means the address or port is wrong or the receiver isn&#8217;t listening.<\/li>\n  <li><strong>Note:<\/strong> MIDI features are not available in the visionOS Simulator \u2014 test on a device.<\/li>\n  <li>If notes get stuck, tap MIDI Panic.<\/li>\n<\/ul>\n\n<h3>A file won&#8217;t open<\/h3>\n\n<ul>\n  <li>Ball Bells opens its own bell setup and recording files (and plain <code>.json<\/code> files it created). Files from other apps, or edited by hand, may not load.<\/li>\n<\/ul>\n\n<h3>I want to see the intro tour again<\/h3>\n\n<ul>\n  <li>On the transport bar, tap Show Intro Again.<\/li>\n<\/ul>\n\n<h3>I want to start completely over<\/h3>\n\n<ul>\n  <li>Use Remove All (Play tab) to clear your bells, then Load Default Scale (Tune tab) for a fresh set. Use Clear on the transport bar to delete the current recording.<\/li>\n<\/ul>\n\n<h2 id=\"privacy\">Privacy<\/h2>\n\n<p>Ball Bells collects no personal data, has no accounts, and makes no network connections \u2014 except the optional Raw MIDI over UDP feature, which only sends MIDI data to the address you enter, and only when you turn it on. Hand-tracking data is used solely on-device to detect when you touch a bell and is never stored or transmitted.<\/p>\n\n<h2 id=\"support\">Still need help?<\/h2>\n\n<p>Contact us at <code>info@mickeydesigns.com<\/code> and include your Vision Pro&#8217;s visionOS version and a short description of what happened. If it&#8217;s about sound or MIDI, let us know how many bells you were playing and which features (loop, overdub, CoreMIDI, UDP) were active.<\/p>\n\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Ball Bells \u2014 Help &amp; Troubleshooting Guide A complete guide to playing, tuning, recording, and connecting Ball Bells on Apple Vision Pro. If you run into trouble, jump to the Troubleshooting section near the bottom. Table of Contents Getting Started The Control Panel Playing &amp; Arranging Bells Tuning to a Scale Recording, Looping &amp; Overdubbing &#8230; <a title=\"Ball Bells \u2014 Help &amp; Troubleshooting Guide\" class=\"read-more\" href=\"https:\/\/www.mickeydesigns.com\/home\/ball-bells-help-troubleshooting-guide\/\" aria-label=\"Read more about Ball Bells \u2014 Help &amp; Troubleshooting Guide\">Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":688,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"elementor_header_footer","format":"standard","meta":{"footnotes":""},"categories":[20],"tags":[],"class_list":["post-692","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\/692","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=692"}],"version-history":[{"count":1,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/692\/revisions"}],"predecessor-version":[{"id":693,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/692\/revisions\/693"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/media\/688"}],"wp:attachment":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/media?parent=692"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/categories?post=692"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/tags?post=692"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}