Skip to content

Cross-Platform Mod Installer

Multiplatform installer (Windows, Mac and Linux)

Multiplatform installer instructions

  1. Click on your operating system below for instructions on downloading and launching the installer.

    Windows
    1. Download and Run the 07th-Mod.Installer.Windows.exe file from the Download Page
    2. A Windows SmartScreen warning may appear. If it does, click "More info", then choose "Run anyway".
    3. A console window will popup. DO NOT CLOSE THIS WINDOW until you are finished using the installer.
    4. Wait while the installer extracts to the folder 07th-mod_installer.
    5. When extraction is finished, the installer GUI (a web page) will open. DO NOT CLOSE THIS PAGE.
    6. Continue with the instructions below.
    Mac
    1. Download the Mac Installer
    2. Double-click on the zip to extract it (your browser may automatically do this after downloading)
    !!! warning
        The zip contains two hidden files that are required by the installer.  If you try to move the `install` file out of the folder, it won't be able to find them.  If you really want to move the `install` file out of the folder, press โ‡งโŒ˜. (Shift-Command-Period) to temporarily enable showing of hidden files and copy the `.7za` and `.aria2c` files to the same folder.
    
    1. Right click on the file called install and choose Open
    2. If prompted with a security prompt, choose Open
    Linux
    Linux Users: GNOME Desktop and Ubuntu causes Game Crash - Workaround

    GNOME Desktop (the default on Ubuntu) will cause Higurashi Ep.4 and upwards to crash the entire desktop. This happens even on the base game (without any mods applied). A workaround for this is to install XFCE desktop. You can follow this guide to install XFCE desktop (it can be installed alongside GNOME). Please make sure you can launch the base game before applying any mods (for ease of installation, please don't make any saves on the base game).

    1. Install the following using your distribution's package manager:
      • Python (2 or 3)
      • Python Tkinter
        • Ubuntu: sudo apt-get install python-tk
        • Arch Linux: sudo pacman -S tk
        • Fedora: sudo dnf install python2-tkinter or
          sudo dnf install python3-tkinter
        • If your distribution is not listed, you may need to lookup how to install tkinter on your particular distribution
    2. Download and extract the Linux Installer
    3. Run the shell script called install
  2. Opening the installer will launch a page in your browser. Do not close this page.

  3. On the web page that was just launched, click on the game you want to mod.
  4. Fill in your game path, and mod options as applicable, then start the installation.

    Mac - If path auto-detection fails - Finding Game Path Manually

    If game path auto-detection fails, you can follow these instructions to find the game path:

    1. Click the big green "Select Application (.app file) Manually (Open File Dialog)" button, just below the path entry textbox.
    2. A Finder window entitled "Please choose a game to install to" will open. We will leave it for now, but need it later so don't close it
    3. Open Steam, and navigate to your game list
    4. Right-click on the game you want to mod in the game list, and select "Properties"
    5. Navigate to the "LOCAL FILES" tab of the window that popped up
    6. Click "Browse Local Files". Another finder window will pop up, showing the game files.
    7. Locate the "Umineko1to4"/"HigurashiEp0X" file, which should visually have a proper game icon. Ignore the other files without a proper icon. These files have the ".app" extension, but the extension may be hidden.
    8. Drag and drop the file onto the previously opened "Please choose a game to install to" Finder Window
    9. Click the "Choose" button

    For reference, the default steam folder is ~/Library/Application Support/Steam/steamapps/common/, but yours may be different.

  5. To stop an install that is in progress, you MUST close the terminal window (the black box with lots of text).

  6. Carefully read the information that appears once the install has finished.

Installer FAQ and Troubleshooting

Connection Troubleshooting

First, double check you can access BOTH the following websites in your browser without error:

http://07th-mod.com/

https://raw.githubusercontent.com/07th-mod/python-patcher/master/installData.json

If you cannot access these websites on any computer or phone (on local wifi, NOT mobile internet) that you try:

  • you may have a government firewall blocking access to the above websites.
  • you might be in Japan (we currently don't allow downloads from Japan for legal reasons).
  • an ISP/company/government firewall blocking access to the above websites.

To fix these issues, we suggest using a free VPN, such as https://protonvpn.com/ (do not use with P2P software) or https://www.vpngate.net (harder to use). This will bypass any external blocking of the above websites.

If you cannot open these websites in your browser on your particular computer, but it works on other connections/other computers, you may have a problem with:

  • a local antivirus's firewall blocking access to the above websites. You may need to set an exception for the above websites.
  • a VPN or proxy interfering with access to the above websites (unlikely). You may need to disable the VPN or proxy.

If you can open these websites in your browser, but the installer has a problem accessing these websites, you may have a problem with:

  • an antivirus program blocking our installer specifically (blocking the .exe). You may need to add an exception for our installer.
  • an antivirus or ad-blocker program (or pi-hole) blocking those websites specifically. You may need to add an exception for those websites.
  • your anti-censorship software or VPN software not routing our installer's connection. You may need to enable VPN mode in your software (see below about anti-censorship software).

Can't launch installer - I get a http.client.UnknownProtocol: HTTP/2.0 error when using a VPN or proxy

Please try running the installer without going through a VPN or proxy. Some company/school networks may also cause the same error, as they act as a proxy.

Specifically, "UltraSurf VPN" is known to cause this problem.

While using anti-censorship software (eg. Psiphon), the installer fails to download files, but my browser can download the same files just fine

Please enable the "VPN mode" of your anti-censorship (if it has it). This ensures the installer passes through the anti-censorship software.

This is known to affect the anti-censorship software "Psiphon" (see "Does Psiphon for Windows proxy all of my Internet traffic?")).

Installer crashes on launch - The log has a "TimeoutError: [WinError 10060] A connection attempt failed ..."

Please check if any antivirus/firewall software is blocking the installer. "Comodo Firewall" is known to cause this issue.

Please move the installer .exe to a fresh subfolder and run it from there. This forces a fresh re-extraction of the installer files.

Download stage of installer fails - I get a SSL/TLS handshake failure from Aria2c

Some users have reported getting the following error (will appear in the log):

SSL/TLS handshake failure: Error: The revocation function was unable to check revocation because the revocation server was offline.

The following may help you fix this issue:

  • Disable any VPN or proxy you are using, or try a different internet connection if you are at a school/hotel/business etc.
  • If you have any Windows updates in-progress, let them fully complete before running the installer (including required restarts)
  • Reboot your computer, then try running the installer again

Bug

This installer is currently in development. You might find bugs, and things might not always work - We would be grateful if you report bugs on Github or our Discord server.

Power Users

(Power Users Only) Install from Source
  1. Install these dependencies:

    • Python (2 or 3)
    • Python Tkinter
    • 7-zip
    • Aria2
    • git
  2. Clone our git repository: git clone https://github.com/07th-mod/python-patcher.git

  3. Run python main.py or the equivalent command on your system
Command line interface

The installer also ships with an alternative command line interface for advanced users, in the form of the cli.py script. It can be executed by passing several arguments to it. The following arguments are required:

  • -g GAME -- specify the game to install. This should be words separated by - that are sufficient to recognise the necessary mod, e.g. minagoroshi or umineko-question.
  • -p PATH -- the path to the game installation location.
  • -m MOD_TYPE -- the type of the mod, such as full, voice-only, adv-mode, novel-mode, etc.

The following two are optional:

  • -o MOD_OPTION -- used to install optional mod options, e.g. bgm-fix or ryukishi-sprites. Can be repeated several times to include multiple options, e.g. -o bgm-fix -o se-fix.
  • --non-steam -- this should be specified if patching a non-Steam version of a game.

The web page is hosted entirely locally (and only on the loopback interface) on your computer by the installer - it is not hosted on a remote web page.