Frequency generator for yomichan

Fluency is depends on context(i forgot who it was)

I’ve finished reading my first “real”(as in not for kids) and realized i need to make flashcards. I generally like to use yomichan for lookups but I’ve had a rather bad experience with making flashcards last time i tried since i didn’t know what to ignore and what to care about. The retirement strategy works(see MIA/MiGaku or whatever) but this seems like a more elegant solution.

Basically you run the script in a directory with one folder called books that has all the books(as long as calibre can read them and they are text not pictures any format works perhaps even PDFs might work) and a folder called dictionary that holds all the dictionary you have with yomichan(like jmdict). and run the script. the scrip assumes that you have

  • a python 3 interpreter
  • calibre’s ebook-convert
  • jumanpp
  • zip (Copyright © 1990-2008 Info-ZIP - Type ‘zip “-L”’ for software license. This is Zip 3.0 (July 5th 2008), by Info-ZIP.)
  • (optional) tqdm(python package) for progress bar

in the PATH. when you run the scripts it unpacks all dictionary and books and generate a frequency dictionary called freq named when you import it with yomichan, it will start showing the number of times a words occurred in the corpus. The first run is very slow, but it caches a lot of the intermediate formats and the subsequent runs are just slow.

no windows support yet, use WSL.

bonus: 本好き frequency list

import os
from os import path
from pathlib import Path
from subprocess import Popen, call
from bs4 import BeautifulSoup
import re
from collections import defaultdict
import json
  from import tqdm
except ImportError:
  def tqdm(x, *arg, **kwargs):
    return x

word = re.compile('[\s\n]*')
re_nl = re.compile('[ \n\t]+')

zhtml_dir = './zhtml'
html_dir = './html'
txt_dir = './txt'
parse_dir = './parse'
freq_dic_dir = './freq_dict'
dic_dir = './dictionary'
extract_dic_dir = './extract_dic_dir'
text_dic_dir = './text_dic_dir'
dict_parse_text_dir = './dict_parse_text_dir'
for i in [txt_dir, zhtml_dir, html_dir, parse_dir, freq_dic_dir, extract_dic_dir, text_dic_dir, dict_parse_text_dir]:
  i = Path(i)

def read_jumanpp(fn):
  res = []
  originals = []
  acc = []
  original =[]
  with open(fn) as fd:
    for i in map(str.strip, fd):
      if i == "EOS":
        if len(acc) > 0:
          original = []
          acc = []
      elif i == "*":
        i = [j for j in i.split() if len(j) > 0]

  return res, originals

class yomi_dict:
  def __init__(self, filename, dir=dic_dir):
    filename = path.splitext(filename)[0]
    self.file = path.join(dir, filename)
    self.filename = filename
    self.extract_dir = path.join(extract_dic_dir, filename)
    self.dict_text = path.join(text_dic_dir, filename)
    self.dict_parse_text = path.join(dict_parse_text_dir, filename)
  def extract(self):
    if path.exists(self.extract_dir):
    call(['unzip', self.file, '-d', self.extract_dir])

  def convert_to_text(self):
    if path.exists(self.dict_text):
    words = []
    with open(self.dict_text, 'w') as fd:
      for i in os.listdir(self.extract_dir):

        if re.match('term_bank_\d+\.json', i) is None:
        with open(path.join(self.extract_dir, i)) as dict_part:
          part = json.load(dict_part)
        for i in part:
          if len(i[1].strip()) > 0:
      words = set(words)
      for w in words:

  def pare_text(self):
    if path.exists(self.dict_parse_text):
    with open(self.dict_parse_text, 'w') as output:
      with open(self.dict_text) as input:
        call('jumanpp', stdin=input, stdout=output)

  def load_words(self):
    self.words, self.originals = read_jumanpp(self.dict_parse_text)
    return self

with open(path.join(freq_dic_dir, 'index.json'), 'w') as fd:

