Skip to main content

A command line utility to extract and patch strings of some filetypes, with a focus on compatibility and translation.

Project description

strindex

PyPI version PyPI downloads GitHub downloads license

A command line utility to extract and patch strings of some filetypes, with a focus on compatibility and translation.

This utility will allow you to replace strings in supported filetypes with other strings. It's useful to change the text of a program without having to recompile it, for example, to translate a program into another language.

Aside from using pointers to replace strings, there's also an option to use the original string itself to ensure compatibility with different versions of the same program.

It features various built-in features to help with translation, such as spellchecking & filtering strings by length and character set.

Supported filetypes

Support for more types is not planned.

  • PE files (".exe, ".dll"...) (direct pointers only)
  • Gamemaker data files ("data.win")
  • Forceful replacement in every filetype...

Installation

You can install the program with the command pip install strindex.

Alternatively, the releases tab includes a precompiled version of the program, which by default opens the gui mode (unless executed with arguments). Warning: the precompiled version has a high chance of being detected as a false positive by antivirus software. You can compile the program yourself to avoid this.
Also, the apt package libxcb-cursor0 is required for the linux build.

Usage

You can run the program with the command strindex <action> <input file(s)> [arguments].

strindex -h will show the available arguments.

These are the available actions:

  • create: Create a list of strings (a strindex) extracted from a file. Use -f to enable "force" mode, and replace strings at the same offset they were found. Use -c to create a strindex that uses the original strings as references, instead of pointers.
  • patch: Patch a file with a strindex. Strindexes compressed with gzip are also supported for all actions.
  • update Update a strindex file pointers' with the updated version of a file.
  • filter: Filter a strindex by detected language, wordlist or length. You can specify those in the strindex settings.
  • delta: Create a delta file between two strindexes, that only contains the lines of the first strindex missing in the second one (their difference).
  • spellcheck: Spellcheck a strindex. You can specify the target language in the strindex settings as an ISO 639-1 code.
  • gui: Open Strindex in GUI mode.

Usage Examples

  • Open strindex in GUI mode:
    strindex gui
    
  • Create a strindex from a PE file and save it to ./strindex.txt:
    strindex create program.exe -o strindex.txt
    
  • Patch a PE file with a strindex:
    strindex patch program.exe strindex.txt
    

Strindex Example

You can find an example of a strindex file and an explanation of its settings here.

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

strindex-3.8.0.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

strindex-3.8.0-py3-none-any.whl (22.9 kB view details)

Uploaded Python 3

File details

Details for the file strindex-3.8.0.tar.gz.

File metadata

  • Download URL: strindex-3.8.0.tar.gz
  • Upload date:
  • Size: 21.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for strindex-3.8.0.tar.gz
Algorithm Hash digest
SHA256 220880878be1010ce3af13dbc20ab2c04c41bd698fbd42a304ea086d1d294dc0
MD5 0c1847184e029a31d16b2e3fde9c836f
BLAKE2b-256 3dd9f0939ee023c4f11c6f4cf1e768cae79c83d750e3f2b6560513b0888967fe

See more details on using hashes here.

File details

Details for the file strindex-3.8.0-py3-none-any.whl.

File metadata

  • Download URL: strindex-3.8.0-py3-none-any.whl
  • Upload date:
  • Size: 22.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for strindex-3.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a752f9009bbe8c9942d45524b7e8803ec927a5e1ad4786cefa7a526fbdf64978
MD5 220279d14fd67b079a02986c92b019bd
BLAKE2b-256 9149e6fba045a5b44cd885e598079cded9390b02e73b85b57d5521feea4e66c8

See more details on using hashes here.

Supported by

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