Skip to main content

Bookish Music User Guide

📱 Bookish Music - User Guide

Welcome to Bookish Music, your offline-capable Adventist songs lyric companion! This guide will help you get the most out of the app.

🚀 Getting Started

First Time Setup

  1. Visit the App: Navigate to the Bookish Music website: https://bookish-music.vercel.app/
  2. Install as PWA: When prompted, tap “Add to Home Screen” or “Install App”
  3. Initial Download: The app will download all songs (~100 songs, 500KB-2MB)
  4. Progress Indicator: Watch the “Downloading songs… X%” progress bar
  5. Ready to Use: Once complete, you can use the app offline!

PWA Installation

On Mobile (iOS/Android):

  • Look for the “Add to Home Screen” prompt
  • Or use browser menu → “Add to Home Screen”
  • App icon will appear on your home screen

On Desktop:

  • Look for the install icon in the address bar
  • Or use browser menu → “Install Bookish Music”

🎵 Finding Songs

1. Search Songs

  • Real-time Search: Type in the search bar - results appear as you type
  • Search Fields: Searches song titles, composers, and lyrics content
  • Case-insensitive: Works with any capitalization
  • Instant Results: No need to press enter

2. Browse by Tags

  • Navigate: Menu → “🏷️ Browse by Tags”
  • Filter Options:
    • Language Tags: English, Tok Pisin, Boikin, etc.
    • Theme Tags: Worship, Birth of Jesus, Ressurection, Bible Story, Traditional, Contemporary, Gospel, Hymn, Grace, Salvation, Peace, Love, Faith, Hope, Joy
  • Multi-select: Choose multiple tags to see songs matching any selected tag
  • Clear Filters: Tap selected tags again to remove them

3. Browse Alphabetically

By Song Title:

  • Navigate: Menu → “📝 Browse by Title”
  • A-Z Index: Tap any letter to jump to that section
  • Infinite Scroll: Scroll through songs within each letter

By Composer:

  • Navigate: Menu → “👤 Browse by Composer”
  • A-Z Index: Tap any letter to jump to composers starting with that letter
  • Infinite Scroll: Browse through all composers

4. Recently Viewed

  • Automatic Tracking: Last 10 songs you viewed are saved
  • Quick Access: Find recently viewed songs in the sidebar or menu
  • Clear History: Option to clear your viewing history

📖 Reading Songs

Song Display

  • Clean Layout: Song title, composer, and lyrics prominently displayed
  • Metadata: Expandable section with key, tempo, tags, and copyright info
  • Shareable URLs: Each song has a unique URL you can share

Reading Tools

🔤 Font Size Adjustment:

  • Three Sizes: Small, Medium, Large
  • Easy Controls: Use buttons or slider to adjust
  • Saved Preference: Your choice is remembered

🌙 Dark Mode:

  • Auto-Detection: Matches your device’s theme by default
  • Manual Toggle: Switch between light and dark themes
  • Smooth Transition: Seamless switching between modes
  • Saved Preference: Your choice is remembered

📜 Auto-Scroll:

  • Toggle Control: Turn on/off with button
  • Default: OFF when song opens (you control when to start)
  • Speed Options: Slow, Medium, Fast (or use slider)
  • Pause/Resume: Control scrolling as needed
  • Saved Settings: Speed preference is remembered

📋 Copy to Clipboard:

  • One-Click Copy: Button to copy all lyrics text
  • Visual Confirmation: See confirmation when copy succeeds
  • Share Easily: Paste lyrics into messages, emails, etc.

🔧 App Management

Offline Usage

  • Automatic Caching: All songs cached during first download
  • No Internet Required: Browse and read songs without connection
  • Sync When Online: App updates silently when you’re back online
  • Status Indicators: See offline/syncing/synced status in header

PWA Reset (Developer Tools)

When to Use:

  • App seems outdated or buggy
  • Want to force fresh download of songs
  • Troubleshooting issues
  • Clear accumulated cached data

How to Reset:

  1. Navigate: Menu → “ℹ️ About” → “🔧 Developer Tools”
  2. Or: Use reset button in navigation menu
  3. Click: “🔄 Reset PWA Data” button
  4. Review Warning: Read what will be cleared
  5. Confirm: Click “✅ Yes, Reset Everything” (or Cancel to abort)
  6. Wait: App shows “🔄 Resetting…” progress
  7. Automatic Reload: Page reloads with fresh data

⚠️ Warning: Reset clears all cached songs - you’ll need to re-download them.

Contact & Feedback

Report Issues or Request Songs:

  1. Navigate: Menu → “📧 Contact”
  2. Fill Form: Name, message, and optionally select a song
  3. Submit: Opens your email client with pre-filled information
  4. Send: Complete the email and send

📱 Mobile Optimization

Touch-Friendly Design

  • Large Touch Targets: Easy to tap buttons and links
  • Swipe Navigation: Smooth scrolling and navigation
  • Responsive Layout: Adapts to all screen sizes

Performance

  • Fast Loading: Optimized for mobile networks
  • Smooth Scrolling: Infinite scroll with good performance
  • Battery Efficient: Minimal background processing

Accessibility

  • Screen Reader Support: Works with accessibility tools
  • High Contrast: Good visibility in all lighting conditions
  • Focus Indicators: Clear focus states for keyboard navigation

