Skip to content

SpoilerRules/pipsi-utils

Repository files navigation

Pipsi Utilities

CodeFactor GitHub Downloads GPL-3.0 License

Pipsi Utils is a command-line app that automates Pipsi installations and updates with an interactive interface.

Pipsi Utilities Showcase

Table of Contents

Getting Started

  1. Download the Latest Release
    Visit the releases page and download pipsi-utils_Windows_x86_64.zip.

  2. Extract the Files
    After downloading, extract the zip file. Inside, you'll find pipsi-utils.exe.

  3. Move the Executable (Optional)
    For easier access and consistent application data, move pipsi-utils.exe to a preferred location (e.g., C:\Desktop\Favorite Apps\pipsi-utils).
    Note: The tool stores data such as available Pipsi installations in its directory. Running the executable from different locations may result in missing data or duplicated configurations.

  4. Run the Tool
    You can launch pipsi-utils.exe using one of these methods:

    • Via Terminal/Powershell:
      Open a terminal or PowerShell window, navigate to the directory, and run:
      .\pipsi-utils.exe
    • Via Right-Click:
      Right-click pipsi-utils.exe and select Open.
    • Via Double-Click:
      Simply double-click pipsi-utils.exe to run it.

(back to top)

Building from Source

Prerequisites

  • Go 1.24 or newer (64-bit) installed on Windows (download)
  • Git for repository cloning

Build Instructions

  1. Clone the Repository

    git clone https://github.com/SpoilerRules/pipsi-utils.git
  2. Build the Binary

    Dependencies will be automatically fetched by Go Modules. Run:

    go build -o pipsi-utils.exe

    This generates pipsi-utils.exe in the project root.

  3. Run the Application
    Launch the application to verify the build:

    .\pipsi-utils.exe

(back to top)

Frequently Asked Questions (FAQ)

Why am I returned to the main menu after selecting games in the installation menu?

This happens because the Enter key is used to confirm your final selection. To select games:

  • Use / to navigate the list
  • Press X to select/deselect games (selected items turn cyan)
  • Press Enter only when you're done selecting to proceed

Do I need to reinstall this tool for new Pipsi versions?

No. The tool automatically fetches the latest Pipsi versions and updates from the pipsi-utils-cloud repository, so no reinstallation is needed.

Are Chinese installations of Pipsi supported?

Chinese clients are not officially supported. Manual setup is required for Chinese client versions.

Note: Native installation and update support for Chinese client versions is currently in development.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

Top contributors:

contrib.rocks image

License

Distributed under the GNU General Public License v3.0. See the LICENSE file for more information.

(back to top)