Browser Extension Setup
The AniKura browser extension automatically detects anime you watch on supported streaming sites and updates your list without any manual input. It runs in the background while you watch.
What the Extension Does
When you’re watching anime on a supported site, the extension:
- Detects the title and episode being watched
- Matches it to an AniKura database entry using the title and episode number
- Records your progress once you’ve passed the scrobble threshold (default: 80% of the episode)
- Updates your list entry status and episode count automatically
- Queues updates offline if you’re not connected — they sync when you reconnect
The extension also provides a popup with your current watch progress, quick list status controls, and a link to the AniKura episode page.
Supported Sites
| Site | Status | Notes |
|---|---|---|
| Crunchyroll | Supported | Full auto-detection |
| Netflix | Supported | Auto-detection of anime titles |
| HiDive | Supported | Full auto-detection |
More sites are planned. Suggest a site in the Discord.
Installation
Chrome / Chromium-based browsers
- Visit the Chrome Web Store (link coming soon — extension pending review)
- Click Add to Chrome
- Confirm the permissions prompt
- The AniKura icon appears in your browser toolbar
Firefox
- Visit Firefox Add-ons (link coming soon — extension pending review)
- Click Add to Firefox
- Confirm the permissions prompt
- The AniKura icon appears in your browser toolbar
Setup
1. Sign in
After installation, click the AniKura icon in your toolbar. You’ll see a Sign In prompt. Click it to open the AniKura login page. Once you complete sign-in, the extension detects your session automatically.
2. Subscription requirement
Auto-detection requires an active AniKura subscription. The extension will still work without a subscription, but it will not automatically detect playback — you’ll need to manually search and update from the extension popup.
Search and manual update features remain free for all registered users.
3. Configure scrobble threshold
The scrobble threshold determines how far into an episode you must watch before it counts as watched.
- Default: 80% of the episode duration
- Adjust in: AniKura Settings → Extension → Scrobble Threshold
- Setting to 100% means only fully completed episodes count
- Setting lower (e.g. 50%) is useful for long episodes or slow connections
How Matching Works
The extension uses a three-layer matching pipeline:
- Title normalization — strips subtitles, season markers, and streaming-site-specific formatting
- Fuzzy title matching — matches against AniKura database titles with typo tolerance
- Season map — resolves multi-season shows to the correct AniKura entry using a cached season map
The season map is cached locally and refreshed weekly. For newly added shows, there may be a delay of up to a week before the season map includes them.
Offline Queue
If you watch anime without an internet connection (e.g. downloaded episodes via the browser or cached pages), the extension queues the scrobble event locally:
- Maximum queue size: 500 events (FIFO — oldest events dropped first when full)
- Events older than 30 days are automatically discarded
- Queue syncs automatically when your internet connection is restored
- You can view and manage the queue from the extension popup
Permissions
The extension requests these browser permissions:
| Permission | Why |
|---|---|
storage | Save your session token and offline queue locally |
tabs | Detect the current tab’s URL to activate the content script |
| Host permissions for Crunchyroll, Netflix, HiDive | Read the video player state on these sites |
The extension does not read, store, or transmit any content from sites beyond what’s needed to identify the anime and episode being watched.
Troubleshooting
Extension not detecting a show:
- Verify the show is in the AniKura database by searching at anikura.io
- Check that your subscription is active
- For a newly added show, the season map may not include it yet — try the manual search in the popup
Scrobble not saving:
- Check your internet connection — events are queued offline and will sync on reconnect
- Open the extension popup and check the queue status
Wrong episode detected:
- Use the popup to manually set the correct episode number
- The season map for multi-season shows can sometimes be incorrect — report the issue via the popup
Privacy
The extension only sends data to api.anikura.io. It sends:
- Your AniKura session token (for authentication)
- The anime ID, episode number, and timestamp of watched episodes
It does not send browsing history, video content, or any data from sites you visit outside the supported streaming platforms.