Installation

Igir is supported on Windows, macOS, Linux, and every other operating system that Node.js supports.

There are a few different installation options offered for Igir with varying levels of technical complexity. Every option will require some baseline understanding of command-line interfaces (CLIs).

Via Node.js

The best way to ensure that you are always running the most up-to-date version of Igir is to run it via npx which comes installed with Node.js:

npx igir@latest [commands..] [options]

for example:

npx igir@latest copy extract --dat *.dat --input ROMs/ --output ROMs-Sorted/ --dir-dat-name

Tip

You can alias the npx command in your macOS or Linux dotfiles like this:

macOS Linux

alias igir="npx igir@latest"

alias igir="npx igir@latest"

Note

If you want to help beta test Igir, you can run the most bleeding-edge version with the command:

npm exec --yes -- "github:emmercm/igir#main" [commands..] [options]

Via Homebrew (macOS)

Homebrew is a third-party package manager for macOS. You can install Igir with these simple commands:

brew tap emmercm/igir
brew install igir

You can then update Igir with either of these commands

# Update every Homebrew package
brew update

# Update only igir
brew upgrade igir

Via downloaded executable

If you don't want to download Node.js, you can download executables for various OSes from the GitHub releases page.