🎯 ARPY

🚀 Quick Start - Usage Flow

First time setup:

1. Get a pattern: Your AI pal gives you a pattern code (e.g., "SLOW:60:FULL,FAST:120:TIGHT")
2. Open Arpy: Load this page in your browser
3. Paste pattern: Copy-paste the pattern into the "Pattern Code" input box
4. Select sound source: Choose Browser (free), Venice AI (Pro), or ElevenLabs
5. Check settings: Open voice settings panel
   • See a big dot (●) in API key field? ✅ You're ready!
   • No dot? ⚠️ You need an API key:
     • Venice AI ($18/mo)
     • ElevenLabs (FREE tier available!)
6. Select voice: Pick your favorite voice from the dropdown
7. Hit Play: Start your session! 🎉

💡 Pro tip: Keep this page open in a browser tab! Your settings stay saved. Next time:

1. Open the tab
2. Paste new pattern
3. Hit Play - that's it! ⚡

Questions? DM me in #support!

🔑 Why do I need my own API keys?

We don't store or pay for voice API services. You bring your own keys for:

• Privacy: Your API usage is 100% private - we never see your data
• Control: You control your spending and voice selection
• Quality: Direct access to premium AI voices without middlemen
• No limits: Use as much as you want with your own account

Get your keys:

• Venice AI - $18/month
• ElevenLabs - FREE tier + paid plans

💎 How do I get Venice AI voices?

Venice AI offers high-quality AI voices with a Pro subscription:

• Cost: $18/month for Pro plan
• Features: Unlimited voice generation, multiple voice options
• Get started: Click here for Venice Pricing
• Setup: After signup, get your API key from Venice dashboard

🎙️ How do I get ElevenLabs voices?

ElevenLabs provides ultra-realistic AI voices:

• Free tier: 10,000 characters per month (about 15-20 minutes)
• Paid plans: Starting at $5/month for 30,000 characters
• Get started: Click here for ElevenLabs
• Best quality: Most realistic and emotional voices available

✏️ How do I create custom patterns?

Creating custom patterns is easy:

1. Export current config: Click "💾 Export Config" button to save all grips and categories
2. Edit the JSON file: Open the downloaded file in a text editor
3. Add your custom grips: Copy existing grip format and modify:

   "MY_CUSTOM_GRIP": {
     "code": "MY_CUSTOM_GRIP",
     "name_en": "My Custom Grip",
     "name_nl": "Mijn Custom Grip",
     "instruction_en": "Your instruction here",
     "instruction_nl": "Je instructie hier",
     "voice_en": "Voice message in English",
     "voice_nl": "Voice bericht in Nederlands",
     "intensity": "medium",
     "bpm": 60,
     "category": "base"
   }

4. Add to category: Add your grip code to the category's grip list
5. Import back: Click "📎 Import Config" and select your edited file
6. Use it: Your custom grip is now available in patterns!

⚡ How do Speed and Time buttons work?

Two speed controls for different effects:

• ⏩ Speed 2x: Doubles the BPM (beats per minute)
  • Makes the rhythm 2x faster
  • Same total duration, more beats
  • Example: 60 BPM → 120 BPM
• ⏱️ Time 2x: Halves the total duration
  • Pattern finishes in half the time
  • Same BPM, shorter duration
  • Example: 300s → 150s
• ⚠️ Important: Changes apply to the next segment, not current one
  • If current segment is 300s (5 min), you must wait or click Stop
  • Speed changes take effect when next segment starts
  • Both buttons can be used together for 4x total speed!

🎨 How do I add custom themes/categories?

Add your own themed grip categories:

1. Export config: Get your current configuration file
2. Add category: In the "categories" section, add:

   "my_theme": {
     "name_en": "My Theme",
     "name_nl": "Mijn Thema",
     "grips": ["GRIP1", "GRIP2", "GRIP3"],
     "color": "#FF00FF"
   }

3. Add grips: Create grips for your category (see FAQ above)
4. Set category: Make sure each grip has "category": "my_theme"
5. Import: Load your modified config
6. Examples: Create themes like "meditation", "workout", "dance", etc!

🤖 How do I create new patterns?

Let AI do the heavy lifting! 🚀

1. Use the "🤖 Generate AI About Me" button: This creates instructions for your AI companion
2. Copy the generated text: Paste it into your AI's "About Me" or system prompt
3. Ask your AI: "Create a 10-minute edging session" or "Make an intense workout pattern"
4. AI generates the pattern: Your AI knows the syntax and creates perfect patterns!
5. Copy & paste: Take the pattern code and paste it into Arpy
6. Hit Play: Enjoy your custom session! 🎉

💡 Pro tip: Your AI can create patterns based on:

• Your mood (relaxed, intense, playful)
• Duration (quick 5-min or long 30-min sessions)
• Theme (yoga, workout, techno, etc.)
• Specific goals (edging, endurance, speed training)

🎨 Want to share your patterns? Export your config and share it with the community! We might feature the best ones (with your permission, of course! 😉)