LockedPillar User Manual

Table of Contents

• 1. Introduction
• 2. Getting Started
• 3. Managing Your Library
• 4. Creating and Importing Content
• 5. Practice Modes
• 6. Using the My Words Dictionary
• 7. Security and Privacy
• 8. Installation and Offline Use
• 9. Backup and Sync
• 10. Tips and Best Practices
• 11. Troubleshooting

1. Introduction

What is LockedPillar?

LockedPillar is a powerful line memorization and practice application designed to help you master speeches, theatrical performances, poetry, rituals, and any other text that requires accurate recall. Using advanced speech recognition technology, LockedPillar provides real-time feedback on your delivery, helping you perfect your performance.

Key Features

2. Getting Started

First Time Setup

When you first open LockedPillar, you'll see the main library view. Here's how to get started:

1. Explore the Public Library: Browse pre-loaded public domain content including Shakespeare plays, classic poetry, and more.
2. Try a Practice Session: Tap any set's "Practice" button to start. We recommend beginning with "Read Lines" mode to familiarize yourself with the interface.
3. Create Your First Set: Tap the "+" button to create your own content (see Creating Content).

Understanding the Interface

Library View: Your home screen showing all available content as horizontal scrolling cards. Swipe left or right to browse.

Search Bar: Type to instantly filter sets by title, author, or category.

Category Filter: Dropdown menu to view only sets from a specific category.

Navigation: The breadcrumb trail at the top shows your current location and provides quick navigation back to the library.

3. Managing Your Library

The Two-Library System

LockedPillar maintains two separate libraries:

Public Library: Verified public domain content that's safe to share. These sets cannot be deleted or edited, but you can duplicate them to create your own modified versions.

Personal Library: Your own created or imported content. You have full control to add, edit, delete, and reorganize these sets.

Finding Content

Search: As you type in the search bar, the library automatically filters to show matching sets. Search looks through titles, authors, and categories.

Category Filtering: Use the dropdown to view only sets from specific categories like "Shakespeare," "Poetry," "Masonic Ritual," or "Custom."

Favorites: Mark your most-used sets as favorites by tapping the heart icon. You can have up to 5 favorites per library. Favorited sets appear at the top with a golden heart indicator.

Organizing Your Personal Library

Reordering Sets: In your personal library, each set has a drag handle icon (☰). Tap and hold this icon, then drag the set to your desired position. Your new order is automatically saved.

Duplicating Sets: To create a copy of any set (public or personal), tap the duplicate icon. This creates an exact copy in your personal library with "-copy" added to the title. You can then edit this copy as needed.

Deleting Sets: Tap the trash icon on any personal library set to permanently delete it. Public library sets cannot be deleted.

4. Creating and Importing Content

Creating Your First Set

1. Tap the "+" button in the library view
2. Fill in the form:
   • Title: The name of your set (e.g., "Hamlet Act 3 Scene 1")
   • Author: Who wrote it (optional)
   • Description: Brief summary or notes
   • Category: Choose from existing categories or create a new one
   • Tags: Comma-separated keywords for searching
   • Lines: Enter your lines, one per line
3. Tap "Save" to add it to your personal library

Editing Existing Sets

1. Tap the edit icon (pencil) on any personal library set
2. Make your changes to any field
3. Tap "Save" to update

Changes save immediately to your device. Your original set ID and creation date are preserved.

Importing Content

From JSON Files

1. Tap the import button in the library header
2. Select "Import from JSON"
3. Choose your JSON file
4. Review the preview
5. Tap "Confirm Import"

The imported content will be added to your personal library. If there are duplicate IDs, you'll be prompted to skip, replace, or create new entries.

From Encrypted Files

If you've received a password-protected library file:

1. Select the encrypted file
2. Enter the password when prompted
3. The file will be decrypted using AES-256-GCM encryption
4. Review and confirm the import

Exporting Content

Export a Single Set

