NihongoAutoTracker

An unofficial, customizable browser extension for NihongoTracker that automates and streamlines your Japanese immersion logging.

Built with WXT and TypeScript.

✨ Features

Queue System

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

Advanced Video Tracking

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.

Reading & Context Menu Logging

Track your reading progress actively and seamlessly sync with popular web readers.

• Reader Integration: Seamlessly syncs your reading sessions from Ttu Reader, Yatsu Reader, and Manabe Reader in the background.
• 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.

Configurable

• 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.
• Toggable Options: Various toggable options to personalize your viewing and reading experience.
• Regex Engine: Power users can define custom regex rules for strict control over automatic title and volume detection.
• And more

🛠️ Installation for Development

1. Clone this repository.
2. Run pnpm install.
3. Run pnpm dev to start the development server.
4. WXT will automatically open a custom browser instance with the extension loaded.

📦 Building for Production

Run pnpm run zip:all to build for both Chrome and Firefox simultaneously. Compiled files will be located in the .output/ directory.

⚖️ Attribution

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.