How nrs13/bodhi works
Bodhi is a Chrome extension that finds vocabulary in YouTube captions or a user-entered search and displays definitions without interrupting playback. The caption path gathers a recent caption window, ranks candidate words, looks up a definition, and presents it in a floating card; users can try another candidate or search directly. The card and popup also expose per-video lookup history and settings. Edges reflect documented calls and data access; cross-context message dispatch is shown as unverified because the excerpts do not show the full wiring.
Main entry points: content.js Page controller · popup.js Popup and settings · serviceWorker.js Message worker · wordPredictor.js Ranking client
Components 20
Caption analysis
- Transcript manager
extension/content/transcriptManager.js - Ranking client
extension/content/wordPredictor.js - Word ranker
extension/background/wordPredictor.js - Frequency list
extension/data/frequencyList.js
Definition lookup
- Message worker
extension/background/serviceWorker.js - Definition client
extension/content/definitionFetcher.js - Runtime message client
extension/content/swClient.js - Definition fetcher
extension/background/definitionFetcher.js
Extension experience
- Page controller
extension/content/content.js - Floating card
extension/content/content.js - Search suggestions
extension/content/content.js - Popup and settings
extension/popup/popup.js - Text formatting
extension/shared/text.js
History and settings
- Lookup history
extension/content/content.js - Chrome local storage
- History pruning
extension/shared/history.js
Other components
- YouTube viewer
- YouTube captions
- Dictionary services
- Extension user
Connections 23
- YouTube viewer → YouTube captions: watches
README.md - YouTube captions → Transcript manager: provides captions
README.md - YouTube viewer → Page controller: invokes lookup
README.md - Page controller → Transcript manager: reads caption window
extension/content/content.js - Page controller → Ranking client: requests ranking
extension/content/content.js - Ranking client → Message worker: sends rank request
- Message worker → Word ranker: dispatches ranking
extension/background/serviceWorker.js - Word ranker → Frequency list: reads word ranks
extension/background/wordPredictor.js - Page controller → Definition client: requests definition
extension/content/content.js - Definition client → Runtime message client: sends lookup request
extension/content/definitionFetcher.js - Runtime message client → Message worker: dispatches lookup
- Message worker → Definition fetcher: dispatches lookup
extension/background/serviceWorker.js - Definition fetcher → Dictionary services: queries providers
extension/background/definitionFetcher.js - Page controller → Floating card: renders result
extension/content/content.js - Page controller → Search suggestions: offers search suggestions
README.md - Page controller → Lookup history: reads and saves lookups
extension/content/content.js - Lookup history → Chrome local storage: reads and writes
extension/content/content.js - Extension user → Popup and settings: opens popup
README.md - Popup and settings → Chrome local storage: reads history and settings
extension/popup/popup.js - Popup and settings → History pruning: prunes entries
extension/popup/popup.js - Page controller → History pruning: prunes entries
extension/content/content.js - Page controller → Text formatting: cleans display text
extension/content/content.js - Popup and settings → Text formatting: formats displayed text
extension/popup/popup.js