class book:
  def __init__(self, filename, dir='.'):

    self.file = path.join(dir, filename)
    self.filename = filename[:-5]
    self.zhtml_file = path.join(zhtml_dir, self.filename + '.htmlz')
    self.html_dir = path.join(html_dir, self.filename)
    self.txt_file = path.join(txt_dir, self.filename + '.txt')
    self.clean_html_file = path.join(self.html_dir, 'clean-index.html')
    self.parse_file = path.join(parse_dir, self.filename + '.parse')

  def htmlz(self):
    if not path.exists(self.zhtml_file):
      call(['ebook-convert', self.file, self.zhtml_file])

  def html(self):
    if path.exists(self.html_dir):
    call(['unzip', self.zhtml_file, '-d', self.html_dir])

  def clean_html(self):

    if path.exists(self.clean_html_file):

    with open(path.join(self.html_dir, 'index.html')) as fd:
      soup = BeautifulSoup(
    for rt in soup.find_all('rt'):
    for ruby in soup.find_all('ruby'):
      if ruby.string is None:
        s = ''.join(ruby.strings)
        s = ruby.string
      s = word.sub('', s)
    with open(self.clean_html_file, "w") as file:

  def txt(self):
    if path.exists(self.txt_file):
    call(['ebook-convert', self.clean_html_file, self.txt_file])

  def parse(self):
    if path.exists(self.parse_file):
    txt_file = open(self.txt_file)
    parse_file = open(self.parse_file, 'w')
    call('jumanpp', stdin=txt_file, stdout=parse_file)

  def load_parse(self):
    with open(self.parse_file) as fd:
      lines = [[j for j in re_nl.split(i.strip()) if len(j) > 0] for i in fd]
    lines = [i for i in lines if len(i) > 0 and i[0] != 'EOS']
    self.words = [i[2] for i in lines]

def add_to_count(arr, d):
  for i in arr:
    d[i] = d[i] + 1
class dict_trie:
  def __init__(self, data):
    self.root = dict()
  def add_data(self, data):
    for (ks, v) in data:
      r = self.root
      for k in ks:
        if k not in r:
          n = r[k] = dict()
          n = r[k]
        r = n
      r['final'] = v
  def find(self, ks):
    r = self.root
      for k in ks:
        r = r[k]
      return r['final']
    except KeyError as e:
      return None

if __name__ == '__main__':
  freq_counter = defaultdict(lambda: 0)
  dic_freq_counter = dict()
  word_occurences = defaultdict(lambda: [])
  books = []
  dicts = [yomi_dict(i).load_words() for i in os.listdir(dic_dir)]
  print("loaded dicts")
  for (index, i) in enumerate(os.listdir('books')):
    b = book(i, dir='./books')
    add_to_count(b.words, freq_counter)
    for (j_index, j) in enumerate(b.words):
      word_occurences[j].append((index, j_index))
  print("loaded books")
  for d in dicts:
    for words, stems in tqdm(zip(d.originals, d.words), total=len(d.words)):
      word = ''.join(words)
      if word in dic_freq_counter:
      c = 0
      if stems[0] not in word_occurences:
      for (b_id, loc) in word_occurences[stems[0]]:
        has = True
        for i in range(len(stems)):
          if books[b_id].words[loc + i] != stems[i]:
            has = False
        if has:
          c += 1
      dic_freq_counter[word] = c
  for (w, f) in freq_counter.items():
    if w not in dic_freq_counter:
      dic_freq_counter[w] = f

  with open(path.join(freq_dic_dir, "term_meta_bank_1.json"), 'w',  encoding='utf8') as fd:
    res = [[key, "freq", value] for (key, value) in sorted(dic_freq_counter.items(), key=lambda x:x[1], reverse=True) if value > 0]
    json.dump(res , fd, ensure_ascii=False)
  call(['rm', ''])
  call(['zip', '-j', '', path.join(freq_dic_dir, 'index.json'), path.join(freq_dic_dir, 'term_meta_bank_1.json')])

This looks super helpful and would love to try it out, but I’m too dumb to understand what I’m supposed to do :laughing: I’m not a techie at all.


i mean i can either run it for you, or help you run it. it’s not too complicated but might take a bunch of back and forth.

are you using linux or windows? or mac?

1 Like

I’m using Windows.

(no one saw my ninja edit)

1 Like

If you install linux subsystem for windows, the one with ubuntu, it should be a breeze

  2. open the terminal(search ubuntu in the menu)
  3. install cmake g++ gcc with sudo apt install cmake g++ gcc
  4. install jumanpp(will fill it later)
  5. install
  6. install calibre sudo apt install calibre
  7. install zip sudo apt install zip
  8. optional install pip sudo apt install python3-pip then pip3 install --user tqdm to install tqdm
  9. make the folders as decribed
  10. run the script with python to write it either open an editor like nano then paste in it or the windows drivers are in /mnt and you can change directory there

this is the best i can do. is it useful?

1 Like

This is out of reach for non-techie.


I don’t really want to install lots of stuff for this :sweat_smile: Maybe it was helpful for someone else, though :3


i was going to turn it into a step by step guide by helping someone use it. I mean reading and doing as you’re told is generally not thought of as a technical skill but sure.

You could build a docker container that does all the steps automatically. :slight_smile:


that’s an interesting idea. i’ve never used docker but i reckon it can’t be that bad. i’ll look into it!

Even if you write a step by step guide it will still be out of reach for non techies.

  • You require to install a lot of stuff that makes no sense to non techies.
  • The steps are numerous and highly technical.
  • Non techies won’t have the ability to find their way out if something goes wrong.
  • The complexity of the procedure leaves plenty of room for something to go wrong.

This is not an issue of lack of procedure. You just don’t have enough ease of use built-in.


docker it is then


any help?
I’m getting an Index out of range error on line 221
seems like some epubs tend to cause this problem, removing them can work but i’d like to have them as much as possible

FYI the author of this program has deleted their account and is not going to reply