Rubyripper

2009-09-21T16:13:51Z

Peter0: /* Installation on Ubuntu */

{{Infobox Software
| name = Rubyripper
| screenshot = [[Image:Rubyripper-screenshot.png|100px]]
| caption = Open-source secure ripper for Linux
| maintainer = Bouke Woudstra
| stable_release = 0.5.5
| preview_release = 0.5.7
| operating_system = Linux, Mac OS/X
| use = Digital Audio Extraction
| license = GPL
| website = [http://code.google.com/p/rubyripper/ Rubyripper website (hosted by Google Code)]
}}

= Introduction =
Rubyripper is a digital audio extraction algorithm that uses [[cdparanoia]] error correcting power and it's own secure ripping algorithm to make sure that a CD rip is done successfully and accurately. It is very similar to and inspired by [[EAC]]. Rubyripper is written in the ruby programming language.

It's currently available for Linux, BSD should work but is untested. Mac OS/X is supported for the CLI frontend. The source (same as executable) is published under the GPL3 license.

== Features ==
* A GTK2 user interface
* Sophisticated error correction mechanism
* A command line interface (CLI) available
* CDDB-info is fetched via the ''cd-discid'' module
* Info can be edited after fetching
* The codecs supported are FLAC, Vorbis, MP3, and WAV
* Multiple codecs can be used in one run
* Direct offset support
* Detailed logfile creation
* A detailed overview of hard-to-correct positions
* Create m3u playlists

== Correction mechanism ==
Rubyripper correction mechanism goes beyond that of [[cdparanoia]]. Every track gets ripped at least twice and is byte compared with the <code>Ruby cmp</code> feature. If any differences are found, each of the 1,000 bytes of the two files is compared. The next trial run looks to see if differing positions or a match can be found. ''(1,000 bytes is about 0.006 seconds)''. The main underlying Philosophy is that an erroneous read of an underlying ripper will produce random results. This seems so far to be correct. A possibility still exists that with random results the same result will be wrong.

In theory if the full 1,000 bytes are erroneous, than a false repair seems to be highly unlikely since there are <math>256^{1000} = 1.73 * 10^{2408}</math> combinations. (As a byte consists of 8 bits, <math>2^8 = 256</math>). The main principle however is, the more trials that are needed, consequently the higher a chance of a false repair. Suppose only 3 bytes in a sample of 1,000 bytes give random information. This would still mean <math>256^3 = 16.7M</math> possibilities for these bytes; really 2 bits in each byte could be a problem. This reduces the possibilities to <math>2^{3*2} = 64</math>. A correct repair at this point may be possible. One has to wonder though: can 3 bytes actually be heard in a wav file that produces 180.000 bytes per second?

In conclusion: Rubyripper won't guarantee a consequent ''MD5-sum'' on tracks that needed correction. However it will repair any files so that it's impossible to successfully blind-test with the original. The log file will report any position that needed more than 3 trials, so you can check the position yourself.

== Installation ==

===General Installation===
Make sure to have <code>cd-discid, ruby-libglade2, libglade2-ruby</code> and [[cdparanoia]] installed as a minimum. You can optionally choose for Lame, Vorbis or FLAC, depending on the codec you wish to use.

Then download Rubyripper:
http://code.google.com/p/rubyripper/downloads/list

See the README file for installation instructions or just type: <code>make install</code>

If Rubyripper doesn't start make sure the dependencies are ok. When launched from the terminal window Rubyripper should tell you which dependency it's missing.

===Installation on Ubuntu===
''Tested with Ubuntu 9.04 („Jaunty Jackalope“), Gnome 2.26.1, and Rubyripper 0.5.7.''

#Make sure Rubyripper has these dependencies as a bare mininum. They can be installed by typing in the terminal window: <code> $ sudo apt-get install cd-discid cdparanoia</code> as a bare mininum or <code> $ sudo apt-get install cd-discid cdparanoia flac lame mp3gain normalize-audio ruby-gnome2 ruby vorbisgain</code> to get the most out of the currently available distros. For internationalisation: instead of the mentioned <code>ruby-gettext</code> install <code>gettext</code> and <code>libgettext-ruby1.8</code>.
#Download the Rubyripper archive (see above) from the official website.
#Extract the files in the Rubyripper archive (bzipped tarball) into a temporary directory.
#Navigate to the directory in which you extracted the Rubyripper archive (Most likely which will be your desktop) or the directory in which you extracted the archive in, e. g. by typing in terminal window: <code> $ cd /home/USERNAME/Desktop/rubyripper-0.5.x/</code>
#Rubyripper needs to know what features need to be installed. Install both the GUI and command-line version for to get the most out of the application by typing in the terminal window: <code> $ ./configure --enable-lang-all --enable-gtk2 --enable-cli</code> Note: This only prepares/configures installation.
#In order to install the application, type in the terminal window: <code> $ sudo make install</code>
#Rubyripper should now be installed with your applications under <code>Applications -> Sound & Video</code>
#If it runs according to your needs, yo may remove the temporary directory.

'''Notes: If you have CD-ROM drive problems it is recommended you read [http://ubuntuforums.org/showpost.php?p=5529611&postcount=16 this] thread

'''You can add or drop dependencies as you see fit. Some the Replaygain packages are not available in certain Ubuntu distros! i.e (64-bit distributions of Ubuntu)'''

'''Substitute 'x' above with the latest version of Rubyripper'''

'''You can run the command-line version of Rubyripper be navigating to the source directory and typing in <code>./rubyripper_cli.rb</code> into the terminal'''

===Installation on Debian===
Rubyripper compiles and depedencies come packaged with Rarewares GNU / Debian Linux [http://www.rarewares.org/debian.php repository]

'''Note: A guide will be written for installation on Debian once it becomes avaliable***

== Screenshots ==
These screenshots are taken with the 0.5.5 release:
* [http://www.opendesktop.org/content/preview.php?preview=1&id=88595&file1=88595-1.png&file2=885952.png&file3=&name=Rubyripper&PHPSESSID=2419fd006ef409c1e96a34b45c34d5f2 Screenshot #1]
* [http://www.opendesktop.org/content/preview.php?preview=2&id=88595&file1=88595-1.png&file2=885952.png&file3=&name=Rubyripper&PHPSESSID=2419fd006ef409c1e96a34b45c34d5f2 Screenshot #2]

== Known bugs & new features ==
Add an issue in the bugtracker to discuss any new feature requests:
* [http://code.google.com/p/rubyripper/issues/list Known bugs and new features]

= Development API =
This section will give some technical information, which should be useful for interested developers. It will outline how the code is structured and what the API of Rubyripper codebase is for adding new user interfaces. Since version 0.2 it is quite simple to add new frontends to the current codebase. Currently there are CLI and GTK2 frontends. A Qt frontend or a Cocoa Mac OS frontend, should not be terribly difficult to implement. The developer won't implement this himself though, due to the fact that he is more interested in fine tuning the Rubyripper logic codebase.

== Becoming a Rubyripper developer ==
To become a developer you should have:
* Some basic knowledge of the Ruby programming language. Read for instance the [http://www.ruby-doc.org/docs/ProgrammingRuby/ free online book], at least until the chapter "Until Trouble Strikes". This is a somewhat dated version, but still perfectly usable. The lead developer doesn't use any new features, therefore it should be fine.
* Some basic knowledge of a GUI-toolkit in case you want to add a new frontend.

SVN Checkout now possible. 
Use: <code>$svn checkout http://rubyripper.googlecode.com/svn/trunk/ rubyripper </code> to get the latest source code.

If you're interested in becoming a developer, please contact him at ''rubyripperdev@nospam@gmail.com''. You can leave out the @nospam part.

== Data files and class structures ==
The 0.5 release has three ruby files and one glade file included:
* <code>rr_lib.rb.</code> This contains the Rubyripper codebase. It consists of five classes:
** <code>Gui_Support.</code> This class handles all feedback communication with the user interface and is used a lot by the other classes (except Cddb). This is were log file is generated and the error analysis takes place.
** <code>Cddb.</code> This class handles the freedb fetching. It uses the Freedb class (dependent on ruby-freedb) to get info about the disc. The server contact is handled in the Cddb class itself. Some problems of the Freedb class made it impossible to rely on it. The biggest problem with using Freedb class is that, it's using an old contact protocol and never gives away any information on the current year. This is the main reason why the Cddb class handles all server contact.
** <code>Secure_rip.</code> As might be expected, all error correction logic is put in here.
** <code>Encode. </code> As might be expected, this handles the encoding of the different formats supported.
** <code>Rubyripper.</code> Handles the usage of the different classes. It also performs some logical checks before starting at all.
* <code>rubyripper_cli.rb.</code> It has one class that contains the code for the command line interface frontend.
* <code>rubyripper_gtk.rb.M</code> It has one class that contains the code for the GTK2 user interface frontend.
* <code>rubyripper.glade.</code> This is a help file for the GTK interface. It's made with Glade, a program for designing user interfaces for GTK2.

== Adding a new frontend ==
New frontends are encouraged and aren't difficult to make, once you know your GUI toolkit. Take for instance, the current GTK2 frontend, which consists of only 350 lines of code ''(+ the glade file, but this code is automatically created)'''. From a starting point it would be best to use the current GTK2 or CLI code and just plainly rewrite it for the other toolkit. The basic ideas should be more or less the same.

The basic idea is that the GUI first presents the info of a Cddb instance. When the user wants to start, a new Rubyripper instance is started with all the settings in a Hash as a parameter. You can copy most of the code from the other user interfaces. The user interface should also have an update function. The update function is used as a communication channel for the Rubyripper instance.

# Using a new thread for launching instances is an effective way of getting a responsive GUI.

== External links ==
* [http://code.google.com/p/rubyripper/ Rubyripper] The official Google code website
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=38418 Hydrogenaudio forum thread] the first public release of Rubyripper
* [http://ubuntuforums.org/showthread.php?t=799621 Ubuntu 8.04] a thread that's consistently updated for installing Rubyripper in Ubuntu.

[[Category:CD Rippers]]

Foobar2000:Converter:Custom presets

2009-09-08T13:00:17Z

Peter0: /* Parameters */

= Converter: Custom Presets =
[[Image:Foobar2000-Preferences-converter-custompresets.png|Converter: Custom preset editor]]

== Encoder ==

File name of the command-line encoder binary.

== Extension ==

Extension of the file format, without the dot.

== Parameters ==

Command-line parameters to send to the encoder. Exact syntax depends on the encoder. Refer to encoder's documentation to find out exact parameters to use.

There are three possible placeholders to be used in constructing the parameter string. Every occurance of a placeholder will be replaced by specific variable content during encoding:

*<code>%d</code> – will be replaced by the desired output file name
*<code>%r</code> – will be replaced by a random number; used together with <code>oggenc</code>
*<code>%s</code> – will be replaced by the filename of a temporary created input wav-file

Using <code>%s</code> changes encoder control from pipe mode to temporary file mode; the progress bar progresses only during temporary file creation, but pauses while encoding.

== Bit Depth Control ==

These settings tell the Converter how to manage bit depths of data streams sent to the encoder. You should fill them according to encoder's documentation. If you're uncertain about highest available BPS mode, leave it at 16.

Bit depth of the data stream sent to the encoder depends on various factors and will vary between different encoding scenarios - source: lossy/lossless, DSP or ReplayGain processing active, etc.

== Display Info ==

These settings control how this preset is shown on the preset list. They are entirely arbitrary and have no impact on the encoding process at all.

= See Also =

[[Foobar2000:Preferences:Converter|Preferences: Converter]]

[[Foobar2000:Converter|Converter component]]

Hydrogenaudio Knowledgebase - User contributions [en]

Rubyripper

Foobar2000:Converter:Custom presets