Scan modes overview
Region mode
Scans only a user-selected rectangular area of your screen.Pros:
- Faster OCR processing
- Lower network bandwidth
- Better privacy (only selected area sent to OCR)
- More efficient for auto scan mode
- Games in windowed mode
- Manga readers
- Specific applications
- When you know where text will appear
Fullscreen mode
Scans your entire screen (all monitors).Pros:
- No need to select a region
- Works anywhere on screen
- Automatic adaptation to content
- Good for unpredictable text locations
- Fullscreen games
- Multiple applications
- Text in varying locations
- When convenience matters most
The default mode is region. The first time you run meikipop, you’ll be prompted to select an area.
Switching between modes
- Via system tray
- Via config.ini
Selecting a screen region
When using region mode, you’ll need to select the area containing Japanese text.Selection process
Trigger the region selector
The selection overlay appears automatically when:
- First running meikipop in region mode
- Clicking Reselect Scan Region from tray menu
- Switching from fullscreen to region mode
Position the overlay
A semi-transparent dark overlay covers your screen. Your cursor changes to a crosshair.
The overlay follows your cursor across multiple monitors.
Click and drag
- Click where you want the top-left corner of the region
- Drag to the bottom-right corner
- A blue border shows your selected area
Selection tips
Reselecting a region
You can change your selected region at any time:The new region takes effect immediately. No restart required.
Performance comparison
Region mode performance
OCR processing time
OCR processing time
Smaller images process faster:
- 400x300 region: ~200-400ms (Google Lens)
- 800x600 region: ~400-600ms
- 1920x1080 region: ~800-1200ms
Network bandwidth
Network bandwidth
Without compression:
- 400x300 region: ~50-100 KB per lookup
- 800x600 region: ~150-300 KB per lookup
- 1920x1080 region: ~400-800 KB per lookup
- Reduces bandwidth by 50-80%
- Typical: 20-100 KB per lookup regardless of size
Auto scan mode impact
Auto scan mode impact
In auto scan mode, smaller regions:
- Reduce CPU usage
- Lower network consumption
- Enable higher scan frequencies
- Decrease battery drain
Fullscreen mode performance
Multi-monitor considerations
Multi-monitor considerations
Fullscreen mode captures all monitors:
- Single 1920x1080: ~400-800 KB per screenshot
- Dual 1920x1080: ~800-1600 KB per screenshot
- Triple monitor: 1200-2400 KB per screenshot
- Longer OCR processing times
- Higher network usage
- Not recommended for auto scan mode
When fullscreen is acceptable
When fullscreen is acceptable
Fullscreen mode works well when:
- Using manual mode (not auto scan)
- OCR provider is local (owocr)
- Fast internet connection (100+ Mbps)
- Powerful CPU for image processing
- Single monitor setup
Privacy considerations
Understanding what data is sent to OCR providers:- Region mode
- Fullscreen mode
- Local OCR (owocr)
Data sent to OCR:
- Screenshot of only the selected region
- Typically a small portion of your screen
- No data from outside the region
If privacy is a concern, select the smallest region that contains the Japanese text you need to read.
Google Lens privacy
When using Google Lens as the OCR provider:- Screenshots are sent to Google’s servers
- Processed by Google Lens OCR service
- Subject to Google’s privacy policy
- Data is typically not stored permanently
- Not linked to your Google account
Google Lens compression reduces the image quality sent to Google, which provides a minor privacy benefit in addition to bandwidth savings.
Use case recommendations
- Visual novels
- Games (windowed)
- Games (fullscreen)
- Manga readers
- Web browsers
- Multiple apps
Recommended: Region mode✅ Text appears in consistent location
✅ Small text box = fast OCR
✅ Perfect for auto scan mode
✅ Minimal performance impactSetup:
- Launch the visual novel
- Select region mode
- Select the text box area
- Enable auto scan mode
Technical details
Region selection implementation
Coordinate system
Coordinate system
The region selector handles both logical and physical coordinates:Logical coordinates:
- Used by Qt for drawing the selection overlay
- May differ from physical pixels on high-DPI displays
- Actual pixel positions on the screen
- Used for screenshot capture
- Account for display scaling factors
Multi-monitor support
Multi-monitor support
The region selector supports multiple monitors:
- Overlay follows cursor across screens
- Can select regions spanning multiple monitors
- Each monitor’s geometry is correctly handled
- DPI scaling per-monitor is supported
Magpie compatibility
Magpie compatibility
On Windows, when
magpie_compatibility = true:- Meikipop applies coordinate transformations
- Accounts for Magpie’s upscaling
- Ensures popup appears at correct location
- Properly maps mouse position to screenshot coordinates
Fullscreen mode behavior
Screenshot capture
Screenshot capture
In fullscreen mode, meikipop:
- Enumerates all connected displays
- Captures each display as a separate image
- Stitches them into a single composite screenshot
- Sends the composite to the OCR provider
Popup positioning
Popup positioning
When the popup would appear outside the visible screen area:
- Meikipop detects the screen containing the cursor
- Ensures popup stays within that screen’s boundaries
- Applies the configured positioning mode
- Prevents popup from being cut off at screen edges
Troubleshooting
Region selector doesn't appear
Region selector doesn't appear
Possible causes:
- Already in fullscreen mode
- Application crashed during previous selection
- Qt window system issue
- Check config.ini: ensure
scan_region = region - Restart meikipop
- Try toggling to fullscreen and back to region
- On Linux: verify DISPLAY environment variable is set
Can't select region in fullscreen game
Can't select region in fullscreen game
Fullscreen games take exclusive control of the display.Solutions:
- Run the game in borderless windowed mode
- Or run in regular windowed mode
- Then use region selection
- Use fullscreen scan mode instead
- Accept the performance trade-off
Popup appears in wrong location after region selection
Popup appears in wrong location after region selection
This may occur due to coordinate system mismatches.Solutions:
- On Windows with Magpie: Enable
magpie_compatibility - Check display scaling settings (125%, 150%, etc.)
- Try reselecting the region
- Report the issue with your display configuration
Region is forgotten after restart
Region is forgotten after restart
The region should persist in
config.ini or a separate settings file.Check:- File permissions on config.ini
- Whether config.ini is being saved
- Any errors in the terminal/log output
- If running from a read-only directory
OCR quality is poor in region mode
OCR quality is poor in region mode
Troubleshooting:
- Ensure region includes full characters (not cut off)
- Add small margins around text
- Check if text is clear and well-lit
- Verify region contains the intended area
- Try disabling Google Lens compression