1. Tap the export icon on any set
2. Choose whether to encrypt with a password (recommended for sensitive content)
3. If encrypting, enter and confirm your password
4. Save the JSON file to your device

Export Your Entire Library

1. Tap the export button in the library header
2. Choose "Export Full Library"
3. Optionally add password protection
4. Save the backup file

Your export includes all personal library sets and your My Words dictionary.

5. Practice Modes

LockedPillar offers three distinct practice modes, each designed for different stages of memorization.

Mode 1: Read Lines

Best for: Initial learning, improving delivery, and perfecting pronunciation.

How it works:

1. Each complete line appears on screen
2. Tap "Record" or press the spacebar to start recording
3. Read the line aloud
4. Recording automatically stops after 2 seconds of silence
5. View your accuracy score and detailed feedback

Understanding Feedback:

• Green text: Words you spoke correctly
• Red text: Words that were incorrect or missed
• Percentage score: Overall accuracy (75%+ needed for auto-progression)

Navigation:

• Previous/Next buttons: Move through lines sequentially
• First Line button: Jump back to the beginning
• Slider: Drag to any line in the set
• Go to Line: Type a line number and press Enter

Mode 2: Fill in the Blanks

Best for: Testing comprehension and strengthening recall of specific word types.

How it works:

1. Lines appear with certain words replaced by blank spaces (_____)
2. Speak the complete line, filling in the blanks
3. The app compares your speech to the original text

Difficulty Levels:

• Easy: Removes only nouns and verbs
• Medium: Adds adjectives and adverbs
• Hard: Includes function words (articles, prepositions, conjunctions)

Refresh Feature: Tap the refresh button to generate new blanks from the same line, allowing repeated practice with different challenges.

Mode 3: Recite from Prompt

Best for: Advanced memorization testing with minimal cues.

How it works:

1. Only the first few words of each line appear as a prompt
2. Recite the entire line from memory
3. The app validates your complete recitation

Hint Feature: Press and hold on the prompt text to temporarily reveal the full line. Release to hide it again. This is perfect for quick memory checks without moving to the next line.

Auto Progression Mode

Enable hands-free practice with Auto Progression:

1. Toggle "Auto Progression" checkbox in any practice mode
2. Recording starts automatically when the line loads
3. After 2 seconds of silence, your speech is automatically scored
4. If you score 75% or higher, the app advances to the next line
5. If below 75%, you'll need to retry the line

Audio Cues:

• Success tone: You've advanced to the next line
• Retry tone: Score below threshold, try again
• Completion tone: You've finished the entire set

Recording Controls

Start Recording: Tap the record button or press spacebar

Stop Recording: Tap the square stop button to cancel a recording without scoring (useful for false starts)

Submit: After recording stops, tap submit to process and score your attempt

Visual Feedback: The record button displays your current mode:

• 🎤 Record: Online mode - full speech recognition available
• 🎤 Record (Offline): Using on-device speech recognition
• 📴 Offline - Unavailable: Speech recognition not available offline

Multi-Language Speech Recognition

LockedPillar supports speech recognition in multiple languages, allowing you to practice content in different languages or match your preferred speaking language.

Supported Languages:

• English (US)
• Portuguese (Brazil)
• French
• Spanish
• Italian

Changing Language:

1. Tap the Help icon (?) in the header
2. Scroll to the Speech Recognition Language section
3. Select your preferred language from the dropdown
4. Your selection is saved automatically

Online and Offline Recognition:

Speech recognition works differently depending on your connection:

• Online Mode: Uses cloud-based recognition for highest accuracy across all languages
• Offline Mode: Uses on-device recognition if available on your device and browser
• Automatic Fallback: The app automatically switches between online and offline modes

Bookmark System

Mark important lines for quick access and easy navigation during practice sessions.

Adding Bookmarks:

Tap the bookmark icon (📑) next to the line progress indicator to bookmark the current line. The icon changes to 🔖 when a line is bookmarked.

