MusicMaster 0.0.1.20101110

data/lib/MusicMaster/Processes/Normalize.rb

@@ -0,0 +1,51 @@
+#--
+# Copyright (c) 2009-2010 Muriel Salvan (murielsalvan@users.sourceforge.net)
+# Licensed under the terms specified in LICENSE file. No warranty is provided.
+#++
+
+module MusicMaster
+
+  module Processes
+
+    class Normalize
+
+      # Execute the process
+      #
+      # Parameters:
+      # * *iInputFileName* (_String_): File name we want to apply effects to
+      # * *iOutputFileName* (_String_): File name to write
+      # * *iTempDir* (_String_): Temporary directory that can be used
+      # * *iParams* (<em>map<Symbol,Object></em>): Parameters
+      def execute(iInputFileName, iOutputFileName, iTempDir, iParams)
+        # First, analyze
+        lAnalyzeResultFileName = "#{iTempDir}/#{File.basename(iInputFileName)}.analyze"
+        if (File.exists?(lAnalyzeResultFileName))
+          logWarn "File #{lAnalyzeResultFileName} already exists. Will not overwrite it."
+        else
+          MusicMaster::wsk(iInputFileName, "#{iTempDir}/Dummy.wav", 'Analyze')
+          File.unlink("#{iTempDir}/Dummy.wav")
+          FileUtils::mv('analyze.result', lAnalyzeResultFileName)
+        end
+        lAnalyzeResult = nil
+        File.open(lAnalyzeResultFileName, 'rb') do |iFile|
+          lAnalyzeResult = Marshal.load(iFile.read)
+        end
+        lMaxDataValue = lAnalyzeResult[:MaxValues].sort[-1]
+        lMinDataValue = lAnalyzeResult[:MinValues].sort[0]
+        lMaxPossibleValue = (2**(lAnalyzeResult[:SampleSize]-1)) - 1
+        lMinPossibleValue = -(2**(lAnalyzeResult[:SampleSize]-1))
+        lCoeffNormalizeMax = Rational(lMaxPossibleValue, lMaxDataValue)
+        lCoeffNormalizeMin = Rational(lMinPossibleValue, lMinDataValue)
+        lCoeff = lCoeffNormalizeMax
+        if (lCoeffNormalizeMin < lCoeff)
+          lCoeff = lCoeffNormalizeMin
+        end
+        logInfo "Maximal value: #{lMaxDataValue}/#{lMaxPossibleValue}. Minimal value: #{lMinDataValue}/#{lMinPossibleValue}. Volume correction: #{lCoeff}."
+        MusicMaster::wsk(iInputFileName, iOutputFileName, 'Multiply', "--coeff \"#{lCoeff.numerator}/#{lCoeff.denominator}\"")
+      end
+
+    end
+
+  end
+
+end

data/lib/MusicMaster/Processes/VolCorrection.rb

@@ -0,0 +1,30 @@
+#--
+# Copyright (c) 2009-2010 Muriel Salvan (murielsalvan@users.sourceforge.net)
+# Licensed under the terms specified in LICENSE file. No warranty is provided.
+#++
+
+module MusicMaster
+
+  module Processes
+
+    class VolCorrection
+
+      # Parameters of this process:
+      # * *:Factor* (_String_): The volume correction factor, either in ratio ('3/4') or db ('-2db')
+
+      # Execute the process
+      #
+      # Parameters:
+      # * *iInputFileName* (_String_): File name we want to apply effects to
+      # * *iOutputFileName* (_String_): File name to write
+      # * *iTempDir* (_String_): Temporary directory that can be used
+      # * *iParams* (<em>map<Symbol,Object></em>): Parameters
+      def execute(iInputFileName, iOutputFileName, iTempDir, iParams)
+        MusicMaster::wsk(iInputFileName, iOutputFileName, 'Multiply', "--coeff \"#{iParams[:Factor]}\"")
+      end
+
+    end
+
+  end
+
+end

data/lib/MusicMaster/musicmaster.conf.rb

