Bookmarks Quick Search

About

================================================================================
                    BOOKMARKS QUICK SEARCH — CHROME STORE LISTING
================================================================================

Tired of scrolling through endless folders to find that one specific bookmark? 
Meet Bookmarks Quick Search — the ultimate, minimalist productivity tool designed 
to make finding and launching your bookmarks instantaneous and completely effortless. 

With a premium glassmorphic interface, adaptive keyboard shortcuts, a typo-tolerant 
fuzzy search algorithm, and full folder-path indexation, Bookmarks Quick Search is the 
last bookmark search extension you will ever need.

--------------------------------------------------------------------------------
1. INTRODUCTION: WHY BOOKMARKS QUICK SEARCH?
--------------------------------------------------------------------------------
Bookmarks are meant to save time. But as your collection grows, folders pile up, 
sub-folders multiply, and finding a bookmark turns into an annoying scroll-fest. 
Existing search solutions are often slow, bloated, or counter-intuitive. Many search 
through URLs, cluttering your results with irrelevant technical query strings, 
tracking parameters, or domain names rather than the actual bookmark title you remember.

Bookmarks Quick Search is built differently. It searches only by:
- The BOOKMARK TITLE
- The PARENT FOLDER NAMES containing that bookmark

By excluding URLs from the primary search index, it eliminates search noise and guarantees 
that every result is an exact conceptual match. It lets you type folder names and titles 
together (e.g. typing "Dev Tools" to find a bookmark inside Bookmarks bar -> Development -> Tools).

--------------------------------------------------------------------------------
2. KEY FEATURES & PRODUCTIVITY ENHANCEMENTS
--------------------------------------------------------------------------------

✦ FOLDER-PATH INDEXING & SEARCHING
  Most extensions only search bookmark names. Bookmarks Quick Search indexes the full 
  directory structure. If you have a bookmark named "Logs" inside a folder named "Jira", 
  simply type "Jira Logs". It instantly filters across folder names, making deep nested 
  bookmarks searchable in two keystrokes.

✦ COMFORT-WEIGHTED PHYSICAL KEYBOARD SHORTCUTS (ALGORITHMIC)
  For every bookmark, a dedicated "Comfort Shortcut" of the shortest length possible 
  (1 to 2 characters) is calculated on the fly. This algorithm measures the physical 
  distance between keys on a QWERTY layout. Home-row keys (a, s, d, f, j, k, l) and 
  double-taps (hh, jj, xx) are prioritized. Typing a bookmark's shortcut immediately 
  bumps it to the absolute top of the search results, allowing you to hit "Enter" 
  to open it instantly.

✦ INTERACTIVE CONFLICT RESOLUTION (MULTI-SHORTCUT PICKER)
  Don't like the generated shortcut? Simply click the shortcut badge to open the 
  Multi-Shortcut Customizer list. It displays alternative combinations (acronyms, 
  prefixes, double letters) along with their current availability and conflicts. 
  Selecting a shortcut saves it to local storage (`chrome.storage.local`), and the 
  solver instantly re-allocates conflicts without breaking your preferences.

✦ SMART FALLBACK FUZZY LETTER SEARCH (TYPO TOLERANT)
  We all make typos when typing quickly. If a multi-word search yields 0 results, 
  the search engine automatically falls back to an ordered subsequence character search. 
  If you type "jra", it will match "Jira" by detecting the letters in order, easily 
  overcoming typing slips or shorthand abbreviations.

✦ SECURE & FLUID QUERY HIGHLIGHTING
  Matches in both the title and folder path are highlighted using a premium brown accent 
  color. The highlighting parser uses a boolean-array marker mapping technique, 
  guaranteeing zero HTML injection vulnerabilities (XSS safe) while seamlessly handling 
  overlapping keywords.

✦ INSTANT LOCAL FAVICON CACHING
  Version 0.0.9 introduced localized icon caching. Using Chrome's local favicon utility, 
  bookmark icons are fetched instantly from local memory. This avoids network requests, 
  eliminates page-load lag, and provides an immediate visual indicator next to each entry.

✦ INTEGRATED DARK MODE TOGGLE
  A beautiful, iOS-style slider switch is built right into the footer. Toggle between 
  Light and Dark themes instantly. Your preference is cached in local memory, ensuring the 
  popup loads in your preferred theme without flashing.

