Selected Text Word Frequency Chart

WHAT IT DOES

Selected Text Word Frequency Chart is a text analysis tool that turns any selected text on the web into a visual word frequency report. Highlight text on any webpage, click "Analyze Selection," and the script generates a bar chart showing the most common words and how often they appear. The panel displays total word count, unique word count, and a vocabulary richness score (the ratio of unique to total words). A word cloud view option provides a visual summary where the most frequent words appear larger. Stop word filtering automatically removes common words like "the," "and," "of," and "to" to focus on meaningful content. The stop word list is fully customizable—you can add or remove words for any language. Export results as plain text or CSV for further analysis in spreadsheets or writing tools. Perfect for students analyzing essays, writers reviewing their word choices, researchers studying text patterns, or anyone curious about the language in the content they read.

WHERE IT RUNS

This script runs on any webpage where you can select text—articles, blog posts, emails, documents, social media, and more. It operates entirely within your browser tab, reading only the text you manually select. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including top words count, word cloud visibility, stop word filtering, min word length, and export format—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, select any text on a webpage by clicking and dragging. Click "Analyze Selection" in the panel to generate the word frequency report. The panel shows a bar chart of the top words (configurable from 5 to 100), total word count, unique word count, and vocabulary richness percentage. Toggle "Show Word Cloud" to see a visual word cloud of the most frequent terms. Enable or disable stop word filtering to include or exclude common words. Customize the stop word list by entering comma-separated words. Adjust the minimum word length to filter out very short words. Copy results to your clipboard as plain text or CSV format using the "Copy Results" button.

THE REAL MECHANISM

The script extracts the selected text using the browser's Selection API (window.getSelection()). The text is then normalized by converting to lowercase and splitting into words using whitespace boundaries. Punctuation is removed using a regex that strips non-alphabetic characters (except apostrophes). Each word is counted using a frequency hash map, then filtered against the stop word list to remove common words. Words shorter than the minimum length are also excluded. The remaining words are sorted by frequency in descending order. The bar chart is rendered using simple div elements with widths proportional to the maximum frequency. The word cloud generates spans with font sizes scaled between 12px and 40px based on frequency. The vocabulary richness score is calculated as (unique words / total words) × 100, providing a measure of lexical diversity. All rendering uses safe DOM manipulation with no innerHTML from untrusted content.

THE PANEL

The Word Frequency panel is a BGPanel component that you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the chart and settings. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. The analysis is based on the selected text only—it does not scan the entire page unless you select all content. Stop word filtering uses an English default list; for other languages, add your own stop words using the custom stop words field. Very short words (default min length 3) are excluded to avoid noise. The word cloud is best for quick visual scanning; the bar chart provides precise frequency data. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your top words count, word cloud visibility, stop word filtering, min word length, and export format preferences locally. No selected text, analysis results, or personal information is ever collected, transmitted, or shared.