@@ -0,0 +1,96 @@
+#--
+# Copyright (c) 2009-2010 Muriel Salvan (murielsalvan@users.sourceforge.net)
+# Licensed under the terms specified in LICENSE file. No warranty is provided.
+#++
+
+{
+
+  # Command line to run WSK tool
+  :WSKCmdLine => 'ruby -w -I/cygdrive/f/RR/Source/rutilants/svn/rutilants/lib -I/cygdrive/f/RR/Source/waveswissknife/svn/waveswissknife/lib -I/cygdrive/f/RR/Source/waveswissknife/svn/waveswissknife/ext /cygdrive/f/RR/Source/waveswissknife/svn/waveswissknife/bin/WSK.rb',
+
+  # Command line to run Sample Rate Converter tool
+  :SRCCmdLine => '/cygdrive/e/Temp/Projects/Music/Tools/SSRC/ssrc.exe',
+
+  # Record options
+  :Record => {
+
+    # Method returning the name of the next recorded file
+    :RecordedFileGetter => Proc.new do
+      next `ls -rt /cygdrive/e/Temp/Tests\\ M-Audio/TestFramework\\ Project/Samples/Recorded/*.wav | tail -2 | head -1`.chomp
+    end
+
+  },
+
+  # PrepareMix options
+  :PrepareMix => {
+
+    # Directory in which temporary files will be generated
+    :TempDir => 'PrepareMixTemp',
+
+    # Percentage of values added as a margin of the silence thresholds (arbitrary value)
+    :MarginSilenceThresholds => 0.1,
+
+  },
+
+  # Mix options
+  :Mix => {
+
+    # Directory in which temporary files will be generated
+    :TempDir => 'MixTemp'
+
+  },
+
+  # Master options
+  :Master => {
+
+    # Directory in which files will be generated
+    :Dir => 'Master'
+
+  },
+
+  # Album options
+  :Album => {
+
+    # Directory in which temporary files will be generated
+    :TempDir => 'AlbumTemp',
+
+    # Directory in which files will be generated
+    :Dir => 'Album'
+
+  },
+
+  # Album delivery options
+  :AlbumDeliver => {
+
+    # Directory in which files will be generated
+    :Dir => 'AlbumDeliver'
+
+  },
+
+  # Single Track delivery options
+  :Deliver => {
+
+    # Directory in which files will be generated
+    :Dir => 'Deliver'
+
+  },
+
+  # Options for NoiseGate processes
+  :NoiseGate => {
+
+    # Durations used for noise gates
+    # !!! Attack + Release should be < SilenceMin !!!
+    :Attack => '0.1s',
+    :Release => '0.1s',
+    :SilenceMin => '1s'
+
+  },
+
+  # Options for Compressor processes
+  :Compressor => {
+
+    :Interval => '0.1s'
+
+  }
+
+}

data/master.conf.rb.example

@@ -0,0 +1,13 @@
+{
+  # Mastering effects
+  :Mastering => [
+    # Useful to remove starting beats
+    { :Name => 'CutFirstSignal' },
+    # Normalization
+    { :Name => 'Normalize' },
+    # Volume correction, either in ratio (ie. '4/5') or in db (ie. -2db)
+    { :Name => 'VolCorrection', :Factor => '-2db' },
+    # Compression
+    { :Name => 'Compressor' }
+  ]
+}

data/musicmaster.conf.rb.example

@@ -0,0 +1,95 @@
+{
+
+  # Command line to run WSK tool
+  :WSKCmdLine => 'ruby -w -S WSK.rb',
+
+  # Command line to run Sample Rate Converter tool
+  :SRCCmdLine => '/path/to/ssrc/ssrc.exe',
+
+  # Record options
+  :Record => {
+
+    # Directory in which temporary files will be generated
+    :TempDir => 'RecordTemp',
+
+    # Method returning the name of the next recorded file
+    :RecordedFileGetter => Proc.new do
+      next `ls -rt /path/to/recorded/files/*.wav | tail -1 | head -1`.chomp
+    end
+
+  },
+
+  # PrepareMix options
+  :PrepareMix => {
+
+    # Directory in which temporary files will be generated
+    :TempDir => 'PrepareMixTemp',
+
+    # Percentage of values added as a margin of the silence thresholds (arbitrary value)
+    :MarginSilenceThresholds => 0.1,
+
+  },
+
+  # Mix options
+  :Mix => {
+
+    # Directory in which temporary files will be generated
+    :TempDir => 'MixTemp'
+
+  },
+
+  # Master options
+  :Master => {
+
+    # Directory in which files will be generated
+    :Dir => 'Master'
+
+  },
+
+  # Album options
+  :Album => {
+
+    # Directory in which temporary files will be generated
+    :TempDir => 'AlbumTemp',
+
+    # Directory in which files will be generated
+    :Dir => 'Album'
+
+  },
+
+  # Album delivery options
+  :AlbumDeliver => {
+
+    # Directory in which files will be generated
+    :Dir => 'AlbumDeliver'
+
+  },
+
+  # Single Track delivery options
+  :Deliver => {
+
+    # Directory in which files will be generated
+    :Dir => 'Deliver'
+
+  },
+
+  # Options for NoiseGate processes
+  :NoiseGate => {
+
+    # Durations used for noise gates
+    # !!! Attack + Release should be < SilenceMin !!!
+    :Attack => '0.1s',
+    :Release => '0.1s',
+    :SilenceMin => '1s'
+
+  },
+
+  # Options for Compressor processes
+  :Compressor => {
+
+    # Interval used to measure volume
+    :Interval => '0.1s'
+
+  }
+
+}