✦ PREMIUM GLASSMORPHIC DESIGN & SATISFYING TRANSITIONS
  Built with Inter and JetBrains Mono typography, clean borders, responsive layouts, 
  subtle drop shadows, and custom thin scrollbars. Keyboard navigation (Arrow Up, 
  Arrow Down, Enter, Escape) is fluid and has animated select states.

--------------------------------------------------------------------------------
3. THE SHORTCUT GENERATION ENGINE: HOW IT WORKS
--------------------------------------------------------------------------------
Our shortcut allocator is a state-of-the-art solver designed to find the most comfortable 
key combinations based on human typing speed and finger reach:

- Cost Formulation:
  - Single Home-Row Keys (f, j, d, k, s, l, a, g, h) = Cost 1.0 (Optimal)
  - Single Top/Bottom Row Keys (e, r, t, u, i, o, c, v, b, n, m) = Cost 1.3
  - Far Single Keys (q, w, x, z, y, p) = Cost 1.8
  - Double Taps (ff, jj, dd, kk, ss, ll, aa, gg, hh) = Cost 1.1 (Extremely comfortable)
  - Adjacent Key Taps (ng, hj, er - QWERTY distance <= 1.8) = Cost 1.8
  - Non-Adjacent Key Taps = Cost 2.5 + Euclidean physical distance
- Relevance Formulation:
  - Candidates are generated based on acronyms (e.g. "Travis CI" -> "tc"), prefix substring 
    chords (e.g. "Jira" -> "ji"), single letters in words, and double letters of letters in 
    the title (e.g. "Mailchimp" -> "hh").
- Greedy Allocation:
  - The solver prioritizes user-defined custom overrides first.
  - It then sorts all combinations of comfort cost and relevance multipliers globally.
  - In a conflict-free greedy pass, the optimal available shortcut is assigned to each 
    bookmark. If a conflict occurs, the second-best is chosen, and unallocated items receive 
    the next most comfortable available combination from a fallback pool.

--------------------------------------------------------------------------------
4. HOW TO USE & PRODUCTIVITY TIPS
--------------------------------------------------------------------------------

★ PIN THE EXTENSION
   For the fastest search speed, pin Bookmarks Quick Search to your Chrome toolbar. 
   This ensures the popup opens instantly when using keyboard triggers.

★ DEFAULT KEYBOARD SHORTCUTS
   - macOS: Command + E
   - Windows/Linux: Ctrl + Shift + E (or Ctrl + Shift + W)
   If you have shortcut conflicts, visit `chrome://extensions/shortcuts` in your address bar 
   to custom-bind Bookmarks Quick Search to any key combo you prefer.

★ MOUSE-FREE NAVIGATION
   - Press your shortcut to open the popup.
   - Start typing your query.
   - Use Arrow Down or Arrow Up to navigate the list.
   - Press Enter to open the highlighted bookmark in your active tab.
   - Press Escape to close the popup.

★ CUSTOM SHORTCUT ASSIGNMENTS
   - Click the shortcut badge on the right of any result item.
   - A dropdown modal will reveal a list of alternative candidate keys.
   - Click any option (e.g. double taps like `aa`, `jj`).
   - The solver will automatically re-index and save your preference.

--------------------------------------------------------------------------------
5. FREQUENTLY ASKED QUESTIONS (FAQ)
--------------------------------------------------------------------------------

Q1: Why does this extension not search URLs?
A: Searching URLs can make results messy. For example, if you search "amazon", 
   you might get page after page of long tracking links containing "amazon" instead 
   of the bookmark you want. By only searching bookmark titles and folder names, 
   the extension shows you exactly what you organized, keeping search results clean.

Q2: Can I customize the shortcut to open the search bar?
A: Yes! Chrome controls extension hotkeys. Paste `chrome://extensions/shortcuts` 
   into your address bar, find "Bookmarks Quick Search", and set any hotkey you 
   prefer (such as `Cmd+E` or `Ctrl+W`).

Q3: How are the bookmark shortcuts generated?
A: They are generated on load using a physical keyboard layout distance algorithm. 
   It scores each key based on comfort and assigns them to bookmarks. If a bookmark 
   contains a comfortable key, that key is assigned. Conflicts are resolved automatically 
   using a greedy allocation algorithm.