🎯 Tips & Tricks

Search Tips

  • Partial Words: Search works with partial song titles or lyrics
  • Multiple Terms: Use multiple words to narrow results
  • Composer Search: Search by composer name to find all their songs

Browsing Tips

  • Tag Combinations: Use multiple tags to find specific types of songs
  • Alphabet Navigation: Use A-Z index for quick jumping
  • Recently Viewed: Quick way to return to songs you were reading

Reading Tips

  • Auto-Scroll Speed: Adjust to match your reading pace
  • Font Size: Choose size that’s comfortable for your device
  • Dark Mode: Use in low-light conditions to reduce eye strain

Offline Tips

  • Download First: Make sure to visit the app online first to cache songs
  • Check Status: Look for offline/synced indicators in the header
  • Periodic Sync: Connect to internet occasionally for updates

❓ Troubleshooting

App Won’t Load

  1. Check Internet: Ensure you have internet connection for first visit
  2. Clear Cache: Use the PWA Reset button
  3. Reinstall: Remove app and reinstall from browser

Songs Not Appearing

  1. Wait for Download: Check if initial download is still in progress
  2. Check Connection: Ensure stable internet during first download
  3. Reset App: Use PWA Reset to force fresh download

Search Not Working

  1. Check Spelling: Verify search terms are spelled correctly
  2. Try Different Terms: Use alternative words or partial matches
  3. Clear Search: Clear search bar and try again

Offline Mode Issues

  1. Initial Download: Ensure you completed first online visit
  2. Check Status: Look for offline indicator in header
  3. Reset Cache: Use PWA Reset to refresh cached data

🔄 Updates & Versions

Automatic Updates

  • Silent Updates: App updates automatically when online
  • No User Action: Updates happen in background
  • Version Display: Check current version in About page

Manual Refresh

  • PWA Reset: Force complete refresh of all data
  • Browser Refresh: Standard page refresh for minor issues
  • Reinstall: Remove and reinstall app for major issues

📞 Support

Getting Help

  • Contact Form: Use in-app contact form for support
  • Email Direct: Contact developers directly via email
  • Bug Reports: Include device info and steps to reproduce issues

Feature Requests

  • Contact Form: Use to suggest new features
  • Song Requests: Request specific songs to be added
  • Improvement Ideas: Share ideas for app enhancements

🎵 Enjoy Your Music!

Bookish Music is designed to be your reliable companion for Adventist song lyrics, whether you’re online or offline. Take advantage of the PWA features to have your music library always available in your pocket!

Happy singing! 🎤

Comments

Post a Comment

Popular posts from this blog

Telecoms: ePSK - Multiple Pre-Shared Keys

Originally posted on the Cambium Community Networks Just in case you missed it cnMaestro Version 2.2.1 (Cloud and On-Premise), brings us a great new feature called ePSK. If you’re not familiar with ePSK it’s maybe because Cambium are too modest to toot their own trumpet so I’m going to do it for them. In short ePSK gives each user a unique PSK (pre-shared key) when using WPA2-Personal, for me to explain why this is such a useful feature let me first explain the problem with using a shared PSK across the whole WLAN. When a wireless client connects to an AP it completes a 4-Way handshake, this generates the encryption keys used to encrypt wireless traffic. For the 4-way handshake to work it is a requirement that both the client and AP know the passphrase, however the passphrase is never transmitted over the air thereby making this exchange reasonably secure. But what happens when a 3rd party already knows the passphrase? It means they just need to capture the 4-way handshake to gener...
Post a Comment
Read more

💡 The CML VM Fix: Solving My VT-x/EPT Problem

💡 The Complete Fix: CML VT-x/EPT Error Solved 🛠️ I battled the persistent error: "Virtualized Intel VT-x/EPT is not supported on this platform" while installing CML (Cisco Modeling Labs) on VMware. This problem occurs because the Windows host locks the CPU's hardware virtualization features (VT-x/EPT) that CML needs to run its internal network nodes. I discovered that fixing this requires aggressively disabling Virtualization-based security (VBS) and HVCI across multiple system layers. Here is the definitive, comprehensive guide covering every step necessary to solve this issue. Step 1: The Quick Fix (Disable Nested VT-x in VMware) I found that telling VMware to hide the feature initially allowed the CML VM to boot, but it failed later when trying to run network nodes. This must be reversed later, but it is an important diagnostic step. Power off the CML VM. Go to Settings → Processors . Ensure the box for Virtualize Intel ...
Post a Comment
Read more

7 Apps You Should Delete Right Now And Why the Law Makes Them Dangerous

  There is a conversation happening in security research circles, government agencies, and regulatory bodies around the world, and most Papua New Guineans are not part of it. It concerns a small group of applications that sit on hundreds of millions of Android and iOS devices, including many in PNG, quietly running in the background, collecting data, and transmitting that data to servers governed by a legal system that has no obligation to protect you. In PNG, where mobile phones are the primary gateway to banking, communication, and identity, this risk is amplified. For many users, a smartphone is not just a device. It is their wallet, their ID, and their connection to essential services. This is not about a theoretical vulnerability or an obscure technical exploit. It is about the intersection of consumer software and national law, specifically the legal architecture that governs what foreign technology companies must do when their government asks for your data. The Legal Foun...
Post a Comment
Read more