data/record.conf.rb.example

@@ -0,0 +1,45 @@
+{
+
+  # Tracks that will be recorded during the same take
+  :Performs => [
+    [2, 4, 5],
+    [6, 8, 9],
+    [7],
+    [10]
+  ],
+
+  # Tracks that will be recorded alone
+  # Additional parameters are given to adjust their level with the Perform tracks
+  :Patches => {
+
+    1 => {
+      # Effects to apply once recorded
+      :Effects => [
+        {
+          :Name => 'GVerb'
+        }
+      ],
+      # Either use :VolCorrection or :VolCompareCuts
+      :VolCorrection => '1/4', # Can be also specified in db (ie. '-5db')
+      # Specify that we can record a sample of the Track with the reference and original volume, and cut the following range in this sample recording, to compute the volume correction to apply.
+      :VolCompareCuts => ['0.1s', '32s']
+    },
+
+    3 => {
+      # Effects to apply once recorded
+      :Effects => [
+        {
+          :Name => 'GVerb'
+        }
+      ],
+      # Either use :VolCorrection or :VolCompareCuts
+      :VolCorrection => '3db',
+      :VolCompareCuts => ['1s', '25s']
+    }
+
+  },
+
+  # Specify if there are some files to include in the Mix that don't need to be recorded
+  :WaveFiles => true
+
+}

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification 
+name: MusicMaster
+version: !ruby/object:Gem::Version 
+  version: 0.0.1.20101110
+platform: ruby
+authors: 
+- Muriel Salvan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-10 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: WaveSwissKnife
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.0.1
+    version: 
+description: Command line tool handling steps to deliver music album masters from recordings. Handle Track Mixing, Track Mastering, Track Master Delivery, Album Mastering and Album Master Delivery. Easy-to-use configuration files drive the complete processes.
+email: murielsalvan@users.sourceforge.net
+executables: 
+- Album.rb
+- AnalyzeAlbum.rb
+- DBConvert.rb
+- Deliver.rb
+- DeliverAlbum.rb
+- Fct2Wave.rb
+- Master.rb
+- Mix.rb
+- PrepareMix.rb
+- Record.rb
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/MusicMaster/Common.rb
+- lib/MusicMaster/ConfLoader.rb
+- lib/MusicMaster/musicmaster.conf.rb
+- lib/MusicMaster/Processes/GVerb.rb
+- lib/MusicMaster/Processes/CutFirstSignal.rb
+- lib/MusicMaster/Processes/Normalize.rb
+- lib/MusicMaster/Processes/VolCorrection.rb
+- lib/MusicMaster/Processes/Custom.rb
+- lib/MusicMaster/Processes/AddSilence.rb
+- lib/MusicMaster/Processes/ApplyVolumeFct.rb
+- lib/MusicMaster/Processes/Compressor.rb
+- bin/DBConvert.rb
+- bin/Deliver.rb
+- bin/DeliverAlbum.rb
+- bin/Mix.rb
+- bin/PrepareMix.rb
+- bin/Record.rb
+- bin/AnalyzeAlbum.rb
+- bin/Master.rb
+- bin/Fct2Wave.rb
+- bin/Album.rb
+- ReleaseInfo
+- README
+- LICENSE
+- AUTHORS
+- Credits
+- TODO
+- ChangeLog
+- album.conf.rb.example
+- master.conf.rb.example
+- musicmaster.conf.rb.example
+- record.conf.rb.example
+has_rdoc: true
+homepage: http://musicmaster.sourceforge.net/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: musicmaster
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Command line tool helping recording, mixing and mastering music tracks and albums.
+test_files: []
+