Skip to content

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

License

Notifications You must be signed in to change notification settings

zWolfrost/strindex

Repository files navigation

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. You can also use the -g option for any other action to directly open the GUI for that action.

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.

About

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

Resources

License

Stars

Watchers

Forks

Languages