Raffaelbdl / kuma-browser

Add-on to use JPDB directly inside Anki
MIT License
8 stars 1 forks source link

Kuma Browser

Shows Kumakyuu in dark mode and Kumayuru in light mode.

Installation | Features | Common Issues |

Kuma Browser enables a few functionalities from the jpdb.io search engine directly within Anki.

[!CAUTION] Kuma Browser is not an official JPDB addon. It simply aims to facilitate the creation of Anki cards, but does not want to replace JPDB.

People from JPDB if you see this, please make an offline app for your website πŸ–€πŸ€

[!NOTE] Kuma Browser is a project in development, and features are added when I need them. You can contribute by adding an Issue or making a Pull Request.

Installation

The installation process is similar to other Anki plugins and can be accomplished in three steps:

1) Download the latest release's .zip file 2) Select Tools β†’ Add-ons, then click on View Files 3) Drag the downloaded .zip file in the addons21 folder, and unzip it

Features

To start the Kuma Browser, select Tools β†’ Kuma Browser

The Search Tab

The JPDB Tab

The JPDB Vocabulary List Tab

The Reposition Tab

The JPDB API Vocabulary List Tab

Provided Template

I provide my own template, but it can be freely modified from the config/ folder.

kuma

You can change between くまきゅう and くまゆる by using light or dark theme.

Common Issues

JPDB Vocabulary List Tab fails

This method to create notes is known to fail a lot. It is supposedly due to jpdb.io restricting users so that they cannot do too many requests too fast 😢 (#18). If it happens, you may have been temporarily banned. Wait a bit before trying either the JPDB Vocabulary List scraper or the JPDB Vocabulary List API.

One way to solve this is to use the API: it should not be limited like the web scraping method.

If you want the example sentences however, you will need to set a delay between each requests. This can be done by setting the parameter sleep_time in config/vl.json. For example:

{ "sleep_time": 0.1 }

Do not change the key sleep_time as there is no self-repair mechanism πŸ˜†