cue_breaker 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bd9d8859514a4edf0131c5f6e9c01939df0ee6cfe0389ff909e77c7a3e0828a6
+  data.tar.gz: 18c39dd44c5e26ced3b3a232ed521a499453a4ded92d1fb92cdd6b6d303d2875
+SHA512:
+  metadata.gz: b7e39bcf1aa41da85fb871a4e4f9975a9bdc9fd45f68c4fc0b5ea221b1fcc7211befb2be4bfcac66ef997c1123e0052bbe9a3f726a557b1708d69c81d1dfa2cf
+  data.tar.gz: ba7b880ae0588c66c32f445c82959e0b07741f22f300150f77e262f1495d56c050cf6872909a1d40a9043481c48d30a1474f0361afc4f8bda71bb71ac128846d

data/README.md

@@ -0,0 +1,43 @@
+# CueBreaker
+
+CueBreaker is a Ruby script that parses CUE files and converts
+associated WAV files into respective MP3 track files. It uses the 
+`rubycue` gem for parsing and FFmpeg for audio conversion and 
+metadata handling.
+
+## Features
+
+- Parses CUE files to extract track information.
+- Converts WAV segments to MP3 files.
+- Adds metadata to the MP3 files (e.g. title, artist).
+
+## Requirements
+
+- Ruby
+- FFmpeg
+
+## Installation
+
+1. **Install Ruby:** Download and install Ruby from [ruby-lang.org](https://www.ruby-lang.org/).
+2. **Install FFmpeg:** Download and install FFmpeg from [ffmpeg.org](https://ffmpeg.org/download.html) and ensure it is added to your system's PATH.
+
+```sh
+$ gem install cue_breaker
+```
+
+## Usage
+
+Here's an example of how to use CueBreaker:
+
+```sh
+$ cue_break --cue rockband.cue --wav rockband.wav --output $HOME/music/rockband
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- [rubycue](https://github.com/blakesmith/rubycue) for CUE file parsing.
+- [FFmpeg](https://ffmpeg.org/) for audio processing.

data/bin/cue_break

@@ -0,0 +1,7 @@
+#!/usr/local/bin/ruby
+
+require 'bundler/setup'
+
+require 'cue_breaker'
+
+CueBreaker::CLI.start

data/lib/cue_breaker/album.rb

@@ -0,0 +1,25 @@
+require 'delegate'
+
+module CueBreaker
+  class Album
+    attr_reader :title, :performer, :genre, :total_tracks, :date
+
+    def initialize(title:, performer:, genre:, total_tracks:, date:)
+      @title, @performer, @genre, @total_tracks, @date = title, performer, genre, total_tracks, date
+    end
+
+    def present
+      @_present ||= Presenter.new(self)
+    end
+
+    class Presenter < SimpleDelegator
+      def track_number(track)
+        "#{track.number}/#{total_tracks}"
+      end
+
+      def genre
+        super&.gsub(/[<>:"\/\\|?*]/, '').to_s
+      end
+    end
+  end
+end

data/lib/cue_breaker/cli.rb

@@ -0,0 +1,47 @@
+require 'optparse'
+require 'delegate'
+
+require 'cue_breaker/version'
+require 'cue_breaker/core'
+require 'cue_breaker/dependencies'
+
+module CueBreaker
+  module CLI
+    extend self
+
+    def start
+      Dependencies.check!
+
+      duration = Core.get_audio_duration(options.wav)
+
+      Core.parse_cue(options.cue, duration: duration) do |album, song|
+        Core.convert_to_mp3(options.wav, album.present, song.present, options.output)
+      end
+    end
+
+    private
+
+    def options
+      @_options ||= Options.new
+    end
+
+    class Options < SimpleDelegator
+      def initialize
+        options = {}
+
+        OptionParser.new do |parser|
+          parser.banner = <<~BANNER
+            cue_break version #{VERSION}
+            Usage: cue_break [options]
+          BANNER
+
+          parser.on('-c', '--cue CUEFILE') { |o| options[:cue] = o }
+          parser.on('-w', '--wav WAVFILE') { |o| options[:wav] = o }
+          parser.on('-o', '--output OUTPUT') { |o| options[:output] = o }
+        end.parse!
+
+        super Struct.new(*options.keys).new(*options.values)
+      end
+    end
+  end
+end

data/lib/cue_breaker/core.rb

@@ -0,0 +1,68 @@
+require 'rubycue'
+require 'fileutils'
+require 'open3'
+
+require 'cue_breaker/album'
+require 'cue_breaker/track'
+require 'cue_breaker/ffmpeg_args'
+
+module CueBreaker
+  module Core
+    extend self
+
+    def parse_cue(cue_file, duration:, &block)
+      cue_sheet = RubyCue::Cuesheet.new(File.read(cue_file), duration.to_i)
+      cue_sheet.parse!
+
+      album = as_album(cue_sheet)
+
+      cue_sheet.songs.each do |song|
+        block.call(album, as_track(song))
+      end
+    end
+
+    def convert_to_mp3(wav_file, album, track, output_dir)
+      output_path = File.join(output_dir, sanitize_file_name(album.title))
+      FileUtils.mkdir_p(output_path) unless Dir.exist?(output_path)
+
+      ffmpeger = FFmpegArgs.new(wav_file, album, track)
+      system('ffmpeg', *ffmpeger.options(output_path))
+      puts "Exported: #{ffmpeger.output_file_path(output_path)}"
+    end
+
+    def get_audio_duration(file_path)
+      stdout, stderr, status = Open3.capture3(<<~CMD)
+        ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 \"#{file_path}\"
+      CMD
+
+      raise "Error getting duration: #{stderr}" unless status.success?
+
+      stdout.strip.to_f
+    end
+
+    private
+
+    def as_album(cue_sheet)
+      Album.new(
+        title: cue_sheet.title,
+        performer: cue_sheet.songs.first.fetch(:performer),
+        genre: cue_sheet.genre,
+        total_tracks: cue_sheet.songs.count,
+        date: cue_sheet.date
+      )
+    end
+
+    def as_track(song)
+      Track.new(
+        title: song.fetch(:title),
+        number: song.fetch(:track),
+        start: song.fetch(:index).to_s,
+        finish: (song.fetch(:index) + song.fetch(:duration)).to_s
+      )
+    end
+
+    def sanitize_file_name(name)
+      name.gsub(%r{[<>:"/\\|?*]}, '')
+    end
+  end
+end

data/lib/cue_breaker/dependencies.rb

@@ -0,0 +1,17 @@
+module CueBreaker
+  module Dependencies
+    extend self
+
+    def check!
+      check_ffmpeg_installed!
+    end
+
+    private
+
+    def check_ffmpeg_installed!
+      unless system('which ffmpeg > /dev/null 2>&1')
+        raise 'ffmpeg is not installed. Please install it to use this gem.'
+      end
+    end
+  end
+end

data/lib/cue_breaker/ffmpeg_args.rb

@@ -0,0 +1,50 @@
+module CueBreaker
+  class FFmpegArgs
+    def initialize(file, album, track)
+      @file, @album, @track = file, album, track
+    end
+
+    def options(output_path)
+      [
+        file,
+        start,
+        finish,
+        metadata,
+        ["-q:a", "0"],
+        output_file_path(output_path)
+      ].reject(&:empty?).flatten
+    end
+
+    def file
+      ["-i", @file]
+    end
+
+    def start
+      ["-ss", @track.start.to_s]
+    end
+
+    def finish
+      return [] unless @track.finish
+
+      ["-to", @track.finish.to_s]
+    end
+
+    def metadata
+      [
+        "-metadata", "title=#{@track.title}",
+        "-metadata", "artist=#{@album.performer}",
+        "-metadata", "genre=#{@album.genre}",
+        "-metadata", "album=#{@album.title}",
+        "-metadata", "date=#{@album.date}",
+        "-metadata", "track=#{@album.track_number(@track)}",
+      ]
+    end
+
+    def output_file_path(output_path)
+      File.join(
+        output_path,
+        "#{format('%02d', @track.number)} - #{@track.title}.mp3"
+      )
+    end
+  end
+end

data/lib/cue_breaker/track.rb

@@ -0,0 +1,32 @@
+require 'delegate'
+
+module CueBreaker
+  class Track
+    attr_reader :title, :number, :start, :finish
+
+    def initialize(title:, number:, start:, finish:)
+      @title, @number, @start, @finish = title, number, start, finish
+    end
+
+    def present
+      @_present ||= Presenter.new(self)
+    end
+
+    class Presenter < SimpleDelegator
+      def start
+        parse_time(super)
+      end
+
+      def finish
+        super ? parse_time(super) : nil
+      end
+
+      private
+
+      def parse_time(time_str)
+        parts = time_str.split(':').map(&:to_f)
+        (parts[0] * 60) + parts[1] + (parts[2] / 75.0)
+      end
+    end
+  end
+end

data/lib/cue_breaker/version.rb

@@ -0,0 +1,3 @@
+module CueBreaker
+  VERSION = '0.1.0'
+end

data/lib/cue_breaker.rb

@@ -0,0 +1,6 @@
+require 'rubycue'
+require 'fileutils'
+require 'open3'
+
+require 'cue_breaker/cli'
+require 'cue_breaker/core'

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: cue_breaker
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Lukas Alexander
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-05-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry-nav
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A simple hello world gem
+email: the.lukelex@gmail.com
+executables:
+- cue_break
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/cue_break
+- lib/cue_breaker.rb
+- lib/cue_breaker/album.rb
+- lib/cue_breaker/cli.rb
+- lib/cue_breaker/core.rb
+- lib/cue_breaker/dependencies.rb
+- lib/cue_breaker/ffmpeg_args.rb
+- lib/cue_breaker/track.rb
+- lib/cue_breaker/version.rb
+homepage: https://rubygems.org/gems/cue_breaker
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.9
+signing_key:
+specification_version: 4
+summary: Breaks CUE files into mp3s
+test_files: []