Q4: What happens if I choose a shortcut that another bookmark is using?
A: The extension handles this automatically. If you assign a shortcut to Bookmark A 
   that was previously held by Bookmark B, Bookmark B will automatically be re-allocated 
   to its next-best available comfort shortcut. You don't have to worry about conflicts.

Q5: Will this extension slow down my browser if I have thousands of bookmarks?
A: No! The extension is optimized for performance. It processes indexing locally in 
   milliseconds and limits list rendering to the top 100 matches to prevent lag, keeping 
   memory usage extremely low.

Q6: Is my bookmark data sent to any servers?
A: Never. Bookmarks Quick Search is an offline-first extension. It works completely 
   locally inside your sandbox, ensuring your bookmark data is completely private.

Q7: Does this extension support bookmarklets (JavaScript bookmarks)?
A: In compliance with Manifest V3 security rules, bookmarklets are filtered out 
   to protect your browser from arbitrary script execution.

Q8: What layout standard does the shortcut algorithm use?
A: The algorithm is based on the standard QWERTY layout coordinates to evaluate Comfort 
   Scores.

Q9: Does Dark Mode sync across my devices?
A: Dark mode preferences are saved to your local browser profile. Toggling the theme switch 
   saves the state immediately.

Q10: Why does the popup height not change weirdly?
A: The popup is designed with an explicit 500px height. This prevents Chrome's popup window 
   height from collapsing while waiting for bookmarks to load asynchronously.

--------------------------------------------------------------------------------
6. TROUBLESHOOTING & GENERAL HELP
--------------------------------------------------------------------------------

- Shortcut is not opening the popup:
  1. Open `chrome://extensions/shortcuts`.
  2. Ensure the key combination is active and set to "In Chrome" or "Global".
  3. Reinstall the extension if the hotkey fails to register.
- Favicon icons are not loading:
  Chrome's local favicon caching updates on page visits. If a bookmark shows a fallback letter 
  circle, visiting the site once will cache its icon.
- Changes in bookmarks are not reflected:
  The extension indexes your bookmark tree on launch. If you add, delete, or re-organize 
  your bookmarks in Chrome, closing and opening the popup again will trigger a complete 
  re-indexing automatically.

--------------------------------------------------------------------------------
7. TECHNICAL SPECS, PRIVACY, & MV3 COMPLIANCE
--------------------------------------------------------------------------------
- Manifest V3 Compliant: Fully written under Manifest V3 specifications.
- Offline-First: All calculations, indexing, search matching, and theme storage are executed 
  100% locally on your machine.
- No External Callouts: We value your privacy. The extension does not communicate with any 
  external servers or send analytics. Your bookmarks stay on your computer.
- Bookmarklet Safety: In accordance with Chrome security policies, support for execution of 
  arbitrary script URLs (`javascript:...` bookmarks) was removed in version 0.0.13, 
  keeping your browser safe from cross-site scripting vulnerabilities.

--------------------------------------------------------------------------------
8. HISTORY OF RELEASES & ITERATIVE FIXES
--------------------------------------------------------------------------------
- Version 0.0.8: Fixed Google autocomplete and text input interference.
- Version 0.0.9: Optimized local icon fetching, rendering icons instantly on load.
- Version 0.0.10: Implemented query matching highlighting.
- Version 0.0.11: Smoothed out animation frame rates for list selection.
- Version 0.0.12: Corrected default Chrome keyboard shortcut mappings.
- Version 0.0.13: Refactored codebase, cleaned highlighting colors to a premium brown, 
  and removed legacy bookmarklets for MV3 compliance.
- Version 0.0.14: Improved performance loops when rendering heavy bookmark trees.
- Version 0.0.15: Added Multi-Shortcuts Selection overlays and resolved layout bugs.
- Version 0.0.16: Resolved popup height collapse bugs under asynchronous loading, added 
  a persistent Dark Mode toggle, updated high-contrast minimalist icons, and resolved 
  various small UI alignment issues.

--------------------------------------------------------------------------------
9. SUPPORT & CREATOR DETAILS
--------------------------------------------------------------------------------
Bookmarks Quick Search is 100% open-source and free. If it saves you time and makes 
your workflow smoother, consider supporting the developer:
☕ Buy me a coffee: https://buymeacoffee.com/oaklizard27

Thank you for choosing Bookmarks Quick Search! Enjoy a cleaner, faster bookmark 
searching experience!
================================================================================