mkvtoolnix 0.7.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e948c21a4ec224548451bef5cb144ef2f3a1b3f4c3955dfbd019158f7c2a2b6f
-  data.tar.gz: 98410a664b3d1b2fa218de1803438e8d0e9cc42038bf97d956c402449e769a38
+  metadata.gz: 2fbb34a6ebad7edff1fd7a8b346772d03cb4586266708b1117023fc5212ee278
+  data.tar.gz: 3c943c0d0839585b61b7bcec644811cd7ba2ebcb02717bab4da6d242d187d635
 SHA512:
-  metadata.gz: a296517bee0136c8c2c3cf6d80db74ddf229aa2f84898bb99b58db108e3fc8a2b1f9f8b8a472616ae41356cae2f11f0f5896616a562c96a6882f2920d9a272ea
-  data.tar.gz: 010a4cfe800ff5e5e09e88c44c4780bfd50d6f7b11bb801e77815c415025788315d1122b571c83cbfa9801b68d4c18041741d85522a4472073edd01653acf9cc
+  metadata.gz: 499dbf2eee5835142fc5e68bed28ca54bcac1d9c59be5eaa692bfabf1284267c4e5a5c4798410d2b04d3035ee43a0270a798674496f4be290121317e2d62aa5d
+  data.tar.gz: 061047311adda84e1ad76e119aca20dd37048c25a77dc68ae3862c00d0634f897d5f56fa5aa88326b17c61b64951a184413c3bd93ad6f7e076ead73069b00c69

data/README.md

