Skip to main content

A tool for grabbing binary text from a No Man's Sky screenshot and translating it to UTF-8 for you.

Project description

NMS Lore Translator

ko-fi Publish to PyPi

With the Echoes update, No Man's Sky introduced some dialogue written in binary. I created this tool so that I could easily grab the screen, extract the binary text, and then convert it to UTF-8 characters. It will then append each new bit of lore to a file in your home folder.

Caveats

This was only tested on Ubuntu 23.04 with a screen resolution of 1920x1080 and the game running in full screen. It should, theoretically, work on any OS with the Tesseract OCR library installed, but it has not at all been tested and I take no responsibilites for this.

Installation

You can either clone this repository and then run poetry build && pip3 install --user dist/nms_ts-<version>-py3-none-any.whl or you can install from PyPi with just pip3 install --user nms-ts

Usage

The script runs and copies everything it sees on the screen within the resolution as soon as you call it. This could cause issues if your terminal pops up over the game as it will try to read binary from that as well and then fail because it's not proper binary. I would suggest, instead, binding to a hotkey:

nms --xend=<your X resolution> --yend=<your Y resolution>

Then, when you hit your hotkey, it will run the script without launching a terminal, therefore introducing no confusion for the script. Doing it like that will make it capture your entire display and attempt to extract from there. However, you can also specify just a small portion of your screen (to get a more exact area to translate and minimize possible errors) by specifying more exact xstart, ystart, xend and yend values.

Changelog

  • v1.1.3
    • Preserve spaces
  • v1.1.2
    • Actually fixed the damn thing
  • v1.1.1
    • Fixed capture and translate
  • v1.1.0
    • Added option to set boundary box
    • Made it so that values actually get passed to grab function
    • Now filters out characters that are not proper binary digits
  • v1.0.0
    • Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nms_ts-1.1.3.tar.gz (3.4 kB view hashes)

Uploaded Source

Built Distribution

nms_ts-1.1.3-py3-none-any.whl (5.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page