Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Kenxpx/MindStream

Repository files navigation

MindStream – Accessible Web Reading

MindStream is a Chrome extension that makes web content easier to read.
It simplifies complex text, supports different reading modes (ADHD, Dyslexia, General), and gives you full control over how pages look β€” without cutting information.

πŸ”΄ Live Demo: mindstream.sachinbind.net


✨ Features

  • AI-powered simplification (Chrome Gemini Nano, offline)
  • 3 simplification levels β†’ Low Β· Medium Β· High
  • Modes for different needs β†’ General Β· Focus/Attention (ADHD) Β· Predictable Flow (Dyslexia)
  • Custom display β†’ Fonts (OpenDyslexic), themes, spacing controls
  • Instant updates β†’ Page changes in real-time, no reload

πŸ›  Requirements

  • Chrome Dev or Canary (>= 134306545.0)
  • Storage: 22 GB free (Gemini Nano requirement)
  • Flags to enable:
    • chrome://flags/#optimization-guide-on-device-model β†’ Enabled BypassPerfRequirement
    • chrome://flags/#prompt-api-for-gemini-nano β†’ Enabled

πŸš€ Installation

1. Clone the repository

git clone https://github.com/Kenxpx/MindStream.git
cd MindStream

2. Enable Developer Mode in Chrome

  • Open chrome://extensions/
  • Toggle Developer Mode (top right)

3. Load the extension

  • Click Load unpacked
  • Select the MindStream folder

The extension icon will appear in your Chrome toolbar. βœ…


πŸ”§ Build & Customize

If you want to make changes (themes, features, etc.):

1. Install dependencies

npm install

2. Run in dev mode

npm run dev

3. Build for release

npm run build
  • The output will be in the dist/ folder.
  • Load dist/ as an unpacked extension in Chrome (instead of MindStream/).

βš™οΈ Configuration

  • Themes: Change default theme in config/theme.js
  • Fonts: Enable/disable OpenDyslexic in config/fonts.js
  • Modes: Edit or add reading modes in src/modes/

πŸ›  Troubleshooting

  • Extension not loading? β†’ Check Chrome flags are enabled
  • AI not working? β†’ Make sure you’re on Dev/Canary β‰₯ 133
  • Still broken? β†’ Restart Chrome and reload extension

πŸ“¬ Support

Need help? Open an issue or email:
sachinbinduc@gmail.com


πŸ“œ License

MIT License β€” free to use and modify.


πŸ‘¨β€πŸ’» Author

Created by Kenxpx Β· Maintained by Sachinxps

About

AI-powered Chrome extension for cognitive-friendly, offline web reading.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /