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

Trump’s Policies and Their Impact on Papua New Guinea and the Pacific Islands

With Donald Trump taking office as the 47th president of the United States, his administration quickly embarked on sweeping and polarizing policy changes. Through a series of executive orders, Trump underscored his administration's focus on reshaping U.S. policies in areas such as immigration, trade, climate, and foreign aid. While these efforts are primarily centered on advancing U.S. domestic interests, their repercussions are set to ripple across the globe, especially in regions like the Pacific Islands, where economic and environmental challenges are deeply tied to global policies. For Papua New Guinea (PNG) and its Pacific neighbors, Trump’s policies pose both challenges and potential opportunities. These small island nations depend heavily on international trade, foreign aid, and climate action, all of which are areas of uncertainty under the new administration. Key decisions, such as the U.S. withdrawal from the Paris Climate...
Post a Comment
Read more

Defending Freedom of Speech: The Implications of Facebook Censorship in Papua New Guinea

The Papua New Guinea (PNG) government's recent move to regulate Facebook has sparked significant debate. Citing concerns over misinformation and social unrest, authorities have tested ICT controls to monitor and potentially restrict access to the platform. While the intention is to promote responsible social media use, this action raises critical questions about freedom of expression in the country. The Government's Justification for Facebook Regulation Authorities argue that Facebook has become a conduit for malicious content, including fake news and defamatory material, which could endanger public safety. By implementing a temporary ban or stricter controls, they aim to assess the platform's impact and develop strategies to mitigate these risks. This approach, they claim, is necessary to maintain social harmony and protect citizens from harmful content. However, this rationale has been met with skepticism. Critics contend that such measures...
Post a Comment
Read more