Skip to content

melink14/rikaikun

Repository files navigation

rikaikun

Chrome Web Store Chrome Web Store Users Mergify Status codecov Codacy Badge semantic-release: conventional Code Style: Prettier License GPL-3.0 Standard Readme Compliant Conventional Commits All Contributors Contributor Covenant

rikaikun is a Chrome extension that helps you to read Japanese web pages by showing the reading and English definition of Japanese words when you hover over them.

Table of Contents

Background

rikaikun is a port of Rikaichan I started in 2010 when Chrome released its extension API. It was originally hosted on Google Code until Google Code was canceled and everything was migrated to GitHub.

Rikaichan was a Firefox extension that emulated the popup translations of RikaiXUL. It was the best Japanese-to-English inline translation tool in the browser.

I started with the idea that I would create the Chrome equivalent of Rikaichan from scratch using my own ideas. However, after I tried Rikaichan, I realized that it was already quite good, and starting from scratch would be wasting the excellent work of its developers. Instead, I forked Rikaichan and updated the APIs to work with the Chrome extension model.

In 2018, Firefox killed the extension model that Rikaichan was based on, but other similar extensions have since been created and ported to various browsers. Not much was happening with rikaikun during that time but we've started to work on it again!

Current Goals

  • Refactor code base such that it becomes very easy to maintain and contribute to.
  • Fix bugs in dictionary output.
  • Work on new features like other dictionaries, OCR, and static popup/lookup bar. Feel free to suggest/:thumbsup: more.

Install

Via the Chrome Web Store

Visit rikaikun on the Chrome Web Store and click 'Add to Chrome'.

Via Microsoft Edge Add-ons

Visit rikaikun on Microsoft Edge Add-ons and click 'Get'.

As an Unpacked Extension

You can also install rikaikun from the source as an unpacked extension:

Usage

Activate the extension by clicking on the 理 in the top right. When the introductory pop up appears, rikaikun is ready for action.

When rikaikun is active, hovering over Japanese words will trigger a translation pop-up.

See it in action in this Youtube demo by Tariq Sheikh.

Features

  • Read out the Japanese words using Chrome Text To Speech capabilities. (Off by default)
  • Change where the popup appears on your screen. (Where your mouse cursor is by default)
  • Copy current definitions to they keyboard.
  • Add a delay before popup is shown to avoid constant distractions.
  • Require a modifier key to be held down in order to see popups.
  • Hide definitions to see only the readings of words.

Options

You can access the options from the extension page if you have it installed or by right clicking on the rikaikun icon.

Keyboard Shortcuts

Key Explanation
A Alternate popup location
Y Move popup location down
C Copy to clipboard
D Hide/show definitions
Shift/Enter Switch dictionaries
B Previous character
M Next character
N Next word
J Scroll back definitions
K Scroll forward definitions

Maintainers

@melink14

Credits

Contributing

Contribute by submitting pull requests, filing bug reports, requesting features and more!

See the contributing file for the full details!

Small note: If editing the README, please conform to the standard-readme specification.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Aaron Muir Hamilton
Aaron Muir Hamilton

πŸ’»
Arseny Tolmachev
Arseny Tolmachev

πŸ’»
Baardman82
Baardman82

πŸ›
Bazz
Bazz

πŸ’»
Brian Birtles
Brian Birtles

πŸ’»
Bruno Queiroz
Bruno Queiroz

πŸ’»
Bryan Jennings
Bryan Jennings

πŸ’» πŸ€”
ChocoChopin
ChocoChopin

πŸ› πŸ€”
Dalyn
Dalyn

️️️️♿️
Darren Lester
Darren Lester

πŸ’»
Davies Odu
Davies Odu

πŸ’»
Erek Speed
Erek Speed

πŸ’» πŸ‘€ πŸ› πŸ“† πŸ€” πŸ“–
Greggman
Greggman

πŸ›
Jake
Jake

πŸ’»
Konstantin-Glukhov
Konstantin-Glukhov

πŸ€”
MayamaTakeshi
MayamaTakeshi

πŸ’»
Muhammad Afham Awisul Islah
Muhammad Afham Awisul Islah

πŸ’»
Samuel Dunlap
Samuel Dunlap

πŸ’»
Stephie
Stephie

πŸ‘€ πŸ’» πŸ“–
Tobi Owoputi
Tobi Owoputi

πŸ’» πŸ›
Travis Pandos
Travis Pandos

πŸ’»
Versus
Versus

πŸ’»
Ville Kohonen
Ville Kohonen

πŸ’»
Vwing
Vwing

πŸ’»
Yash Bajaj
Yash Bajaj

πŸ“–
deshaun93
deshaun93

πŸ’»
ollkorrekt
ollkorrekt

πŸ›
qkjosh
qkjosh

πŸ› πŸ’»
sdcr
sdcr

πŸ”£

This project follows the all-contributors specification. Contributions of any kind welcome!

License

GPL-3.0 Β© 2020 Erek Speed