Skip to content

A browser extension that enhances your reading experience on Asura Comic with arrow key navigation and customizable ad/element blocking.

License

Notifications You must be signed in to change notification settings

talha-devp/asura-enhancer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Asura Enhancer

A browser extension that enhances your reading experience on Asura Comic with arrow key navigation and customizable ad/element blocking.

Features

  • Arrow Key Navigation: Use left and right arrow keys to navigate between chapters
  • Element Blocking: Remove annoying ads and unwanted elements from pages
  • Custom Selectors: Add your own CSS selectors to block specific elements
  • Recommended Blocklist: Use a regularly updated community blocklist
  • Sync Settings: Settings are synced across your Chrome devices

Installation

  1. Download or clone this repository
  2. Open chrome://extensions/ in your browser (might differ for your browser)
  3. Enable "Developer mode" (toggle in the top right)
  4. Click "Load unpacked" and select the extension folder
  5. The extension should now appear in your extensions list

Usage

Arrow Navigation

  • Left Arrow: Go to the previous chapter
  • Right Arrow: Go to the next chapter
  • Toggle on/off in the extension options

Blocking Elements

  1. Using the Recommended List (Easiest)

    • Open the extension options
    • Check "Use my list (recommended)"
    • This loads selectors from the official blocklist
  2. Loading from a Custom URL

    • Enter the URL to a text file containing CSS selectors (one per line)
    • Click "Load Selectors"
    • Comments starting with // or # are ignored
  3. Adding Custom Selectors

    • Enter a CSS selector in the "Add custom selector" field
    • Click "Add" to save it
    • Example: .annoying-ad, #popup-banner, div.advertisement

File Structure

  • manifest.json - Extension configuration
  • popup.html - Options page UI
  • popup.js - Options page logic
  • content.js - Content script that runs on Asura Comic pages

How It Works

Content Script (content.js)

  • Runs on every page load at asuracomic.net/*
  • Listens for arrow key presses and navigates between chapters
  • Uses a MutationObserver to watch for dynamically added elements
  • Removes elements matching stored CSS selectors

Popup Script (popup.js)

  • Manages the extension options interface
  • Loads and saves settings to Chrome sync storage
  • Fetches selectors from URLs
  • Displays and manages the selector list

Settings Storage

All settings are stored in Chrome's sync storage:

  • arrowEnabled - Enable/disable arrow navigation
  • blockingEnabled - Enable/disable element blocking
  • customSelectors - Array of CSS selectors to block
  • selectorUrl - Last used blocklist URL
  • useRecommendedList - Whether to use the recommended blocklist

License

MIT License

About

A browser extension that enhances your reading experience on Asura Comic with arrow key navigation and customizable ad/element blocking.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published