instantly look up japanese words anywhere on your screen. meikipop uses optical character recognition (ocr) to read text from websites, games, scanned manga, or even hard-coded video subtitles, giving you effortless dictionary lookups with the press of a key (or even without)!

• works everywhere: if you can see it on your screen, you can look it up. no more limitations of browser extensions, hooks or application-specific tools.
• ocr-powered: reads japanese text directly from images, making it perfect for games, comics, and videos.
• blazingly fast: the dictionary is pre-processed into a highly optimized format for instant lookups. the ui is designed to be lightweight and responsive.
• simple & intuitive: just point your mouse and press a hotkey. that's it.
• highly customizable: change the hotkey, theme, colors, and layout to create your perfect reading experience.
• region or fullscreen: scan your entire screen or select a specific region (like a game window or manga page) to improve performance.
• pluggable ocr backend: comes with a great default ocr, but allows users to integrate owocr or their own ocr engines.

meikipop is designed to do one thing and do it exceptionally well: provide fast, frictionless, on-screen dictionary lookups.

it is heavily inspired by the philosophy of Nazeka, a fantastic browser-based popup dictionary, and aims to bring that seamless experience to the entire desktop. it also draws inspiration from the ocr architecture of owocr.

to maintain this focus, there are a few things meikipop is not:

• it is not an srs-mining tool. meikipop does not include functionality to automatically create flashcards for programs like Anki.
• it is not a multi-dictionary tool. while technically possible to adapt, the lookup logic is highly optimized for the structure and tags of the JMdict dictionary.

this is the easiest way to run meikipop on windows and linux and is recommended for most users. no python installation required. just download, unpack and start the executable binary:

• https://github.com/rtr46/meikipop/releases/latest

if you want to develop or use custom ocr provider, modify meikipop's behaviour, want to debug an error or prefer to run from source for any other reason, this is the way to go. for windows + linux ignore the macos specific parts.

(note that meikipop is in beta for macos. the tray and therefore the settings menu may or may not show up - you should still be able to configure meikipop through the config.ini. if you notice meikipop breaking with a new release, feel free to let us know via an issue and we will try to fix it.)

1. prerequisites:

   • python 3.10+

2. set required permissions (macos only)

   • go to System Preferences > Security & Privacy > Privacy
   • add/enable your terminal app in Input Monitoring, Screen Recording and Accessibility

3. download the latest release that includes a prebuilt dictionary:

   • git clone https://github.com/rtr46/meikipop.git
   • or simply download and unpack the source archive: https://github.com/rtr46/meikipop/archive/refs/heads/main.zip

4. install python dependencies, build a dictionary and run:

   pip install -r requirements.txt
   pip install lxml # needed for the build_dictionary script
   python -m scripts.build_dictionary # you can alternatively use the dictionary from one of the binary distributions 
   python -m src.main # run meikipop

1. run the application (python -m src.main). an icon will appear in your system tray.
2. the first time you run the app in region mode, you will be prompted to select an area of your screen to scan (the scanned area will be send to google ocr).
3. move your mouse over any japanese text on your screen.
4. press and hold the hotkey (shift by default). a popup with dictionary entries will appear. depending on your internet connection this may take a while the first time...
5. keep holding the key and move your mouse to look up any additional words.
6. release the hotkey to hide the popup.
7. right-click the system tray icon to open the settings, reselect the scan region, change to full screen mode or quit the application.
8. make sure you try the auto scan mode. it continuously scans your screen to provide you with dictionary entries as fast as possible and without the need to press a hotkey.

you can fully customize meikipop's behavior and appearance. right-click the tray icon and choose "settings" to open the configuration gui.

changes are saved to config.ini in the same folder as the application.

while meikipop's default google ocr backend is powerful, fast and platform independent, you may want to use a different ocr backend for reasons like privacy or offline capabilities. meikipop's architecture allows you to choose whatever ocr suits your use case best.

the easiest way to change the ocr backend is by running a local owocr instance and selecting the owocr ocr provider from meikipop's system tray menu.

make sure you:

• use owocr 1.15.0 or newer
• enable reading from and writing to websockets
• choose the json output format
• and use an ocr backend that supports coordinates (currently oneocr, apple live text, google lens and bing)

  pip install -U "owocr>=1.15"
  owocr -r websocket -w websocket -of json -e glens # replace glens with your favorite owocr backend

you can develop your own ocr provider. to get started, you can copy the dummy provider and use it as a template.

for a complete guide, see: how to create a custom ocr provider

note that this feature is not available in the bundled windows executable for now

you can find a bundled archive that contains meikipop src + a prebuilt dictionary in the releases. if you really want to build your own dictionary however, you can do that:

python -m scripts.build_dictionary

for more details, you can look here: Nazeka

meikipop is licensed under the GNU General Public License v3.0. see the LICENSE file for the full license text.