id3dit 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 50dd9d679398dbd0314f2c761339fb3ec38b2ffa
+  data.tar.gz: cb33c5b19ce5172a5e6819a7db8272e5490f4716
+SHA512:
+  metadata.gz: 7eab5ec485e60608920f1bcb7cfcad7dddf237971d05f7096cf943a06562b3757fa11c5ddda8b8e211da6305e8c65d3fccfbef09a4794527f223cb79b9bca4d6
+  data.tar.gz: d163cce4367256a93a9b114fc2a0e688694c88d9e645023b012236f5c5860252474a0f78f78a21a5333c2780e95153662b849b91a31f864d2c0872ec529c79d0

data/.gitignore

@@ -0,0 +1,2 @@
+CHANGELOG-*.txt
+.setup

data/Gemfile

@@ -0,0 +1,3 @@
+
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    id3dit (1.1.0)
+      highline (~> 1.7)
+      id3lib-ruby (~> 0.6)
+      rainbow (~> 2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    highline (1.7.8)
+    id3lib-ruby (0.6.0)
+    rainbow (2.0.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.10)
+  id3dit!
+
+BUNDLED WITH
+   1.10.2

data/Makefile

@@ -0,0 +1,50 @@
+
+MV = mv -nv
+RM = rm -rf
+MKDIR = mkdir -p
+BUNDLER = bundle
+GEM_NAME = id3dit
+GEMSPEC_FILE = $(GEM_NAME).gemspec
+
+
+.PHONY: all
+all: setup
+
+.PHONY: setup
+setup: .setup
+
+.setup:
+	$(BUNDLER) install
+	touch $@
+
+.PHONY: install
+install:
+	gem_file=$$(gem build $(GEMSPEC_FILE) | grep 'File:' | tail -1 | awk '{ print $$2 }'); \
+	sudo gem install $$gem_file; \
+	$(RM) $$gem_file
+
+.PHONY: uninstall
+uninstall:
+	sudo gem uninstall $(GEM_NAME)
+
+.PHONY: update
+update:
+	$(BUNDLER) update
+
+.PHONY: clean
+clean:
+	$(RM) .setup
+	$(RM) Gemfile.lock
+
+.PHONY: release
+release: | releases
+	set -e; \
+	gem_file=$$(gem build $(GEMSPEC_FILE) | grep 'File:' | tail -1 | awk '{ print $$2 }'); \
+	dst="releases/$$gem_file"; \
+	[ ! -f $$dst ]; \
+	$(MV) $$gem_file releases; \
+	gem push $$dst; \
+	echo 'done'
+
+releases:
+	$(MKDIR) $@

data/README.md

@@ -0,0 +1,60 @@
+# ID3dit
+
+[ID3](https://en.wikipedia.org/wiki/ID3) tags editor for the command line written in Ruby.
+
+![](examples/id3dit_20151116_143921.png)
+
+![](examples/id3dit_20151116_144224.png)
+
+## Install
+
+The preferred method of installation is via RubyGems.org:  
+<https://rubygems.org/gems/id3dit>
+
+	gem install id3dit
+
+or via `Gemfile`:
+
+	gem 'id3dit', '~>1.1'
+
+## Usage
+
+Video: <https://asciinema.org/a/a3tt619cc1r529av8skskgz5w>
+
+### Print Help
+
+	id3dit -h
+
+### Interactive Mode
+
+	id3dit FILES...
+
+### Set Tag
+
+	id3dit --artist STRING FILES...
+
+### Remove All Tags
+
+	id3dit --remove-all FILES...
+
+### Remove a Tag
+
+	id3dit --remove-comment FILES...
+
+### Examples
+
+- `id3dit my_music.mp3`
+- `id3dit track01.mp3 track02.mp3`
+- `id3dit --artist EAV track01.mp3`
+- `id3dit --artist AC/DC *.mp3`
+- `id3dit --year 1987 --bpm 180 track01.mp3`
+- `id3dit --remove-all track01.mp3`
+- `id3dit --remove-comment track01.mp3 track02.mp3`
+- `id3dit --remove-disc --remove-track track01.mp3 track02.mp3`
+
+## License
+Copyright (C) 2015 Christian Mayer <http://fox21.at>
+
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

data/bin/id3dit

@@ -0,0 +1,279 @@
+#!/usr/bin/env ruby
+# coding: UTF-8
+
+require 'bundler/setup'
+require 'id3lib'
+require 'highline/import'
+require 'rainbow'
+require 'id3dit'
+
+
+options = {
+	:interactive => true,
+}
+opts = OptionParser.new do |opts|
+	opts.banner = 'Usage: id3dit [OPTIONS...] FILES...'
+	opts.separator('')
+	opts.separator('Options:')
+	
+	ID3dit::USED_TAGS.each do |tag_name, tag|
+		opts.on("--#{tag_name} STRING", "Set new value for '#{tag_name}' tag. (#{tag[:id]})") do |v|
+			options[:interactive] = false
+			options["set_tag_#{tag_name}"] = v
+		end
+	end
+	
+	opts.on('-r', '--remove-all', 'Remove all tags.') do |v|
+		options[:interactive] = false
+		options['remove_all_tags'] = true
+	end
+	ID3dit::USED_TAGS.each do |tag_name, tag|
+		opts.on("--remove-#{tag_name}", "Remove '#{tag_name}' tag. (#{tag[:id]})") do |v|
+			options[:interactive] = false
+			options["remove_tag_#{tag_name}"] = v
+		end
+	end
+	
+	opts.on_tail('--version', 'Show version.') do
+		puts "ID3dit #{ID3dit::VERSION}"
+		puts ID3dit::HOMEPAGE
+		exit
+	end
+	
+	opts.on_tail('-h', '--help', 'Show this message.') do
+		puts opts
+		exit 3
+	end
+end
+
+opts.parse(ARGV)
+
+files = []
+ARGV.each do |arg|
+	if File.exist?(arg)
+		files << arg
+	end
+end
+
+if files.count == 0
+	opts.parse(['-h'])
+end
+
+if options[:interactive]
+	puts "ID3dit #{ID3dit::VERSION}"
+	
+	tags = ID3dit::Tags.new(files.map{ |file| ID3Lib::Tag.new(file) })
+	
+	actions = ['i']
+	while true
+		case actions.pop
+		when 'i'
+			puts
+			if files.count >= 2
+				puts "#{files.count} songs selected."
+			else
+				puts "File '#{files.first}'."
+			end
+			
+			puts
+			if tags.are_set?
+				tags.are_set.each do |tag_name, tag_infos|
+					printf "%15s    ", tag_name
+					if tag_infos[:is_mixed]
+						print '< Mixed >'
+					else
+						print "'" + Rainbow(tag_infos[:old_value]).bright + "'"
+					end
+					if tag_infos[:has_changed]
+						if tag_infos[:is_removed]
+							print "  => remove"
+						else
+							print "  => '#{tag_infos[:new_value]}'"
+						end
+					end
+					puts
+				end
+			else
+				puts 'File(s) contain no ID3 tags.'
+			end
+		when 'e'
+			puts
+			puts 'Type new value for tags.'
+			puts '- Leave blank for unchanged.'
+			puts '- Leave input prematurely with "#".'
+			puts
+			
+			has_set_tags = false
+			pre_break = false
+			tags.are_for_edit.each do |tag_name, tag_infos|
+				has_set_tags = true
+				
+				printf "%15s    ", tag_name
+				if tag_infos[:is_mixed]
+					print '< Mixed >'
+				else
+					print "'" + Rainbow(tag_infos[:new_value].nil? ? tag_infos[:old_value] : tag_infos[:new_value]).bright + "'"
+				end
+				
+				print '  >'
+				new_val = ask('').strip
+				if new_val != ''
+					if new_val == '#'
+						pre_break = true
+						puts 'Break.'
+						break
+					end
+					printf "%15s    '%s'\n", "New #{tag_name}", new_val
+					tags[tag_name] = new_val
+				end
+			end
+			
+			show_unset_tags = false
+			if has_set_tags
+				if !pre_break
+					puts
+					res = ask('Edit more tags? [yN] ').strip.downcase
+					if res == 'y'
+						show_unset_tags = true
+					end
+				end
+			else
+				show_unset_tags = true
+			end
+			
+			if show_unset_tags
+				puts
+				tags.are_for_further_edit.each do |tag_name, tag_infos|
+					printf "%15s    ''  >", tag_name
+					new_val = ask('').strip
+					if new_val != ''
+						if new_val == '#'
+							pre_break = true
+							puts 'Break.'
+							break
+						end
+						printf "%15s    '%s'\n", "New #{tag_name}", new_val
+						tags[tag_name] = new_val
+					end
+				end
+			end
+		when 'r'
+			puts
+			puts 'Remove tags.'
+			puts '- Default is no on non-empty fields.'
+			puts '- Leave input prematurely with "#".'
+			puts
+			
+			tags.are_for_remove.each do |tag_name, tag_infos|
+				printf "%15s    ", tag_name
+				if tag_infos[:is_mixed]
+					print '< Mixed >'
+				else
+					print "'" + Rainbow(tag_infos[:new_value].nil? ? tag_infos[:old_value] : tag_infos[:new_value]).bright + "'"
+				end
+				
+				print '  ['
+				default_v = 'n'
+				if !tag_infos[:old_value].nil? && tag_infos[:old_value] != '' ||
+					!tag_infos[:new_value].nil? && tag_infos[:new_value] != '' ||
+					tag_infos[:is_mixed]
+					print 'yN'
+				else
+					print 'Yn'
+					default_v = 'y'
+				end
+				print '#]? '
+				
+				res = ask('').strip.downcase
+				if res == ''
+					res = default_v
+				end
+				if res == 'y' || res == 'r'
+					printf "%15s\n", "Remove #{tag_name}"
+					tags.delete(tag_name)
+				elsif res == '#'
+					puts 'Break.'
+					break
+				end
+			end
+		when 'x'
+			actions << 'q'
+			actions << 'w'
+		when 'w'
+			puts
+			
+			changes = tags.have_changed
+			if changes.count > 0
+				puts "Write #{changes.count} change(s)."
+				files.each do |file|
+					puts "Write file '#{file}'."
+					
+					tag = ID3Lib::Tag.new(file)
+					changes.each do |tag_name, tag_infos|
+						if tag_infos[:is_removed]
+							used_tag = ID3dit::USED_TAGS[tag_name]
+							tag.delete_if{ |frame| frame[:id] == used_tag[:id] }
+						else
+							tag.send("#{tag_name}=", tag_infos[:new_value])
+						end
+					end
+					tag.update!
+				end
+				
+				tags.update
+			else
+				puts 'Nothing has changed, no file(s) written.'
+			end
+		when 'q'
+			puts 'Quitting.'
+			break
+		when '?'
+			puts
+			puts 'i - show all tags.'
+			puts 'e - edit all tags.'
+			puts 'r - remove tags.'
+			puts 'x - same as wq.'
+			puts 'w - write - after edit, apply changes to the files.'
+			puts 'q - quit without saving.'
+			puts '? - print help.'
+		else
+			puts "WARNING: invalid input. Type '?' for help."
+		end
+		
+		next if actions.count > 0
+		
+		puts
+		actions << ask('[ierxwq?] '){ |q|
+			q.character = true
+		}.downcase
+	end
+else
+	files.each do |file|
+		puts "Check file '#{file}'."
+		
+		changed = false
+		tag = ID3Lib::Tag.new(file)
+		options.select{ |tag_name, tag_value| /^set_tag_/.match(tag_name) }.each do |tag_name, tag_value|
+			name = tag_name.sub(/^set_tag_/, '')
+			tag.send("#{name}=", tag_value)
+			changed = true
+		end
+		if options.has_key?('remove_all_tags')
+			tag.delete_if{ true }
+			changed = true
+		else
+			options.select{ |tag_name, tag_value| /^remove_tag_/.match(tag_name) }.each do |tag_name, tag_value|
+				name = tag_name.sub(/^remove_tag_/, '')
+				used_tag = ID3dit::USED_TAGS[name.to_sym]
+				count = tag.count
+				tag.delete_if{ |frame| frame[:id] == used_tag[:id] }
+				
+				changed = true if tag.count < count
+			end
+		end
+		if changed
+			puts "Write file '#{file}'."
+			tag.update!
+		end
+	end
+end

data/id3dit.gemspec

@@ -0,0 +1,31 @@
+# coding: UTF-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'id3dit/version'
+
+Gem::Specification.new do |spec|
+	spec.name          = 'id3dit'
+	spec.version       = ID3dit::VERSION
+	spec.date          = ID3dit::DATE
+	spec.author        = 'Christian Mayer'
+	spec.email         = 'christian@fox21.at'
+	
+	spec.summary       = %q{ID3 Tags Editor}
+	spec.description   = %q{ID3 tags editor for the command line written in Ruby.}
+	spec.homepage      = ID3dit::HOMEPAGE
+	spec.license       = 'GPL-3.0'
+	
+	spec.files         = `git ls-files -z`.split("\x0").reject{ |f| f.match(%r{^(test|spec|features)/}) }
+	spec.bindir        = 'bin'
+	spec.executables   = ['id3dit']
+	spec.require_paths = ['lib']
+	spec.required_ruby_version = '>=2.2.0'
+	
+	spec.add_development_dependency 'bundler', '~>1.10'
+	
+	spec.add_dependency 'id3lib-ruby', '~>0.6'
+	spec.add_dependency 'highline', '~>1.7'
+	spec.add_dependency 'rainbow', '~>2.0'
+end

data/id3dit.sublime-project

@@ -0,0 +1,10 @@
+{
+	"folders":[
+		{
+			"path": ".",
+			"name": "ID3dit",
+			"folder_exclude_patterns": [ ],
+			"file_exclude_patterns": [ ]
+		}
+	]
+}

data/lib/id3dit/tags.rb

@@ -0,0 +1,125 @@
+
+require 'id3dit/version'
+
+module ID3dit
+	
+	class Tags < Hash
+		attr_accessor :raw
+		
+		def initialize(tags)
+			@raw = USED_TAGS.map{ |tag_name, tag|
+				[tag_name, {
+					:old_value => nil,
+					:new_value => nil,
+					:has_init => false,
+					:is_mixed => false,
+					:is_removed => false,
+					:has_changed => false,
+				}] }.to_h
+				
+			tags.each do |tag|
+				@raw.each do |tag_name, tag_infos|
+					field = tag.send(tag_name)
+					
+					if tag_infos[:has_init]
+						if !tag_infos[:is_mixed]
+							if field != tag_infos[:old_value]
+								tag_infos[:is_mixed] = true
+								tag_infos[:old_value] = nil
+								tag_infos[:new_value] = nil
+							end
+						end
+					else
+						tag_infos[:has_init] = true
+						tag_infos[:old_value] = field
+					end
+				end
+			end
+		end
+		
+		def [](key)
+			@raw[key]
+		end
+		
+		def []=(key, val)
+			tag = @raw[key]
+			tag[:has_changed] = true
+			tag[:has_init] = true
+			tag[:is_removed] = false
+			tag[:new_value] = val
+		end
+		
+		def delete(key)
+			tag = @raw[key]
+			tag[:has_changed] = true
+			tag[:is_removed] = true
+		end
+		
+		def are_inited
+			@raw.select{ |tag_name, tag_infos| tag_infos[:has_init] }
+		end
+		
+		def have_changed
+			are_inited.select{ |tag_name, tag_infos| tag_infos[:has_changed] }
+		end
+		
+		def are_unchanged
+			are_inited.select{ |tag_name, tag_infos| !tag_infos[:has_changed] }
+		end
+		
+		def have_no_old_value
+			are_unchanged.select{ |tag_name, tag_infos| tag_infos[:old_value].nil? }
+		end
+		
+		def are_set
+			are_inited.select{ |tag_name, tag_infos|
+				!tag_infos[:old_value].nil? ||
+				!tag_infos[:new_value].nil? ||
+				tag_infos[:is_mixed] ||
+				tag_infos[:has_changed]
+			}
+		end
+		
+		def are_set?
+			are_set.count > 0
+		end
+		
+		def are_not_removed
+			are_inited.select{ |tag_name, tag_infos| !tag_infos[:is_removed] }
+		end
+		
+		def are_for_edit
+			are_not_removed.select{ |tag_name, tag_infos|
+				!tag_infos[:old_value].nil? ||
+				tag_infos[:has_changed] ||
+				tag_infos[:is_mixed]
+			}
+		end
+		
+		def are_for_further_edit
+			have_no_old_value.select{ |tag_name, tag_infos| !tag_infos[:is_mixed] }
+		end
+		
+		def are_for_remove
+			are_not_removed.select{ |tag_name, tag_infos|
+				!tag_infos[:old_value].nil? ||
+				!tag_infos[:new_value].nil? ||
+				tag_infos[:is_mixed]
+			}
+		end
+		
+		def update
+			have_changed.each do |tag_name, tag_infos|
+				# Set tag infos to default.
+				tag_infos[:old_value] = tag_infos[:is_removed] ? nil : tag_infos[:new_value]
+				tag_infos[:new_value] = nil
+				# tag_infos[:has_init] = false
+				tag_infos[:is_mixed] = false
+				tag_infos[:is_removed] = false
+				tag_infos[:has_changed] = false
+			end
+		end
+		
+	end
+	
+end

data/lib/id3dit/version.rb

@@ -0,0 +1,20 @@
+
+module ID3dit
+	VERSION = '1.1.0'
+	DATE = '2015-12-07'
+	HOMEPAGE = 'https://github.com/TheFox/id3dit'
+	USED_TAGS = {
+		:title => {:id => :TIT2},
+		:artist => {:id => :TPE1},
+		:composer => {:id => :TCOM},
+		:year => {:id => :TYER},
+		:genre => {:id => :TCON},
+		:bpm => {:id => :TBPM},
+		:grouping => {:id => :TIT1},
+		:comment => {:id => :COMM},
+		:album => {:id => :TALB},
+		:band => {:id => :TPE2},
+		:disc => {:id => :TPOS},
+		:track => {:id => :TRCK},
+	}
+end

data/lib/id3dit.rb

@@ -0,0 +1,3 @@
+
+require 'id3dit/version'
+require 'id3dit/tags'

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: id3dit
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+authors:
+- Christian Mayer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: id3lib-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: ID3 tags editor for the command line written in Ruby.
+email: christian@fox21.at
+executables:
+- id3dit
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- Makefile
+- README.md
+- bin/id3dit
+- examples/id3dit_20151116_143921.png
+- examples/id3dit_20151116_144224.png
+- id3dit.gemspec
+- id3dit.sublime-project
+- lib/id3dit.rb
+- lib/id3dit/tags.rb
+- lib/id3dit/version.rb
+homepage: https://github.com/TheFox/id3dit
+licenses:
+- GPL-3.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.7
+signing_key: 
+specification_version: 4
+summary: ID3 Tags Editor
+test_files: []
+has_rdoc: