An unofficial, customizable browser extension for NihongoTracker that automates and streamlines your Japanese immersion logging.
Built with WXT and TypeScript.
Logs are stored in a local queue, giving you complete control over your data before it hits the server. There are various options to automate the process.
- Session Management: Group multiple short sessions of the same media together.
- Manual Overrides: Edit time, character counts, dates, volume and title before hitting "Send".
- Smart Matching: Search and match your reading material (Light Novels) to ensure accurate logging to NihongoTracker. A green checkmark appears when matched.
- End-of-Day Sync: Optionally set the extension to automatically flush your queue and send everything right before midnight.
| Quick Popup Menu | Full Dashboard View |
 |
 |
Never forget to log a video again. The extension integrates smoothly into your viewing experience without cluttering the screen.
- In-Player Badge: Injects a sleek, non-intrusive tracking badge directly into the player to monitor current and total session time.
- Quick Context Menu: Right-click any YouTube video or link to log it instantly to NihongoTracker without opening a single menu.
- Smart Auto-Logging: Optionally set thresholds (e.g., 95% completion or 30 minutes watched) to log content automatically in the background without sending it to the queue.
- Playlist Logger: Bulk-log entire playlists or select specific videos directly from the YouTube sidebar or playlist header. Includes smart filters to automatically hide non-Japanese content.
Track your reading progress actively and seamlessly sync with popular web readers.
- Reader Integrated Dashboard: Seamlessly syncs your reading sessions from Ttu Reader, Yatsu Reader, and Yomiyasu Reader in the background.
- Cohesive Design: Match the visual appearance of your dashboard and popup directly to your reader's design for a unified workspace.
- Compact Timer Overlay: A sleek, draggable overlay tracks your active reading time on non-reader websites (e.g. Wikipedia, Asahi Shinbun). Can be customized.
- Integrated Matching Logic: Match your reading material inside the reader before sending it to the queue, ensuring every send is correctly matched.
| Reader Integration | Session History & Tracking |
 |
 |
- Text Context Menu: Highlight Japanese text on any webpage, right-click, and log it instantly. The extension calculates character counts and reading time automatically.
- Theme Management: Choose from multiple pre-built themes, or create, import, and share your own custom designs.
- Site Filters: Maintain Allow/Skip lists for the reading overlay to control exactly where tracking occurs.
- Flexible Logic: Toggle time tracking, switch between auto and manual modes, and set playlist-specific Japanese content filters.
- Togglable Options: Various options to personalize your viewing and reading experience.
- Regex Engine: Define custom regex rules for control over automatic title and volume detection.
- And more
- Clone this repository.
- Run
pnpm install. - Run
pnpm devto start the development server. - WXT will automatically open a custom browser instance with the extension loaded.
Run pnpm run zip:all to build for both Chrome and Firefox simultaneously. Compiled files will be located in the .output/ directory.
This repository is configured with GitHub Actions to automate building, publishing, and updating the extension.
To learn how to trigger a new deployment, automatically sync this description to the Firefox Add-ons Store, and retrieve the signed .xpi file, see the Release Guide.
NihongoAutoTracker is designed with a strict focus on user privacy. No analytical tracking, ads, or telemetry software are bundled with this extension. Your logging history and API keys reside locally in your browser storage. For detailed information on data processing, please view the Privacy Policy.
This extension interacts with NihongoTracker. All data retrieved from the site is licensed under CC BY-NC-SA 4.0. This is an independent project and is not affiliated with or endorsed by NihongoTracker. Consistent with the source license, this extension is strictly NonCommercial.