Be-Music Helper (2xxbin Modified Version)

Language: English, 한국어

This program is a modified version of Be-Music Helper by exclusion.

It is based on the forked version by zardoru.

If you encounter any issues with modifying or distributing the program, please feel free to contact us. We will respond courteously and take appropriate action.

FAQ

Is Apple Silicon-based macOS not supported?

It is supported. However, due to the lack of a GitHub Action runner that can operate in the Apple Silicon environment, we are currently unable to provide precompiled binaries.

If needed, please refer to the instructions under Building from Source below to compile and use the program manually.

How do I reset the language settings?

To reset the language settings, please delete the setting.xml file located at the following path based on your operating system:

• Windows: %APPDATA%\Be-Music Helper\setting.xml
• macOS: ~/Library/Application Support/Be-Music Helper/setting.xml
• Others: ~/.config/Be-Music Helper/setting.xml

Once the settings file is deleted, the language will be reset the next time you launch the application.

Getting Started

Using Precompiled Binaries

1. Download the appropriate file for your operating system from the Releases page:

   • Windows 64-bit: bmhelper_<VERSION>_win-x64.zip
   • Intel-based Mac: bmhelper_<VERSION>_mac-x64.zip

2. Install the downloaded file according to your OS, then run the executable to start the program.

Building from Source

Before you begin, make sure CMake is installed on your system.
If not, you can download it from the official CMake website.

1. Clone the bmhelper repository:

git clone https://github.com/2xxbin/bmhelper.git
cd bmhelper

2. Install the required dependencies:

# Windows
vcpkg install libsndfile wxWidgets

# macOS
brew install libsndfile wxWidgets

3. Generate the build directory using CMake:

cmake . -B build -DCMAKE_BUILD_TYPE=Release

4. Navigate to the build directory and compile:

cd build
make

5. Once the build is complete, copy the i18n folder from the project root into the dist folder.

6. Run the executable inside the dist folder to start the program.

How to Add a New Language

Adding a new language requires the gettext tool.
If it's not installed, you can download it from the official gettext website.

Make sure .po files are saved with UTF-8 encoding, and avoid modifying the original source strings during translation.

1. In src/common.h, add the new language to the SupportedLanguages enum.
   Be sure to increment the LANG_COUNT value accordingly.

enum class SupportedLanguages {
    DEFAULT = wxLANGUAGE_DEFAULT,
    ENGLISH = wxLANGUAGE_ENGLISH, // en_GB
    SPANISH = wxLANGUAGE_SPANISH, // es_ES
    NORWEGIAN = wxLANGUAGE_NORWEGIAN_BOKMAL, // nb_NO
    JAPANESE = wxLANGUAGE_JAPANESE, // ja_JP
    KOREAN = wxLANGUAGE_KOREAN, // ko_KR
    ADD_LANG = wxLANGUAGE_ADD_LANG, // lang_LANG
    LANG_COUNT = 7 // previous value + 1
};

2. In src/Configuration.cpp, add the new language name to the LangNames array in the same order:

wxString LangNames[] = {
    "System",
    "English",
    wxString::FromUTF8("Español"),
    wxString::FromUTF8("Norsk (Bokmål)"),
    wxString::FromUTF8("日本語"),
    wxString::FromUTF8("한국어"),
    wxString::FromUTF8("ADD_LANG") // New language
};

3. Create a new locale folder inside the i18n directory (e.g., i18n/fr_FR).

4. Copy bmhelper.po from i18n/en into the new folder and translate it into the target language.

5. Compile the .po file into a .mo file using the following command:

msgfmt -o i18n/<LOCALE>/bmhelper.mo i18n/<LOCALE>/bmhelper.po