Skip to content

Ich73/BinJEditor

Repository files navigation

BinJ Editor

BinJ Editor lets you import, edit, save, share and export translations for games using the .binJ and .e formats to store messages. Those games include Dragon Quest Monsters: Terry's Wonderland 3D and Dragon Quest Monsters 2: Cobi and Tara's Marvelous Mysterious Key.

Screenshot

Using BinJ Editor

You can download the newest version from the Release Page. There are two downloads:

  • BinJEditor-Standalone.zip: Extract the archive to a directory of your choice and run BinJEditor.exe.
  • BinJEditor-Installer.zip: Extract the archive and run BinJEditor-Installer.exe in order to install BinJ Editor on your PC. You can then start it from the start menu. File associations will be registered for .savJ, .savE, .binJ and .e files.

To import a file choose File > Import... and select the file. This process may take a few seconds. Now you can start editing the file by entering text into the last column. When you finished editing you can save a project file by choosing File > Save As... or export an edited .binJ or .e file by choosing File > Export....

More information can be found in the Wiki.

If you cannot start BinJ Editor on Windows 7, have a look at this answer. Additionally you may want to install Python 3.8.

For Developers

Setup

This program is written using Python 3.8. You can install the required packages with the following commands.

python -m pip install pyqt5>=5.15.0
python -m pip install pyperclip>=1.8.0

Addionally you need lrelease, a Qt tool for converting .ts translation files to .qm files.

Compiling Resources

To convert the translation files and pack them with the other resources into a single Resources.py file, you can run the following commands. This is needed whenever you change any resource file.

pylupdate5 BinJEditor.pyw Resources/Forms/window.ui Resources/Forms/ftpclient.ui Resources/Forms/searchdlg.ui -ts -noobsolete Resources/i18n/de.ts
lrelease Resources/i18n/de.ts

pylupdate5 BinJEditor.pyw Resources/Forms/window.ui Resources/Forms/ftpclient.ui Resources/Forms/searchdlg.ui -ts -noobsolete Resources/i18n/en.ts
lrelease Resources/i18n/en.ts

pylupdate5 BinJEditor.pyw Resources/Forms/window.ui Resources/Forms/ftpclient.ui Resources/Forms/searchdlg.ui -ts -noobsolete Resources/i18n/es.ts
lrelease Resources/i18n/es.ts

lrelease Resources/i18n/qtbase_de.ts
lrelease Resources/i18n/qtbase_en.ts
lrelease Resources/i18n/qtbase_es.ts

pyrcc5 Resources.qrc -o Resources.py

Running

You can run the program by using the command python BinJEditor.pyw.

Distributing

To pack the program into a single executable file, pyinstaller is needed.
Run the command pyinstaller BinJEditor-OneFile.spec --noconfirm and the executable will be created in the dist folder.
Run the command pyinstaller BinJEditor-OneFolder.spec --noconfirm and the program files will be created in the dist/bin folder.