Overview
Wagdisc rips audio CDs and sends them to the server for encoding.
Command: wagdisc [switches] [tracks]
tracks lists the tracks from the CD to be ripped and can take the form of "1-5", "1 2 3 4 5", "1 3-5 10" (omitting the quotes in each case) etc. If no tracks are specified, the whole CD is selected.
If you escape wagdisc midway through and wish to resume, just run wagdisc with no -tracks switch and it will resume from where it left off. If you don't wish to resume then you should include the -clean switch.
Switches
| Name | Description |
|---|---|
| -class name | Uses class name if available. |
| -clean | Removes any existing Wagdisc working directory for this disc before proceeding. Use this switch when re-running after aborting an unwanted task. |
| -debug | Turns on debug output. |
| -presubspot yes/no | If set to 'no' turns off the detection of pre and sub-titles. Default is 'yes'. |
| -server-host hostname | Sets the host on which wagenc is running. Overrides the value in client.conf. |
| -server-port number | Sets the port on which wagenc is running. Overrides the value in client.conf. |
| -task name | Uses task name instead of the default value of 'cd'. |
| -tmp directory | Specifies an alternative temporary directory. |
Multiple tasks and classes
Starting with version 0.2 wagdisc allows the specification of multiple tasks and classes on the command-line with names separated by a comma, e.g. -task cd,archive or -class standard,high.
If multiple tasks are specified then each track is submitted to the server repeatedly, once for each task. The first class specified is used for the first task, the second class for the second task etc. I use the following alias to encode a CD into two different formats:
Note that the class switch only indicates a preference and may be overridden when the server responds with valid classes for the specified task(s).
Using Wagdisc
- Run wagdisc, specifying any necessary switches and tracks
- Wagdisc will query the CD against a CDDB server. If the disc matches one or more entries in the database a selection will be shown, along with an option for a blank template. If no entries match, just the blank template option will be available.
- Specify if the disc has multi-artists, such as for a compilation CD. For an existing entry the artist and title will be on a single line separated by a character. Wagdisc will prompt you to identify which style is used. After selecting one of the options the details will redisplay with the title and artist separated. Make sure these are basically correct.
- The next stage is to correct the CDDB information. If the information is complete then this is an optional stage others it's not. The CDDB information should contain titles and artists as well as genre and year information. If you edit the CDDB information you have the option to submit the information to the CDDB server.
- At this point if Wagdisc spots that the last track appears to be a data-track it will offer to remove this from the job list, if this a correct assumption then you should. If Wagdisc doesn't spot a data track you should remove it yourself by removing the section from the details file and adjusting the track-total key at the next stage.
- Wagtail will generate a details file based on the CDDB information. Recognised version tags such as "Instrumental" are spotted and moved to the version field. Also, both text in brackets at the start of a line is moved to the pretitle field and text in brackets at the end of a line is moved to the subtitle field unless the switch -presubspot is present with a value of no. You will have the option to view and edit the details file, this is recommended to make sure the detection routines have behaved as expected.
- Once you've confirmed you no longer want to edit the details file the rip begins.
Details file
Each section in the details file must contain a track key. This is used as metadata but also determines which track is ripped.
If you want to separate these concepts then you can specify a track-rip key which is used for ripping, leaving the track key solely for meta-data. This is useful for some older mixed audio/data CDs where track 1 was the data-track.