CUERipper Settings

From CUETools
Jump to navigation Jump to search

The main window of CUERipper has many settings, which can be adjusted as needed:

CUERipper_settings (click image to enlarge, click back button in browser to return)

(1) Optical drive selection {drop-down list}

Select the optical drive where the CD is inserted.

(2) Metadata selection {drop-down list}

Select the best match from the list. The source of the metadata is indicated by an icon representing freedb, MusicBrainz, Discogs or CUERipper's local database of manually entered info (same icon as CTDB). This area doubles as an optical drive status window when no disc is found.

(3) Meta / Tracks {button}

Click the Meta button to switch to the Meta window. Click the Tracks button to switch to the Tracks window.

(4) Tracks window

Click on track title to quick-edit the title. Click in a column left or right of the track title to bring up an alternate track-edit window to edit the title, artist or comment field for the track. Click Tracks button to return to Tracks window.

(5) Meta window

Click on a line if you need to edit contents. If Comment is blank, CUERipper will insert version info.

(6) Reload {button}

Reloads program data (same as F5 refresh).

(7) V/A (freeDB only) {button}

Button is DISABLED unless freeDB entry track names are in track artist / title format, then the button parses track artist and title for each track.

(8) Codepage (freeDB only) {button}

Button is DISABLED unless freeDB entries are suspected of being non-unicode, then the button translates them to the local codepage. This rarely happens, and never if your local codepage is latin 1.

(9) freeDB submit {button}

Submit disc to freeDB (hosted by gnudb.org).

(10) Output path {drop-down list}

Click to edit or select the output path template.

(11) Audio output type {drop-down list}

Select lossy or lossless audio output. Uncompressed WAV is included under lossless audio output.

(12) Extraction type {drop-down list}

Select image (one big audio file) or tracks (an audio file for each track).

(13) Audio file format {drop-down list}

Select file format. List dependent on the (11) Audio output type setting.

(14) Encoder {drop-down list}

Select encoder (if more than one choice is available). List dependent on the (13) Audio file format setting. (See also CUETools FLAC encoders comparison)

(15) Read offset {spinner}

CUERipper should detect read offset correction setting for you. Changing this setting is not recommended.

(16) Test & Copy {checkbox}

Tests all tracks prior to extraction. Test CRC will be added to the extraction log.

(17) Encoder mode {slider}

Slide to the desired mode or compression level. Slider values dependent on the (14) Encoder setting. For lossless codecs this doesn't affect quality, higher modes normally produce smaller files, but extraction can be slower. For lossy codecs higher modes normally produce larger files with better audio quality.

(18) Extraction method {slider}

Slide to the desired mode.

Burst mode = Reads section once. If the drive reports C2 errors, then error correction begins and up to 15 more read retries are done. No CTDB submission will be made because some errors may not have been reported via C2 ("insufficient quality").
Secure mode = Reads section once, then one retry. If results differ or the drive reports C2 errors, then error correction begins and up to 30 more full or partial read retries are done for that section. (See also: (25) Error Correction Progress bar)
Paranoid mode = Reads section once, then two retries. If results differ or the drive reports C2 errors then error correction begins and up to 61 more full or partial read retries are done for that section. (See also: (25) Error Correction Progress bar)

(19) Album Art preview

Displays front cover (if found). Hover mouse pointer and click to change selected image.

(20) Task messages

Displays task progress messages.

(21) MusicBrainz submit {button}

Submit disc to MusicBrainz.

(22) CUETools Database status

Hover your mouse pointer to see status message. Number indicates possible pre-verification database entries for your CD's TOC.

(23) AccurateRip Database status

Hover your mouse pointer to see status message. Number indicates possible pre-verification database entries for your CD's TOC.

(24) Read progress {bar graph}

Shows read progress.

(25) Error Correction Progress {bar graph}

Shows severity and correction progress of read errors. If the errors cannot be corrected after maximum retries, suspicious positions are added to the extraction log.

(26) Overall completion status {bar graph}

Shows completion percentage.

(27) Go / Pause / Abort {button}

Go displayed when program is idle, Pause & Abort displayed when program is active. Select Go to start ripping. Pause or Abort as needed.

(28) Options {button}

Click to open Options window. See CUERipper Options for more information.

(29) Encoder Options {button}

Built-in encoder options

Options vary by encoder. Highlight option to see description at the bottom of the window.

External encoder options

Name {textbox}
Name of the encoder that will be displayed in the {drop-down list} under the (14) Encoder setting in the main window.
Extension {textbox}
Audio file format extension for selected encoder.
Lossless {drop-down list}
True for lossless encoder. False for lossy encoder.
SupportedModes {textbox}
Supported mode values, separated by space character. Linked to the (17) Encoder mode {slider} control in the main window.
DefaultMode {textbox}
Greyed out. Position of (17) Encoder mode {slider} control in the main window.
Path {textbox}
Path to external encoder executable.
Leave textbox as is (e.g. encoder.exe) and copy the encoder.exe file (and any dependencies) to the CUETools program folder or
Leave textbox as is (e.g. encoder.exe) and add full path to the location of the encoder.exe file to the system's %PATH% environment variable or
Enter the full path (e.g. C:\opus\opusenc.exe) if the file is located somewhere else.
Parameters {textbox}
Arguments for external encoder executable (Encoding parameters only. Please refer to the encoder's documentation for more info about usage parameters.). The required placeholder arguments used by CUERipper for external encoders are:
"-" : (without the quotes) = stdin (standard input).
%O : will be replaced by the output file name
Optional:
%M : will be replaced by the value from DefaultMode (selected via (17) Encoder mode {slider} on main screen).
%P : padding metadata block bytes to add to header. (This placeholder is for encoders that support padding, e.g. flake, flac, etc. so CUERipper can reserve space to write the metadata after encoding.)

(30) Eject {button}

Click to eject CD

(31) C2 Error Mode {drop-down list}

None
No C2ErrorMode detection
Mode294
Force Mode294
Mode296
Force Mode296
Auto (default)
Automatic detection of C2ErrorMode

For some drives, automatic detection of C2ErrorMode does not work properly when trying to check Mode294. There is already a built-in fix for a few specific drive models, however, there may be other drives with a similar issue. If, at the start of the extraction, you encounter an error similar to

 "Exception: Error reading CD: medium error: UNRECOVERED READ ERROR"

try one of the other settings.


Drive Feature Detection

Some drive features are automatically detected by CUERipper:

  • read command
  • read offset correction
  • gap detection method
  • support for C2 error reporting

Of these, only

can be changed by the user.