Navigating Bookmarks:

Use the bookmark navigation controls in the practice interface:

• ← Prev: Jump to the previous bookmarked line
• Next →: Jump to the next bookmarked line
• Bookmark Count: See how many lines you've bookmarked (e.g., "🔖 Bookmarks (3)")

Visual Indicators:

Bookmarked lines are shown on the line slider with visual markers, making it easy to see where your important lines are located in the set.

Per-Set Bookmarks:

Bookmarks are saved individually for each content set. When you switch between sets, your bookmarks are automatically loaded and saved.

Mobile Navigation Buttons

For mobile users and touch-enabled devices, LockedPillar provides dedicated circular navigation buttons:

• ‹ Button: Navigate to the previous line
• › Button: Navigate to the next line

These large, touch-friendly buttons appear below the text display and work on all devices, including desktop browsers with touch screens.

6. Using the My Words Dictionary

The My Words dictionary helps LockedPillar correctly recognize uncommon terms, proper names, technical jargon, and specialized vocabulary that might not be in standard dictionaries.

When to Use My Words

Add words to your dictionary when the speech recognition:

• Doesn't recognize character names (e.g., "Iago," "Lysander")
• Misinterprets technical terms
• Struggles with regional dialect words
• Confuses homophones (words that sound similar)
• Fails to recognize proper nouns

Adding a Word

1. Go to Settings or My Words section
2. Tap "Add Word"
3. Enter the written form: How the word appears in your text (e.g., "Macbeth")
4. Enter the phonetic form: How you pronounce it (e.g., "mack beth" or "mak beth")
5. Tap "Save"

Managing Your Dictionary

Edit: Tap the edit icon next to any entry to refine the phonetic spelling

Delete: Remove entries you no longer need with the trash icon

Export/Import: Your My Words dictionary is automatically included when you export your full library, making it easy to share between devices.

How It Works

Once added, dictionary entries apply automatically across all sets in both libraries. When you speak during practice, LockedPillar checks your audio against the phonetic forms and displays the proper written forms in the feedback.

7. Security and Privacy

LockedPillar takes your privacy seriously. All data stays on your device, and sensitive content can be protected with biometric authentication or PIN codes.

Automatic Protection for Masonic Ritual

Setting Up Security

Biometric Authentication (Recommended)

If your device supports fingerprint, facial recognition, or other biometric security:

1. Go to Settings > Security
2. Select "Set up Biometric Authentication"
3. Follow your device's prompts to register
4. Your biometric credential is stored locally on your device only

Supported Biometrics:

• Fingerprint scanners
• Face ID / facial recognition
• Iris scanners
• Windows Hello
• Other platform authenticators

PIN Code Setup

1. Go to Settings > Security
2. Select "Set up PIN"
3. Enter a 4-6 digit PIN
4. Confirm your PIN
5. Your PIN is encrypted and stored locally

Security Features:

• Three incorrect attempts trigger a 1-minute lockout
• Lockout persists even if you refresh the page
• PINs are hashed using SHA-256 encryption

Protecting Your Content

To lock any personal library set:

1. Edit the set
2. Check the "Require Authentication" box
3. Save your changes

Locked sets display a padlock icon (🔒) on their practice button.

Practice Sessions

When you authenticate to practice locked content:

• A 30-minute session begins
• You can access all locked content during this time
• A countdown timer displays in the header (e.g., ⏱️ 24:15)
• Re-authenticate when the session expires

Manual Logout: Tap the logout button to immediately end your authenticated session.

Your Privacy Guaranteed

8. Installation and Offline Use

Installing as a Progressive Web App (PWA)

LockedPillar can be installed on your device to work like a native app:

On Desktop (Windows, Mac, Linux)

1. Open LockedPillar in Chrome, Edge, or another supported browser
2. Look for the install prompt (usually in the address bar)
3. Click "Install" or "Add to Desktop"
4. Launch from your applications menu

