Skip to main content

gamesentenceminer

GSM (GameSentenceMiner)

Turn your gaming time into language mastery.


🎮 See it in Action

Demo Gif

  • OCR to get get text from a game that doesn't support text hooks.
  • Look up words with Yomitan in game.
  • Create Anki cards with game audio + screenshot (or gif) automatically.

What does it do?

GSM is an application designed to automate the process of creating flashcards while you play. It sits between your game and Anki, handling audio recording, screenshots, and OCR so you don't have to interrupt your gameplay.

📝 Anki Card Enhancement

GSM automatically adds context to your Anki cards whenever you create them.

  • Audio Capture: Uses Voice Activity Detection (VAD) to record and trim the specific voice line associated with the text.
  • Screenshots: Captures the game state the moment the line is spoken. GIFs and Black Bar Removal are supported.
  • Mine from History: Go back and create cards from previous lines you've encountered (i.e. cutscenes).
  • Multi-Line Support: Capture multiple lines of dialogue into one card using the built-in Texthooker.
  • AI Translation: Optional integration to provide sentence translations using your own API key.

https://github.com/user-attachments/assets/df6bc38e-d74d-423e-b270-8a82eec2394c

👁️ OCR (Text Recognition)

For games that don't have a text hook (Agent/Textractor), GSM uses a custom fork of OwOCR to read text directly from the screen.

This opens up all kinds of posssibilities for games that would otherwise be inaccessible for language learning/sentence mining. For example I've made cards with games like Metal Gear Solid 1+2, Titanfall 2, and Sekiro, all using GSM's OCR.

  • Easy Setup: Managed installation means you don't need to fiddle with terminals.
  • Two-Pass System: Clean, fast output similar to as if you had a hook.
  • Customizable Capture Zones: Define exactly where text appears on your screen for optimal results.

https://github.com/user-attachments/assets/07240472-831a-40e6-be22-c64b880b0d66

🖥️ Overlay

GSM includes a transparent overlay for instant dictionary lookups.

  • Hover over characters in-game to see definitions via Yomitan.
  • Create cards without ever leaving the game window.
  • Automatically Generated Furigana Display In Game.

Overlay Demo

📊 Statistics

Track your immersion habits with the stats dashboard.

  • Kanji Grid: View every Kanji you've encountered and click them to see their source sentences.
  • Goals: Set daily reading targets.
  • Tools: Clean up and organize your mining history.

stats


🚀 Getting Started

  1. Download: Get the latest release.
  2. Install: Watch the Installation Guide.
  3. Requirements:
    • An Anki tool (Yomitan, JL, etc.)
    • A text source (Agent, Textractor, or GSM's built-in OCR)
    • A game

📚 Documentation

For full setup guides and configuration details, check the Wiki (Currently WIP).

❤️ Acknowledgements

Integrated Components

This project includes modified versions of the following libraries, I got tired of submodule hell so I've included them directly here for easier management all credits go to the original authors:

Star History

Star History Chart

Sponsors

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

Metadata

Release files for GameSentenceMiner 2026.10.3.post1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for GameSentenceMiner 2026.10.3.post1
File Size Uploaded Provenance Actions
gamesentenceminer-2026.10.3.post1.tar.gz 37.5 MB Without provenance Details for gamesentenceminer-2026.10.3.post1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for GameSentenceMiner 2026.10.3.post1
File Interpreter ABI Platform Actions
gamesentenceminer-2026.10.3.post1-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for gamesentenceminer-2026.10.3.post1-cp311-abi3-win_amd64.whl
gamesentenceminer-2026.10.3.post1-cp311-abi3-manylinux_2_28_x86_64.whl CPython 3.11 abi3 Linux glibc 2.28+ x86-64 Details for gamesentenceminer-2026.10.3.post1-cp311-abi3-manylinux_2_28_x86_64.whl
gamesentenceminer-2026.10.3.post1-cp311-abi3-macosx_12_0_arm64.whl CPython 3.11 abi3 macOS 12.0+ ARM64 Details for gamesentenceminer-2026.10.3.post1-cp311-abi3-macosx_12_0_arm64.whl

Total release size: 153.2 MB

Release files / gamesentenceminer-2026.10.3.post1.tar.gz

Download URL gamesentenceminer-2026.10.3.post1.tar.gz
Size 37.5 MB
Tags Source
SHA-256 checksum
How to use checksums
3f6f78d7a53d44a0edce64ac49f9d994374a48080ea228c9ab9a185e7ebf184d
BLAKE2b-256 checksum
How to use checksums
858fd91a57d792c2e97352d004591fea4e11a81d1ac05543896323dba9ed997e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / gamesentenceminer-2026.10.3.post1-cp311-abi3-win_amd64.whl

Download URL gamesentenceminer-2026.10.3.post1-cp311-abi3-win_amd64.whl
Size 38.5 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
9e1d28ba6d2aff5ced261aa3b42bfbbdb96b63429d73014478738767bf5299c6
BLAKE2b-256 checksum
How to use checksums
126d5264c9ed7bd1f4043d70ec8fb999db43021c456ce7b62709b94203cc7a7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / gamesentenceminer-2026.10.3.post1-cp311-abi3-manylinux_2_28_x86_64.whl

Download URL gamesentenceminer-2026.10.3.post1-cp311-abi3-manylinux_2_28_x86_64.whl
Size 38.6 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
56d44c1a00d4090f841683a116424faac6bbf292e4eefec1ee416224bf4ef91a
BLAKE2b-256 checksum
How to use checksums
b8b526c1d56b2fa2ae4ee8b6e18a71b38d22b2d4d2515b569a5846df4602968f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / gamesentenceminer-2026.10.3.post1-cp311-abi3-macosx_12_0_arm64.whl

Download URL gamesentenceminer-2026.10.3.post1-cp311-abi3-macosx_12_0_arm64.whl
Size 38.6 MB
Tags CPython 3.11 abi3 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
2ae3e1cda074711566e3142b93dabb73a493602d0c6aa9b7ab266fc546aab7d0
BLAKE2b-256 checksum
How to use checksums
bc7e1e0b64659eb2adc10b2fef727b5e332c49a9002af8b27c0c90864bd752b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for GameSentenceMiner 2026.10.3.post1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page