Skip to content

An audio server for yomichan that scrapes forvo for audio files

Notifications You must be signed in to change notification settings

jamesnicolas/yomichan-forvo-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Yomichan Forvo Server for Anki

image

Simple server to take advantage of Yomichan's custom audio sources feature. Requires Anki Connect. It web scrapes Forvo's search and word page to get a list of words.

Prerequisites:

  • Anki
  • Yomichan
  • Anki Connect

Install:

  1. Copy the code and install like you would for any other Anki addon
  2. Restart Anki
  3. Allow network connections (required since this is a local server)
  4. In yomichan settings, go to Audio > Configure Audio Playback Sources > Custom Audio Source
  5. Select Type as JSON and set URL to http://localhost:8770/?term={term}&reading={reading}
  6. In your Audio Sources list below, make sure one of them is set to Custom

Now when you scan a word in Yomichan, you should be able to right click the audio icon and the Forvo custom audio sources should appear.

Configuration

Yomichan Forvo Server supports a few configuration options, which you can edit by going to Tools > Add-Ons > Yomichan Forvo Server > Config. Note configuration changes requires you to restart Anki to see effects.

  • port Port that YomiChan will call. Default is 8770
  • language Language code to use in Forvo. Some examples are ja for Japanese or zh for Mandarin Chinese. Default ja. On the Forvo website, you can see what language code is in square brackets beside the language name on a pronunciation. If you want to have a separate source for another language, you can add another parameter to the URL to override this config: eg http://localhost:8770/?term={term}&reading={reading}&language=zh
  • preferred_usernames A list of Forvo usernames. This will order the results on top based on this priority. If empty, results will show based on the Forvo website order. Default empty.
  • show_gender Show the gender symbols (♂, ♀,) beside the username based on their gender. Default true.
  • show_country Show the country of the user beside their name. Default false.

Links

Changelog

2024-06-10

  • handle anonymous users
  • support showing country

2023-08-30

  • support overriding the language in the URL

2023-07-28

  • fixed deprecated method_whitelist in urllib3 Retry and use allowed_methods

2022-09-05

  • add support for preferred usernames
  • fixed bug where it was using the raw audio from forvo, now uses the normalized audio from forvo
  • added gender symbols to results
  • support configuration where port, username order, language, and showing gender symbols are configurable

2022-07-25

  • update selectors for new forvo layout

2022-01-30

  • add Content-length header

2021-03-22

  • fixed bug with empty reading/expression inputs returning unrelated words
  • added basic retries/timeouts to deal with connection issues

2021-11-14

  • change timeout to 10 seconds

About

An audio server for yomichan that scrapes forvo for audio files

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages