Usage

Usage

dcue [(r)elease=|(m)aster=]<id> <audio filename>

In addition to the obligatory --help (-h) option, DCue supports only 2 arguments: the first is a Discogs release/master release ID and the second is the name, with optional path, of the file you want to create a cue sheet for.

The first argument is either m=<id> or master=<id> for a master release or r=<id> or release=<id> for a regular release (if just <id> is given, it's assumed to be regular). To find these IDs, go to Discogs and search for the release by title. You can copy the ID from the URL of the release page (it's the numeric one). It's recommended that you use regular releases rather than masters as much as possible but the choice is there at your discretion.

The output for a specific release will only be as useful as the info Discogs actually has for that release. The Discogs API doesn't confer any additional info so if the release page doesn't have track durations, neither will the resulting cue file.

The second argument is either a full path to or just the filename of an audio file of any format (e.g. wav, mp3, flac etc.) that you want to make the cue sheet for (relative paths may also be acceptable depending on the platform). If only a filename is specified, the cue sheet will be created in the current working directory. Note that the choice of using a path will not affect the created cue (which still specifies just the filename), it'll only affect the directory the cue gets put in.

The second argument will also accept the special character ? within paths and filenames which will be automatically replaced by the disc number in multi-disc releases everywhere that the filename is used. Multi-disc releases will result in multiple cue sheets being made. Unfortunately this means you can't currently use literal ?s in names but that's not really a big loss since it's illegal or ill-advised on most platforms anyway.

DCue produces cue files on a best effort basis. It won't produce errors or even warnings for conditions that aren't actually erroneous so if track lengths are missing, it'll simply put out a cue sheet without that information (or with each track set to begin at 00:00:00 to be precise). For this reason, it's best to check the resulting cue file to make sure it's actually what you wanted.