@@ -6,7 +6,7 @@ Currently the following modules are implemented (fully):
 * [mkvpropedit](https://mkvtoolnix.download/doc/mkvpropedit.html)
 * [mkvextract](https://mkvtoolnix.download/doc/mkvextract.html)
 
-Partly implemented (aka just started :p, this one is pretty complex, and I am still thinking about how to make it as simple as possible without sacrificing functionality)
+Fully implemented, except `split`:
 * [mkvmerge](https://mkvtoolnix.download/doc/mkvmerge.html)
 
 ## Installation
@@ -218,12 +218,210 @@ extract_attachments('myFile.mkv', [Attachment.new(0, 'attachment1.jpeg'), 'attac
 ```
 will extract the attachments of the given file with ID 0 to `attachment1.jpeg` and ID 2 to `attachment.2.png`.
 
+### mkvmerge
 
-## Development
+merges or modifies several input files by muxing it. This does not alter just metadata of a file, and instead writes a new
+file depending on the provides input files and options.
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+#### available commands
+
+* version
+* info
+* merge
+
+`merge` covers all options except for split from [here](https://mkvtoolnix.download/doc/mkvmerge.html). It requires an input, and an 
+output file. If you just want to alter a file, e.g. removing a track, then only this file needs to be given as an input file.
+All options from the manual page are available as some kind of builder. This way, an input file with the selected options can be build, and 
+will be applied when passed to `merge`.
+The global options are seperated into different option builder. Those ones are:
+* Chapter
+* Tags
+* Segment Info
+* General Output
+* Attachments
+
+To build an option or an input file, mkvmerge provides already methods to do so:
+* build_attachment(file)
+* build_chapter
+* build_segment_info
+* build_tags(file)
+* build_output_control
+* build_input_file(file)
+
+For specific track options for an input file, `InputFile` offers a `build_track_option(track_id)` method, which offers 
+options for this specific track and afterwards added to the input file via `add_track_options`
+
+For specific details what options are available, just check the manual page. The available options are:
+**Attachment:**
+* with_mime_type
+* with_name
+* with_description
+
+**Chapter:**
+* with_chapter_language
+* with_chapter_charset
+* generate_chapter_every_secs
+* generate_chapter_name_template
+* generate_chapter_cue_name_format
+* with_chapters_file
+
+**Output Control:**
+* with_title
+* with_default_language
+* with_track_order
+* with_cluster_length_in_blocks
+* with_meta_seek_element
+* with_timestamp_scale
+* with_durations_enabled
+* without_cues
+* without_date
+* with_disabled_lacing
+* without_track_statistics_tags
+* without_language_ietf
+
+**Segment Info:**
+* for_file
+* for_uids
+
+**Tags:**
+* can only be build by file
+
+**Input File:**
+* with_audio_tracks
+* with_video_tracks
+* with_subtitle_tracks
+* with_track_tags
+* with_attachments
+* with_no_audio
+* with_no_video
+* with_no_subtitles
+* with_no_chapters
+* with_no_track_tags
+* with_no_global_tags
+* with_no_attachments
+* add_track_options
+* with_track_options
+* chapter_sync
+
+**Input Track Option**
+* with_name
+* with_language
+* with_tags
+* handle_as_aac_sbr
+* with_track_sync
+* with_cues
+* default?
+* forced?
+* hearing_impaired?
+* visual_impaired?
+* text_description?
+* original?
+* commentary?
+* reduce_audio_to_core
+* with_timestamps
+* remove_dialog_normalization_gain
+* with_default_duration_in_secs
+* fix_bitstream_timing_information
+* with_compression_mode
+* with_four_cc
+* with_dimensions
+* with_aspect_ratio
+* with_cropping
+* with_color_matrix_coefficients
+* with_color_bits_per_channel
+* with_chroma_sub_sample
+* with_cb_sub_sample
+* with_chroma_siting
+* with_color_range
+* with_color_transfer_characteristics
+* with_color_primaries
+* with_max_content_light
+* with_max_frame_light
+* with_chromaticity_coordinates
+* with_white_color_coordinate
+* with_max_luminance
+* with_min_luminance
+* with_projection_type
+* with_projection_private
+* with_projection_pose_yaw
+* with_projection_pose_pitch
+* with_projection_pose_roll
+* with_field_order
+* with_stereo_mode
+* with_sub_charset
+
+For example, to specify that a meta seek element,
+no cues and no date are written, a the general output can be build accordingly:
+```ruby
+output_control = merge.build_output_control
+output_control.with_meta_seek_element.without_cues.without_date
+```
+just pass this `output_control` to `merge`, and the options will be applied.
+
+#### Example
+
+##### merge video and audio from 2 different files
+```ruby
+video_input = merge.build_input_file('pathToVideo')
+# we don't want the audio from this video file
+video_input.with_no_audio
+audio_input = merge.build_input_file('pathToAudio')
+# we don't want the video from this audio file, if it has any
+audio_input.with_no_video
+
+# lets take the output control as defined earlier
+merge.merge('outputFilePath', video_input, audio_input, output_control: output_control)
+# => nil, or an error and the merged file is written to the given path
+```
+
+##### add 2 Attachments, chapters and tags to an mkv file
+```ruby
+attachment1 = merge.build_attachment('pathToAttachment1')
+# no mime type provided, so it will be determined automatically by mkvmerge
+attachment1.with_name('My first Attachment').with_description('and the description')
+
+attachment2 = merge.build_attachment('pathToAttachment2')
+attachment2.with_name('the 2nd one').with_mime_type('mime/type')
+
+chapters = merge.build_chapter.with_chapters_file('pathToChapters.xml')
+tags = merge.build_tags('pathToTags.xml')
+
+input_file = merge.build_input_file('pathToInputFile')
+
+merge.merge('outputFle', input_file, attachments: [attachment1, attachment2], chapter_options: chapters,
+            tag_options: tags)
+# => nil, and outPutFile now contains the attachments, chapers and tag options
+```
+
+##### switch the track order of an mkv file 
+assuming we have 1 video, 2 audios, and 2 subtitles
+```ruby
+output_control = merge.build_output_control
+# the order can be given as a String, hash, Array, or TrackOrder object
+# mkv always builds video, audio and subtitle order, so we just need to switch the audio ids, video will be the first
+# and subtitles the last tracks
+output_control.with_track_order({ file_index: 0, track_index: 2 }, [0, 1])
+
+input_file = merge.build_input_file('pathToInputFile')
+
+merge.merge('outputFle', input_file, output_control: output_control)
+# => nil, and the new file has the audio tracks switched
+```
+
+##### switch rename the first audio track and language
+the first audio stream in this example has ID 1
+```ruby
+input_file = merge.build_input_file('pathToInputFile')
+track_option = input_file.build_track_option(1)
+track_option.with_name('the new track name')
+# this will also set the language_ietf field
+track_option.with_language('en')
+
+input_file.add_track_options(track_option)
+
+merge.merge('outputFle', input_file)
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
@@ -235,4 +433,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Mkvtoolnix project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/mkvtoolnix/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Mkvtoolnix project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/cfe86/RubyMkvToolNix/blob/master/CODE_OF_CONDUCT.md).

data/lib/mkvtoolnix/modules/mkvmerge.rb

@@ -6,8 +6,12 @@ module MkvToolNix
     class MkvMerge
       include MkvModule
 
+      attr_accessor :default_language, :disable_language_ietf
+
       def initialize(bin_path)
         @bin_path = "#{bin_path}mkvmerge"
+        @default_language = 'und'
+        @disable_language_ietf = false
       end
 
       def version
@@ -18,9 +22,29 @@ module MkvToolNix
         result.stdout.strip
       end
 
+      def merge(output_file, *input_files, attachments: nil, chapter_options: nil, tag_options: nil,
+                output_control: nil, segment_info: nil)
+        raise Errors::MkvToolNixError, 'No Input File(s) given.' if input_files.nil?
+
+        cmd = ['mkvmerge']
+
+        attachments&.each { |attachment| attachment.add_to_cmd(cmd) }
+        chapter_options&.add_to_cmd(cmd)
+        segment_info&.add_to_cmd(cmd)
+        tag_options&.add_to_cmd(cmd)
+        output_control&.add_to_cmd(cmd)
+
+        cmd << '-o' << output_file
+
+        input_files.each { |input| input.add_to_cmd(cmd) }
+
+        a = cmd.join(' ')
+
+        call_cmd(cmd)
+      end
+
       def info(file)
         cmd = [@bin_path, '-J']
-        # cmd = [@bin_path, '--identififcation-format', 'json', '--identify']
         cmd << file
 
         result = call_cmd(cmd)
@@ -28,6 +52,30 @@ module MkvToolNix
         json = JSON.parse(result.stdout)
         Types::Info::MkvContainer.create(json)
       end
+
+      def build_segment_info
+        Types::Merge::SegmentInfo.new
+      end
+
+      def build_attachment(file)
+        Types::Merge::Attachment.new(file)
+      end
+
+      def build_chapter
+        Types::Merge::Chapter.new
+      end
+
+      def build_tags(file)
+        Types::Merge::Tags.new(file)
+      end
+
+      def build_output_control
+        Types::Merge::OutputControl.new
+      end
+
+      def build_input_file(file)
+        Types::Merge::InputFile.new(file)
+      end
     end
   end
 end

data/lib/mkvtoolnix/types/merge/attachment.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module MkvToolNix
+  module Types
+    module Merge
+      class Attachment
+
+        attr_reader :file, :mime_type, :name, :description
+
+        def with_mime_type(type)
+          @mime_type = type
+          self
+        end
+
+        def with_name(name)
+          @name = name
+          self
+        end
+
+        def with_description(description)
+          @description = description
+          self
+        end
+
+        def initialize(file)
+          @file = file
+        end
+
+        def add_to_cmd(cmd)
+          unless @file.nil?
+            cmd << '--attachment-description' << @description unless @description.nil?
+            cmd << '--attachment-mime-type' << @mime_type unless @mime_type.nil?
+            cmd << '--attachment-name' << @name unless @name.nil?
+            cmd << '--attach-file' << @file
+          end
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/mkvtoolnix/types/merge/chapter.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module MkvToolNix
+  module Types
+    module Merge
+      class Chapter
+
+        attr_reader :chapter_language, :chapter_charset, :generate_chapter_interval_secs,
+                    :gen_chapter_cue_name_format, :gen_chapter_name_template, :chapters_file
+
+        def with_chapter_language(language_code)
+          @chapter_language = language_code
+          self
+        end
+
+        def with_chapter_charset(charset)
+          @chapter_charset = charset
+          self
+        end
+
+        def generate_chapter_every_secs(num_secs)
+          @generate_chapter_interval_secs = num_secs
+          self
+        end
+
+        def generate_chapter_name_template(template)
+          @gen_chapter_name_template = template
+          self
+        end
+
+        def generate_chapter_cue_name_format(format)
+          @gen_chapter_cue_name_format = format
+          self
+        end
+
+        def with_chapters_file(file)
+          @chapters_file = file
+          self
+        end
+
+        def add_to_cmd(cmd)
+          cmd << '--chapters' << @chapters_file unless @chapters_file.nil?
+          cmd << '--chapter-language' << @chapter_language unless @chapter_language.nil?
+          cmd << '--chapter-charset' << @chapter_charset unless @chapter_charset.nil?
+          cmd << '--generate-chapters' << "interval:#{@generate_chapter_interval_secs}s" unless @generate_chapter_interval_secs.nil?
+          cmd << '--generate-chapters-name-template' << @gen_chapter_name_template unless @gen_chapter_name_template.nil?
+          cmd << '--cue-chapter-name-format' << @gen_chapter_cue_name_format unless @gen_chapter_cue_name_format.nil?
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/mkvtoolnix/types/merge/input_file.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module MkvToolNix
+  module Types
+    module Merge
+      class InputFile
+
+        attr_reader :audio_tracks, :video_tracks, :subtitle_tracks, :track_tags, :attachments, :no_audio,
+                    :no_video, :no_subtitles, :no_chapters, :no_attachments, :no_track_tags, :no_global_tags,
+                    :track_options
+
+        def with_audio_tracks(*track_ids)
+          @audio_tracks = track_ids
+          self
+        end
+
+        def with_video_tracks(*track_ids)
+          @video_tracks = track_ids
+          self
+        end
+
+        def with_subtitle_tracks(*track_ids)
+          @subtitle_tracks = track_ids
+          self
+        end
+
+        def with_track_tags(*track_ids)
+          @track_tags = track_ids
+          self
+        end
+
+        def with_attachments(*attachment_ids)
+          @attachments = attachment_ids
+          self
+        end
+
+        def with_no_audio
+          @no_audio = true
+          self
+        end
+
+        def with_no_video
+          @no_video = true
+          self
+        end
+
+        def with_no_subtitles
+          @no_subtitles = true
+          self
+        end
+
+        def with_no_chapters
+          @no_chapters = true
+          self
+        end
+
+        def with_no_track_tags
+          @no_track_tags = true
+          self
+        end
+
+        def with_no_global_tags
+          @no_global_tags = true
+          self
+        end
+
+        def with_no_attachments
+          @no_attachments = true
+          self
+        end
+
+        def add_track_options(option)
+          @track_options << option
+          self
+        end
+
+        def with_track_options(options)
+          @track_options = options
+          self
+        end
+
+        def chapter_sync(d = 0, o_div_p = 1.0)
+          @chapter_sync = "-2:#{d},#{o_div_p}"
+          self
+        end
+
+        def build_track_option(track_id)
+          InputTrackOption.new(track_id)
+        end
+
+        def add_to_cmd(cmd)
+          cmd << '--audio-tracks' << @audio_tracks.join(',') unless @audio_tracks.nil?
+          cmd << '--video-tracks' << @video_tracks.join(',') unless @video_tracks.nil?
+          cmd << '--subtitle-tracks' << @subtitle_tracks.join(',') unless @subtitle_tracks.nil?
+          cmd << '--track-tags' << @track_tags.join(',') unless @track_tags.nil?
+          cmd << '--attachments' << @attachments.join(',') unless @attachments.nil?
+          cmd << '--no-audio' unless @no_audio.nil?
+          cmd << '--no-video' unless @no_video.nil?
+          cmd << '--no-subtitles' unless @no_subtitles.nil?
+          cmd << '--no-track-tags' unless @no_track_tags.nil?
+          cmd << '--no-chapters' unless @no_chapters.nil?
+          cmd << '--no-attachments' unless @no_attachments.nil?
+          cmd << '--no-global-tags' unless @no_global_tags.nil?
+          cmd << '--sync' << @chapter_sync unless @chapter_sync.nil?
+
+          @track_options.each { |option| option.add_to_cmd(cmd) }
+
+          cmd  << @file
+          nil
+        end
+
+        def initialize(file)
+          @file = file
+          @track_options = []
+        end
+      end
+    end
+  end
+end

data/lib/mkvtoolnix/types/merge/input_track_options.rb

@@ -0,0 +1,390 @@
+# frozen_string_literal: true
+
+module MkvToolNix
+  module Types
+    module Merge
+      class InputTrackOption
+
+        attr_reader :track_id, :name, :language, :tag_file, :aac_sbr, :track_sync, :cues, :is_default,
+                    :is_forced, :is_hearing_impaired, :is_visual_impaired, :is_text_description, :is_original,
+                    :is_commentary, :reduce_to_core, :no_dialog_norm_gain, :timestamp_file, :default_duration_in_secs,
+                    :fix_bitstream_timing_info, :compression, :four_cc, :dimensions, :aspect_ratio,
+                    :color_matrix_coefficients, :color_bits_per_channel, :chroma_sub_sample, :cb_sub_sample,
+                    :color_transfer_characteristics, :color_primaries, :max_content_light, :max_frame_light,
+                    :chromaticity_coordinates, :white_color_coordinate, :max_luminance, :min_luminance,
+                    :projection_type, :projection_private, :projection_pose_yaw, :projection_pose_pitch,
+                    :projection_pose_roll, :field_order, :stereo_mode, :sub_charset
+
+        def with_name(name)
+          @name = "#{@track_id}:#{name}"
+          self
+        end
+
+        def with_language(language)
+          @language = "#{@track_id}:#{language}"
+          self
+        end
+
+        def with_tags(file)
+          @tag_file = "#{@track_id}:#{file}"
+          self
+        end
+
+        def handle_as_aac_sbr(enabled: true)
+          @aac_sbr = "#{@track_id}:#{enabled ? 1 : 0}"
+          self
+        end
+
+        def with_track_sync(d = 0, o_div_p = 1.0)
+          @track_sync = "#{@track_id}:#{d},#{o_div_p}"
+          self
+        end
+
+        def with_cues(mode = CueMode::I_FRAMES)
+          @cues = "#{@track_id}:#{mode}"
+          self
+        end
+
+        def default?(enabled: true)
+          @is_default = "#{@track_id}:#{enabled}"
+          self
+        end
+
+        def forced?(enabled: true)
+          @is_forced = "#{@track_id}:#{enabled}"
+          self
+        end
+
+        def hearing_impaired?(enabled: true)
+          @is_hearing_impaired = "#{@track_id}:#{enabled}"
+          self
+        end
+
+        def visual_impaired?(enabled: true)
+          @is_visual_impaired = "#{@track_id}:#{enabled}"
+          self
+        end
+
+        def text_description?(enabled: true)
+          @is_text_description = "#{@track_id}:#{enabled}"
+          self
+        end
+
+        def original?(enabled: true)
+          @is_original = "#{@track_id}:#{enabled}"
+          self
+        end
+
+        def commentary?(enabled: true)
+          @is_commentary = "#{@track_id}:#{enabled}"
+          self
+        end
+
+        def reduce_audio_to_core
+          @reduce_to_core = true
+          self
+        end
+
+        def with_timestamps(file)
+          @timestamp_file = "#{@track_id}:#{file}"
+          self
+        end
+
+        def remove_dialog_normalization_gain
+          @no_dialog_norm_gain = true
+          self
+
+        end
+
+        def with_default_duration_in_secs(secs)
+          @default_duration_in_secs = "#{@track_id}:#{secs}s"
+          self
+        end
+
+        def fix_bitstream_timing_information(fix: true)
+          @fix_bitstream_timing_info = "#{@track_id}:#{fix ? 1 : 0}"
+          self
+        end
+
+        def with_compression_mode(mode = Compression::NONE)
+          @compression = "#{@track_id}:#{mode}"
+          self
+        end
+
+        def with_four_cc(four_cc)
+          @four_cc = "#{@track_id}:#{four_cc}"
+          self
+        end
+
+        def with_dimensions(width, height)
+          @dimensions = "#{@track_id}:#{width}x#{height}"
+          self
+        end
+
+        def with_aspect_ratio(ratio)
+          @aspect_ratio = "#{@track_id}:#{ratio}"
+          self
+        end
+
+        def with_cropping(left, top, right, bottom)
+          @cropping = "#{@track_id}:#{left},#{top},#{right},#{bottom}"
+          self
+        end
+
+        def with_color_matrix_coefficients(coefficient)
+          @color_matrix_coefficients = "#{@track_id}:#{coefficient}"
+          self
+        end
+
+        def with_color_bits_per_channel(bits)
+          @color_bits_per_channel = "#{@track_id}:#{bits}"
+          self
+        end
+
+        def with_chroma_sub_sample(horizontal, vertical)
+          @chroma_sub_sample = "#{@track_id}:#{horizontal},#{vertical}"
+          self
+        end
+
+        def with_cb_sub_sample(horizontal, vertical)
+          @cb_sub_sample = "#{@track_id}:#{horizontal},#{vertical}"
+          self
+        end
+
+        def with_chroma_siting(horizontal, vertical)
+          @chroma_siting = "#{@track_id}:#{horizontal},#{vertical}"
+          self
+        end
+
+        def with_color_range(range)
+          @color_range = "#{@track_id}:#{range}"
+          self
+        end
+
+        def with_color_transfer_characteristics(characteristics)
+          @color_transfer_characteristics = "#{@track_id}:#{characteristics}"
+          self
+        end
+
+        def with_color_primaries(primaries)
+          @color_primaries = "#{@track_id}:#{primaries}"
+          self
+        end
+
+        def with_max_content_light(light)
+          @max_content_light = "#{@track_id}:#{light}"
+          self
+        end
+
+        def with_max_frame_light(light)
+          @max_frame_light = "#{@track_id}:#{light}"
+          self
+        end
+
+        def with_chromaticity_coordinates(red_x, red_y, green_x, green_y, blue_x, blue_y)
+          @chromaticity_coordinates = "#{@track_id}:#{red_x},#{red_y},#{green_x},#{green_y},#{blue_x},#{blue_y}"
+          self
+        end
+
+        def with_white_color_coordinate(x, y)
+          @white_color_coordinate = "#{@track_id}:#{x},#{y}"
+          self
+        end
+
+        def with_max_luminance(luminance)
+          @max_luminance = "#{@track_id}:#{luminance}"
+          self
+        end
+
+        def with_min_luminance(luminance)
+          @min_luminance = "#{@track_id}:#{luminance}"
+          self
+        end
+
+        def with_projection_type(type)
+          @projection_type = "#{@track_id}:#{type}"
+          self
+        end
+
+        def with_projection_private(hex_data)
+          @projection_private = "#{@track_id}:#{hex_data}"
+          self
+        end
+
+        def with_projection_pose_yaw(yaw)
+          @projection_pose_yaw = "#{@track_id}:#{yaw}"
+          self
+        end
+
+        def with_projection_pose_pitch(pitch)
+          @projection_pose_pitch = "#{@track_id}:#{pitch}"
+          self
+        end
+
+        def with_projection_pose_roll(roll)
+          @projection_pose_roll = "#{@track_id}:#{roll}"
+          self
+        end
+
+        def with_field_order(order)
+          @field_order = "#{@track_id}:#{order}"
+          self
+        end
+
+        def with_stereo_mode(mode)
+          @stereo_mode = "#{@track_id}:#{mode}"
+          self
+        end
+
+        def with_sub_charset(charset)
+          @sub_charset = "#{@track_id}:#{charset}"
+          self
+        end
+
+        def initialize(track_id)
+          raise Errors::MkvToolNixError, 'track_id can\'t be nil' if track_id.nil?
+
+          @track_id = track_id
+        end
+
+        def add_to_cmd(cmd)
+          cmd << '--sync' << @track_sync unless @track_sync.nil?
+          cmd << '--cues' << @cues unless @cues.nil?
+          cmd << '--default-track' << @is_default unless @is_default.nil?
+          cmd << '--forced-track' << @is_forced unless @is_forced.nil?
+          cmd << '--hearing-impaired-flag' << @is_hearing_impaired unless @is_hearing_impaired.nil?
+          cmd << '--visual-impaired-flag' << @is_visual_impaired unless @is_visual_impaired.nil?
+          cmd << '--text-descriptions-flag' << @is_text_description unless @is_text_description.nil?
+          cmd << '--original-flag' << @is_original unless @is_original.nil?
+          cmd << '--commentary-flag' << @is_commentary unless @is_commentary.nil?
+          cmd << '--track-name' << @name unless @name.nil?
+          cmd << '--language' << @language unless @language.nil?
+          cmd << '--tags' << @tag_file unless @tag_file.nil?
+          cmd << '--aac-is-sbr' << @aac_sbr unless @aac_sbr.nil?
+          cmd << '--reduce-to-core' unless @reduce_to_core.nil?
+          cmd << '--remove-dialog-normalization-gain' unless @no_dialog_norm_gain.nil?
+          cmd << '--timestamps' << @timestamp_file unless @timestamp_file.nil?
+          cmd << '--default-duration' << @default_duration_in_secs unless @default_duration_in_secs.nil?
+          cmd << '--fix-bitstream-timing-information' << @fix_bitstream_timing_info unless @fix_bitstream_timing_info.nil?
+          cmd << '--compression' << @compression unless @compression.nil?
+          cmd << '--fourcc' << @four_cc unless @four_cc.nil?
+          cmd << '--display-dimensions' << @dimensions unless @dimensions.nil?
+          cmd << '--aspect-ratio' << @aspect_ratio unless @aspect_ratio.nil?
+          cmd << '--cropping' << @cropping unless @cropping.nil?
+          cmd << '--colour-matrix-coefficients' << @color_matrix_coefficients unless @color_matrix_coefficients.nil?
+          cmd << '--colour-bits-per-channel' << @color_bits_per_channel unless @color_bits_per_channel.nil?
+          cmd << '--chroma-subsample' << @chroma_sub_sample unless @chroma_sub_sample.nil?
+          cmd << '--cb-subsample' << @cb_sub_sample unless @cb_sub_sample.nil?
+          cmd << '--chroma-siting' << @chroma_siting unless @chroma_siting.nil?
+          cmd << '--colour-range' << @color_range unless @color_range.nil?
+          cmd << '--colour-transfer-characteristics' << @color_transfer_characteristics unless @color_transfer_characteristics.nil?
+          cmd << '--colour-primaries' << @color_primaries unless @color_primaries.nil?
+          cmd << '--max-content-light' << @max_content_light unless @max_content_light.nil?
+          cmd << '--max-frame-light' << @max_frame_light unless @max_frame_light.nil?
+          cmd << '--chromaticity-coordinates' << @chromaticity_coordinates unless @chromaticity_coordinates.nil?
+          cmd << '--white-colour-coordinates' << @white_color_coordinate unless @white_color_coordinate.nil?
+          cmd << '--max-luminance' << @max_luminance unless @max_luminance.nil?
+          cmd << '--min-luminance' << @min_luminance unless @min_luminance.nil?
+          cmd << '--projection-type' << @projection_type unless @projection_type.nil?
+          cmd << '--projection-private' << @projection_private unless @projection_private.nil?
+          cmd << '--projection-pose-yaw' << @projection_pose_yaw unless @projection_pose_yaw.nil?
+          cmd << '--projection-pose-pitch' << @projection_pose_pitch unless @projection_pose_pitch.nil?
+          cmd << '--projection-pose-roll' << @projection_pose_roll unless @projection_pose_roll.nil?
+          cmd << '--field-order' << @field_order unless @field_order.nil?
+          cmd << '--stereo-mode' << @stereo_mode unless @stereo_mode.nil?
+          cmd << '--sub-charset' << @sub_charset unless @sub_charset.nil?
+          nil
+        end
+      end
+
+      module CueMode
+        NONE = 'none'
+        I_FRAMES = 'iframes'
+        ALL = 'all'
+      end
+
+      module Compression
+        NONE = 'none'
+        ZLIB = 'zlib'
+        MPEG4_P2 = 'mpeg4_p2'
+      end
+
+      module ColorMatrixCoefficients
+        GBR = 0
+        BT709 = 1
+        UNSPECIFIED = 2
+        FCC = 4
+        BT470BG = 5
+        SMPTE_170M = 6
+        SMPTE_240M = 7
+        YCOCG = 8
+        BT2020_NON_CONSTANT_LUMINANCE = 9
+        BT2020_CONSTANT_LUMINANCE = 10
+      end
+
+      module ColorRange
+        UNSPECIFIED = 0
+        BROADCAST_RANGE = 1
+        FULL_RANGE = 2
+        DEFINED_BY_MATRIX_TRANSFER_COEFFICIENTS = 3
+      end
+
+      module ColorTransferCharacteristics
+        ITU_R_BT_709 = 1
+        UNSPECIFIED = 2
+        GAMMA_2_2_CURVE = 4
+        GAMMA_8_CURVE = 5
+        SMPTE_170M = 6
+        SMPTE_240M = 7
+        LINEAR = 8
+        LOG = 9
+        LOG_SQRT = 10
+        IEC_61966_2_4 = 11
+        ITU_R_BT_1361_EXTENDED_COLOR_GAMUT = 12
+        IEC_61966_2_1 = 13
+        ITU_R_BT_2020_10_BIT = 14
+        ITU_R_BT_2020_12_BIT = 15
+        SMPTE_ST_2084 = 16
+        SMPTE_ST_428_1 = 17
+        ARIB_STD_B67_HLG = 18
+      end
+
+      module ColorPrimaries
+        ITU_R_BT_709 = 1
+        ITU_R_BT_470M = 4
+        ITU_R_BT_470BG = 5
+        SMPTE_170M = 6
+        SMPTE_240M = 7
+        FILM = 8
+        ITU_R_BT_2020 = 9
+        SMPTE_ST_428_1 = 10
+        JEDEC_P22_PHOSPHORS = 22
+      end
+
+      module ProjectionType
+        RECTANGULAR = 0
+        EQUIRECTANGULAR = 1
+        CUBEMAP = 2
+        MESH = 3
+      end
+
+      module StereoMode
+        MONO = 'mono'
+        SIDE_BY_SIDE_LEFT_FIRST = 'side_by_side_left_first'
+        TOP_BOTTOM_RIGHT_FIRST = 'top_bottom_right_first'
+        TOP_BOTTOM_LEFT_FIRST = 'top_bottom_left_first'
+        CHECKERBOARD_RIGHT_FIRST = 'checkerboard_right_first'
+        CHECKERBOARD_LEFT_FIRST = 'checkerboard_left_first'
+        ROW_INTERLEAVED_RIGHT_FIRST = 'row_interleaved_right_first'
+        ROW_INTERLEAVED_LEFT_FIRST = 'row_interleaved_left_first'
+        COLUMN_INTERLEAVED_RIGHT_FIRST = 'column_interleaved_right_first'
+        COLUMN_INTERLEAVED_LEFT_FIRST = 'column_interleaved_left_first'
+        ANAGLYPH_CYAN_RED = 'anaglyph_cyan_red'
+        SIDE_BY_SIDE_RIGHT_FIRST = 'side_by_side_right_first'
+        ANAGLYPH_GREEN_MAGENTA = 'anaglyph_green_magenta'
+        BOTH_EYES_LACED_LEFT_FIRST = 'both_eyes_laced_left_first'
+        BOTH_EYES_LACED_RIGHT_FIRST = 'both_eyes_laced_right_first'
+      end
+    end
+  end
+end

data/lib/mkvtoolnix/types/merge/output_control.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module MkvToolNix
+  module Types
+    module Merge
+      class OutputControl
+
+        attr_reader :title, :default_language, :track_order, :cluster_length_blocks, :generate_meta_seek,
+                    :timestamp_scale, :enable_duration, :no_cues, :no_date, :disable_lacing, :disable_language_ietf,
+                    :disable_track_statistics_tags
+
+        def with_title(title)
+          @title = title
+          self
+        end
+
+        def with_default_language(language)
+          @default_language = language
+          self
+        end
+
+        def with_track_order(order)
+          if order.is_a?(String)
+            @track_order = order
+            return self
+          end
+
+          @track_order = order.map do |it|
+            # @track_order.map(&:to_s).join(',')
+            case it
+            when TrackOrder
+              next it.to_s
+            when Array
+              next ["#{it[0]}:#{it[1]}"]
+            when Hash
+              next ["#{it[:file_index]}:#{it[:track_id]}"]
+            end
+          end.join(',')
+
+          self
+        end
+
+        def with_cluster_length_in_blocks(blocks)
+          @cluster_length_blocks = blocks
+          self
+        end
+
+        def with_meta_seek_element
+          @generate_meta_seek = true
+          self
+        end
+
+        def with_timestamp_scale(factor)
+          @timestamp_scale = factor
+          self
+        end
+
+        def with_durations_enabled
+          @enable_duration = true
+          self
+        end
+
+        def without_cues
+          @no_cues = true
+          self
+        end
+
+        def without_date
+          @no_date = true
+          self
+        end
+
+        def with_disabled_lacing
+          @disable_lacing = true
+          self
+        end
+
+        def without_track_statistics_tags
+          @disable_track_statistics_tags = true
+          self
+        end
+
+        def without_language_ietf
+          @disable_language_ietf = true
+          self
+        end
+
+        def add_to_cmd(cmd)
+          cmd << '--title' << @title unless @title.nil?
+          cmd << '--default-language' << @default_language unless @default_language.nil?
+          cmd << '--track-order' << @track_order unless @track_order.nil?
+          cmd << '--cluster-length' << @cluster_length_blocks unless @cluster_length_blocks.nil?
+          cmd << '--clusters-in-meta-seek' if @generate_meta_seek
+          cmd << '--timestamp-scale' << @timestamp_scale unless @timestamp_scale.nil?
+          cmd << '--enable-durations' if @enable_duration
+          cmd << '--no-cues' if @no_cues
+          cmd << '--no-date' if @no_date
+          cmd << '--disable-lacing' if @disable_lacing
+          cmd << '--disable-track-statistics-tags' if @disable_track_statistics_tags
+          cmd << '--disable-language-ietf' if @disable_language_ietf
+          nil
+        end
+      end
+
+      class TrackOrder
+
+        attr_reader :file_index, :track_id
+
+        def to_s
+          "#{@file_index}:#{@track_id}"
+        end
+
+        def initialize(file_index, track_id)
+          @file_index = file_index
+          @track_id = track_id
+        end
+      end
+    end
+  end
+end

data/lib/mkvtoolnix/types/merge/segment_info.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module MkvToolNix
+  module Types
+    module Merge
+      class SegmentInfo
+
+        attr_reader :file, :uids
+
+        def for_file(file)
+          @file = file
+          self
+        end
+
+        def for_uids(uids)
+          @uids = uids
+          self
+        end
+
+        def add_to_cmd(cmd)
+          cmd << '--segmentinfo' << @file unless @file.nil?
+          cmd << '--segment-uid' << @uids.join(',') unless @uids.nil?
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/mkvtoolnix/types/merge/tags.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module MkvToolNix
+  module Types
+    module Merge
+      class Tags
+
+        attr_reader :file
+
+        def initialize(file)
+          @file = file
+        end
+
+        def add_to_cmd(cmd)
+          cmd << '--global-tags' << @file unless @file.nil?
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/mkvtoolnix.rb

@@ -27,9 +27,17 @@ require 'mkvtoolnix/types/info/subtitle'
 require 'mkvtoolnix/types/info/video'
 require 'mkvtoolnix/types/info/attachment'
 
-require 'mkvtoolnix/modules/mkvmerge'
+require 'mkvtoolnix/types/merge/attachment'
+require 'mkvtoolnix/types/merge/chapter'
+require 'mkvtoolnix/types/merge/input_track_options'
+require 'mkvtoolnix/types/merge/input_file'
+require 'mkvtoolnix/types/merge/output_control'
+require 'mkvtoolnix/types/merge/segment_info'
+require 'mkvtoolnix/types/merge/tags'
+
 require 'mkvtoolnix/modules/mkvpropedit'
 require 'mkvtoolnix/modules/mkvextract'
+require 'mkvtoolnix/modules/mkvmerge'
 
 module MkvToolNix
 
@@ -64,7 +72,12 @@ module MkvToolNix
 
     def disable_language_ietf(disabled: true)
       @mkvpropedit.disable_language_ietf = disabled
+      @mkvmerge.disable_language_ietf = disabled
       self
     end
+
+    def default_language(language = 'und')
+      @mkvmerge.default_language = language
+    end
   end
 end

data/mkvtoolnix.gemspec

@@ -2,14 +2,14 @@
 
 Gem::Specification.new do |spec|
   spec.name          = 'mkvtoolnix'
-  spec.version       = '0.7.0'
+  spec.version       = '1.0.0'
   spec.authors       = ['Christian Feier']
   spec.email         = ['Christian.Feier@gmail.com']
 
-  spec.summary       = 'A wrapper for MkvToolNix https://mkvtoolnix.download/ to create, alter and inspect MKV files. For more'\
-                        ' information, please check the github page: https://github.com/cfe86/RubyMkvToolNix'
+  spec.summary       = 'A wrapper for MkvToolNix https://mkvtoolnix.download/ to create, alter and inspect MKV files.'\
+                       'For more information, please check the github page: https://github.com/cfe86/RubyMkvToolNix'
   spec.description   = 'A wrapper for MkvToolNix https://mkvtoolnix.download/ to create, alter and inspect MKV files.'\
-                       'Currently mkvpropedit and mkvextract are fully implemented. mkvmerge is in progress.'
+                       'Currently mkvpropedit and mkvextract are fully implemented. mkvmerge is completed except the split options.'
   spec.homepage      = 'https://github.com/cfe86/RubyMkvToolNix'
   spec.license       = 'MIT'
   spec.required_ruby_version = '>= 2.5.0'

metadata

@@ -1,18 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: mkvtoolnix
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Christian Feier
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-11-30 00:00:00.000000000 Z
+date: 2021-12-02 00:00:00.000000000 Z
 dependencies: []
 description: A wrapper for MkvToolNix https://mkvtoolnix.download/ to create, alter
   and inspect MKV files.Currently mkvpropedit and mkvextract are fully implemented.
-  mkvmerge is in progress.
+  mkvmerge is completed except the split options.
 email:
 - Christian.Feier@gmail.com
 executables: []
@@ -43,6 +43,13 @@ files:
 - lib/mkvtoolnix/types/info/mkv_container.rb
 - lib/mkvtoolnix/types/info/subtitle.rb
 - lib/mkvtoolnix/types/info/video.rb
+- lib/mkvtoolnix/types/merge/attachment.rb
+- lib/mkvtoolnix/types/merge/chapter.rb
+- lib/mkvtoolnix/types/merge/input_file.rb
+- lib/mkvtoolnix/types/merge/input_track_options.rb
+- lib/mkvtoolnix/types/merge/output_control.rb
+- lib/mkvtoolnix/types/merge/segment_info.rb
+- lib/mkvtoolnix/types/merge/tags.rb
 - lib/mkvtoolnix/types/propedit/audio_property.rb
 - lib/mkvtoolnix/types/propedit/common_property.rb
 - lib/mkvtoolnix/types/propedit/info_property.rb
@@ -76,5 +83,5 @@ rubygems_version: 3.2.15
 signing_key:
 specification_version: 4
 summary: 'A wrapper for MkvToolNix https://mkvtoolnix.download/ to create, alter and
-  inspect MKV files. For more information, please check the github page: https://github.com/cfe86/RubyMkvToolNix'
+  inspect MKV files.For more information, please check the github page: https://github.com/cfe86/RubyMkvToolNix'
 test_files: []