On Mobile (iOS, Android)

iOS (Safari):

1. Tap the Share button
2. Select "Add to Home Screen"
3. Name the app and tap "Add"

Android (Chrome):

1. Tap the menu (three dots)
2. Select "Install app" or "Add to Home Screen"
3. Confirm the installation

Benefits of Installing

• Offline Access: Practice anywhere without an internet connection
• Faster Performance: The app loads instantly from your device
• Native Experience: No browser UI—just the app
• Home Screen Icon: Quick access like any other app
• Automatic Updates: The app checks for updates when online

Offline Functionality

Once installed, LockedPillar works completely offline:

• All practice modes available
• Speech recognition (using browser's offline capabilities)
• Full library access
• Create, edit, and delete content
• All settings and security features

Updating the App

LockedPillar automatically checks for updates when online:

1. When an update is available, you'll see a notification
2. Tap "Refresh" or reload the page to install
3. The app will update to the latest version

Manual Update Check: Tap the version number in the header to view current version information and check for updates.

9. Backup and Sync

Since LockedPillar stores all data locally, you're in complete control of backups and synchronization.

Creating Backups

Full Library Backup (Recommended)

1. Tap Export in the library header
2. Select "Export Full Library"
3. Choose whether to password-protect (recommended)
4. Save the JSON file to a safe location

Individual Set Backup

Export specific sets when sharing with others or creating targeted backups:

1. Tap the export icon on any set
2. Optionally add password protection
3. Save the JSON file

Transferring to Another Device

Method 1: Cloud Storage (Recommended)

1. Export your library on Device A
2. Save to Dropbox, Google Drive, OneDrive, etc.
3. Download on Device B
4. Import into LockedPillar

Method 2: Direct Transfer

1. Export on Device A
2. Email the file to yourself
3. Open email on Device B
4. Download and import

Method 3: USB Transfer

1. Export on Device A
2. Save to USB drive
3. Connect to Device B
4. Import the file

Import Behavior

New Sets: Added to your personal library

Duplicate IDs: You'll be prompted to:

• Skip (keep existing version)
• Replace (overwrite with imported version)
• Create New (add with new ID)

My Words Dictionary: Entries are merged:

• New words are added
• Existing words are updated with imported versions

Multi-Device Strategy

Since there's no automatic sync:

1. Designate a Primary Device: Make most changes on one device
2. Regular Exports: Export after significant changes
3. Import to Secondary Devices: Update other devices as needed
4. Version Control: Name backup files with dates (e.g., "LockedPillar_Backup_2025-10-10.json")

10. Tips and Best Practices

Memorization Tips

Progressive Difficulty: Start with Read Lines, move to Fill in the Blanks (Easy → Medium → Hard), then finish with Recite from Prompt.

Regular Practice: Short, frequent sessions (15-20 minutes) are more effective than long, infrequent ones.

Use Auto Progression: Let the app pace you automatically while focusing on delivery rather than navigation.

Record Yourself: Pay attention to feedback highlighting to identify persistent problem areas.

Practice Variations: Use the Refresh feature in Fill in the Blanks mode to keep your mind engaged.

Content Organization

Meaningful Categories: Create categories that match your workflow (e.g., "Work Presentations," "Wedding Speech," "Poetry Slam").

Consistent Naming: Use clear, descriptive titles like "Hamlet - To Be or Not To Be" rather than "H1" or "Scene 3".

Use Tags: Add searchable tags for themes, emotions, or performance contexts.

Break Long Pieces: Split very long content into manageable sets (e.g., separate acts of a play).

Leverage Favorites: Mark your current active projects as favorites for instant access.

Speech Recognition Tips

Speak Clearly: Natural pacing and clear enunciation work best. No need to over-pronounce.

Quiet Environment: Background noise can affect recognition accuracy.

Consistent Volume: Maintain steady volume; avoid trailing off at line ends.

Add to My Words: If a word consistently fails to recognize, add it to your dictionary.

Test Your Setup: Try a familiar set first to verify your microphone is working properly.

Security Best Practices

Strong PINs: Avoid obvious patterns (1234, 1111). Use random 6-digit codes for better security.

Regular Backups: Export encrypted backups of sensitive content to cloud storage.

Lock Sensitive Content: Even non-Masonic content can be locked for privacy.

Session Management: Log out when practicing in public or on shared devices.

Performance Tips

Regular Cleanup: Delete unused sets to keep your library manageable.

Clear Old Exports: Remove downloaded export files you no longer need.

Browser Cache: Clear browser cache occasionally if app feels sluggish.

Update Regularly: Keep LockedPillar updated for best performance and latest features.

11. Troubleshooting

Speech Recognition Issues

Problem: App doesn't recognize my speech

Solutions:

• Check microphone permissions in browser settings
• Try a different browser (Chrome works best)
• Ensure microphone isn't muted or used by another app
• Test microphone in browser settings or other apps
• Move to a quieter location
• Speak more clearly and at moderate volume

Problem: Specific words never recognized correctly

Solution: Add them to My Words dictionary with phonetic spellings that match how you pronounce them.

Problem: Recognition works sometimes but not others

Solutions:

• Check for background noise
• Ensure stable microphone connection
• Try restarting the browser
• Verify Auto Progression isn't ending recording too quickly

Installation Issues

Problem: Can't find install option

Solutions:

• Use Chrome, Edge, or Safari (Firefox has limited PWA support)
• Visit the app via HTTPS, not HTTP
• Look for icon in address bar or browser menu
• Try "Add to Home Screen" on mobile

Problem: Installed app won't open offline

Solution:

• Open once while online to cache all resources
• Check that service worker installed successfully
• Reinstall the app

Import/Export Problems

Problem: Import fails with error message

Solutions:

• Verify JSON file isn't corrupted (open in text editor)
• Check file wasn't partially downloaded
• Ensure file format matches expected structure
• Try exporting from source device again

Problem: Can't decrypt password-protected file

Solutions:

• Verify password is exactly correct (case-sensitive)
• Ensure file wasn't modified after encryption
• Check that file came from compatible LockedPillar version

Practice Mode Issues

Problem: Auto Progression skips lines too fast

Solution: The silence detection threshold is 2 seconds. Pause longer after speaking, or disable Auto Progression for manual control.

Problem: Can't advance past a line

Solution: Check if Auto Progression is enabled with accuracy threshold. Try manual mode, or use the skip button.

Problem: Feedback shows incorrect highlighting

Solution: Check My Words dictionary for conflicting entries. Verify the expected text in Edit mode.

Security Issues

Problem: Biometric authentication not available

Solutions:

• Verify device supports biometrics (fingerprint, Face ID, etc.)
• Enable biometrics in device settings
• Use PIN authentication as alternative
• Try different browser (Chrome/Edge/Safari recommended)

Problem: Forgot PIN and locked out

Solution: After lockout expires, you can attempt again. If you've completely forgotten your PIN, you'll need to clear browser data (this will delete all LockedPillar data—export first if possible).

Problem: Session keeps timing out

Solution: This is by design for security. Each authentication grants 30 minutes. For longer sessions, you'll need to re-authenticate.

General Issues

Problem: Data disappeared after clearing browser

Solution: Browser data clears include localStorage. Always maintain regular exports. This is why we recommend encrypted backups to cloud storage.

Problem: Changes not saving

Solutions:

• Check available storage space (Settings > Storage in browser)
• Verify browser allows localStorage
• Try different browser
• Clear browser cache and reload

Problem: App running slowly

Solutions:

• Close other browser tabs
• Clear browser cache
• Delete unused sets from library
• Restart browser
• Update to latest app version