GitHub - rajveerb/pleasant-reader: A browser extension for Chrome and Brave that turns any blog or article into a calm, soothing read — warm earthy colors, fluid typography, and a comfortable reading column instead of cramped fonts, glaring whites, and cluttered layouts. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
rajveerb
pleasant-reader
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>2 Commits<br>2 Commits
docs/images
docs/images
fonts
fonts
icons
icons
scripts
scripts
src
src
test
test
vendor/katex
vendor/katex
.gitignore
.gitignore
README.md
README.md
manifest.json
manifest.json
package.json
package.json
View all files
Repository files navigation
Pleasant Reader
A browser extension for Chrome and Brave that turns any blog or article<br>into a calm, soothing read — warm earthy colors, fluid typography, and a<br>comfortable reading column instead of cramped fonts, glaring whites, and<br>cluttered layouts.
Screenshots
Before → after. A cluttered page (nav bar, sidebar ads, cramped lines) is<br>rebuilt into a clean, centered reading column:
Before<br>After — Reader mode (light)
Restyle mode & the popup. Restyle repaints the page in place (a lighter<br>touch than Reader); the popup drives mode, theme, text size, and the per-site<br>rule:
Restyle mode<br>Popup
Dark theme & rich content. Light/Dark/Auto themes; code blocks get warm<br>Monokai highlighting and LaTeX math renders via bundled KaTeX:
Reader mode (dark)<br>Code + math
Screenshots are generated from the bundled sample articles by<br>node scripts/screenshots.mjs (drives the real extension in headless<br>Chromium via the test harness).
Features
Reader mode — extracts the article and rebuilds it in a clean, centered<br>column with elegant typography (fully isolated from the page via Shadow DOM,<br>including its own font sizing — unaffected by the site's root font-size).
Code syntax highlighting — reader code blocks are re-highlighted in a warm<br>Monokai palette.
Math rendering — LaTeX/$…$ math is rendered with bundled KaTeX.
Restyle mode — a lighter touch that keeps the page's structure but<br>repaints it with the warm palette and fonts in place.
Runs only where you allow it — the extension holds no standing access to<br>your browsing. It activates on a page only when you invoke it (toolbar icon /<br>Alt+R), or auto-opens on a site after you explicitly grant that site<br>permission via the Always rule.
Light / Dark / Auto theme — Auto follows your operating system.
Adjustable text size — scale the reading size to taste.
Per-site rule — Always (grant this site permission to auto-open) or<br>Never (the default — only opens when you ask).
Keyboard shortcut — Alt+R toggles the reader on the current page.
Self-hosted fonts — National Park, Fragment Mono, and Playfair Display are<br>bundled, so the look is identical even on sites with strict content security<br>policies and works offline.
Install (unpacked, for development)
Open chrome://extensions (Chrome) or brave://extensions (Brave).
Enable Developer mode (top-right).
Click Load unpacked and select this folder<br>(extension-pleasant).
Pin the Pleasant Reader icon to your toolbar.
Usage
Click the toolbar icon to open the popup, then Make this page pleasant .
Or press Alt+R to toggle instantly.
In reader mode, use the in-view bar to change theme, resize text, or close<br>(Esc also closes).
Use the popup to pick the default Mode (Reader / Restyle), the Theme ,<br>and set a per-site rule. Choosing Always asks for permission to run on that<br>site automatically; Never (the default) revokes it and leaves the site to<br>on-demand use.
Project structure
extension-pleasant/<br>├── manifest.json # MV3 manifest<br>├── icons/ # toolbar icons (16/32/48/128) + source SVG<br>├── fonts/ # bundled woff2 subsets (latin + latin-ext)<br>└── src/<br>├── background.js # service worker: shortcut + toolbar badge<br>├── content.js # orchestrates reader / restyle, theming, messaging<br>├── readability.js # dependency-free article extractor<br>├── reader.css #...