To get the command line help for binmerge, use `./binmerge --help`.
### Example: Merge a split image
To merge a set of bin files for a given cuesheet:
`./binmerge "/path/to/My Great Game.cue" "My Great Game (Merged)"`
This will create two new files, "My Great Game (Merged).bin" and "My Great Game (Merged).cue". These will be created alongside your existing files in the same directory unless specified otherwise.
To control the output directory, use the --outdir flag:
`./binmerge -o "/mnt/stuff/merged-games" "/path/to/My Great Game.cue" "My Great Game (Merged)"`
### Example: Split a merged image
If you want to reverse the process and create split files again, binmerge supports that. But do note, for some games, the Redump cuesheet contains information that binmerge cannot reasonably preserve when merging. If you're trying to get back to a pristine Redump set, you may want to download the freely available cuesheets available on Redump's web site.
To split a merged bin/cue:
`./binmerge --split --outdir "/mnt/stuff/split-games" "/path/to/My Great Game.cue" "My Great Game"`
This will create a new cue sheet and a series of .bin files, like this:
```
My Great Game.cue
My Great Game (Track 1).bin
My Great Game (Track 2).bin
```
As before, if `outdir` is not specified, the new files will be written alongside the existing files.
Sometimes discs are ripped in such a way that they have a separate bin file for every track. One example that I know of is the Redump project, specifically for the Playstation 1 or PSX.
Some software cannot read this style of disc image, because they only know how to work with a single bin file or are unable to properly parse cuesheets according to the standard.
`binmerge` reads a cuesheet and its associated series of bin files and generates a new, single merged bin file and cuesheet. It is completely non-destructive and does not touch your existing files.
