Skip to content

Linux Install Help

Beangate edited this page Jul 24, 2025 · 10 revisions

Linux is technically supported, but is not the main focus of this project. I like Linux gaming as a concept, but Windows will likely always be king in that regard. These instructions are very rough and were done on a fresh install of Ubuntu.

IF you want to do this for Steam Deck and have a Windows machine, I would personally recommend having a mixed setup instead, which involved having GSM/Anki/game running on the computer and remotely stream them to the Steam Deck with Moonlight/Sunshine. You can map the back buttons to alt-tab, etc., and the little square areas for mouse interaction. I might write more detailed instructions at another time.

Instructions for Debian/Ubuntu only. I will not make one for other distros. Linux people are responsible for figuring it out beyond that.

Install Python 3.10, 3.11, or 3.12 and other python dependencies with sudo apt install python3 python3-venv python3-tk python3-pip Make new venv python3 -m venv venv (maybe do this in ~/.config/GameSentenceMiner for cleanliness, but up to you) activate: source venv/bin/activate install gsm pip install gamesentenceminer Install obs

Configure OBS:

  • Tools -> Websocket Server -> Turn on Websocket Server, Get password and put it in GSM's config OR turn off auth (should be fine for private network)
    • Settings -> Output
      • Recording
        • Recording Path: Set to /home/{YOUR_USER}/Videos/GSM
        • Recording Quality: High Quality (Optional)
        • Audio Encoder: Opus (Optional)
      • Replay Buffer
      • Maximum Replay Time 60-90s - This can go much higher as of recent versions.
    • Setup Scene for your game, I can't really help with this. Just make sure you get audio and video output.

Install Anki and Anki Connect (assume this is already done)

run gamesentenceminer in terminal that's venv activated

I do not have a viable gaming setup, so I cannot really test mining from a game currently, but I know at least one person has had success with it in linux.

Known Issues just from me looking around…

Tray icon may not work, you need to manually run python -m GameSentenceMiner.config_gui while venv activated, or edit the config manually at ~/.config/GameSentenceMiner/config.json

Clone this wiki locally