A Tampermonkey userscript that makes reading on Asura Scans cleaner and more convenient. It adds a reader dock, auto-scroll, reading history, themes, keyboard shortcuts, layout controls, and page cleanup.
- Install Tampermonkey in your browser.
- Open the latest userscript.
- Approve the installation in Tampermonkey.
- Visit asurascans.com.
Once a release build is installed, Tampermonkey can discover later releases automatically. See Updates for details.
pnpm install
pnpm buildOpen dist/asura-utils.user.js in your browser and approve the Tampermonkey installation.
| Area | What it adds |
|---|---|
| Reader | Collapsible reader dock, auto-scroll, adjustable speed, image width and brightness controls |
| Navigation | Previous and next chapter controls, series navigation, chapter-end actions, premium-lock handling |
| Progress | Reading progress bar, per-series history, continue-reading links, and position restoration |
| Appearance | Seven theme presets, custom accent colors, and full-site color remapping |
| Cleanup | Ad and promotion blocking, optional section hiding, compact sidebar, and layout overhaul |
| Controls | Rebindable shortcuts plus double-click auto-scroll |
| Data | Settings export/import, reset controls, and local reading-history management |
Shortcuts can be rebound or cleared from Settings → Shortcuts.
| Key | Action | Context |
|---|---|---|
S |
Toggle auto-scroll | Reader |
Q / E |
Decrease / increase scroll speed | Reader |
A / D |
Previous / next chapter | Reader |
B |
Return to the series page | Reader |
W |
Toggle fit-width mode | Reader |
C |
Focus search | Series page |
L |
Jump to the chapter list | Series page |
Auto-scroll can also be toggled by double-clicking a chapter page when that option is enabled.
- Open a chapter page.
- Select the slim handle on the right edge to expand the reader dock.
- Adjust scrolling, image width, brightness, or navigation from the dock.
- Select the gear button in the site header to configure appearance, reader behavior, layout, shortcuts, and saved data.
The default chapter-end action intelligently opens the next available chapter. It checks for premium locks before navigating.
| Preset | Preset | Preset |
|---|---|---|
| Asura Classic | Asura Ocean | Tokyo Night |
| Rosé Pine Moon | Kanagawa Dragon | Gruvbox Material |
| Everforest Dark |
Every preset supports an optional custom accent color with live preview.
Release builds include Tampermonkey @updateURL and @downloadURL metadata. Tampermonkey checks the lightweight metadata asset from the latest GitHub release and installs the full userscript when it finds a newer version.
Users who installed a build from before automatic updates were introduced must install a current release once. Update frequency is controlled by Tampermonkey's own settings.
Settings and reading history remain in Tampermonkey storage on your device. Asura Utils does not send that data anywhere.
| Guide | Contents |
|---|---|
| Documentation index | Overview of all project guides |
| Usage guide | Reader controls, shortcuts, history, themes, and data tools |
| Configuration reference | Every setting, default value, and valid range |
| Development guide | Local setup, scripts, build artifacts, and source layout |
| Release guide | Versioning, tagged releases, CI, and automatic updates |
Requires Node.js 22 and pnpm.
| Command | Purpose |
|---|---|
pnpm dev |
Start Vite in userscript development mode |
pnpm typecheck |
Check TypeScript without emitting files |
pnpm build |
Build the userscript and metadata files into dist/ |
pnpm test |
Typecheck, build, and verify both release artifacts |
pnpm preview |
Start the Vite preview server |
See the development guide for the complete project layout and workflow.
Asura Utils is licensed under the GNU General Public License v3.0 only.