ogg_album_tagger 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 677d2faa7f9687d6108fe6b2cdb1ccafb25952ab
-  data.tar.gz: 6c16e194ad9ebb0dc94944b2fe202953e438e365
+  metadata.gz: 6d13c462c83f93828d568095096c34e0c17c494a
+  data.tar.gz: f8831db62a56402c7787ee766382d3d70205803d
 SHA512:
-  metadata.gz: 3ed2555d969ad45a4c6e980d4e03013a71e9d473d83d29080248274c64ddb6abc4a341d198e8788d171dec8766c3cc7dcad1f1d8ec8e3c3ea30d9c2ba396e157
-  data.tar.gz: fe70f9f75f0709974804fc044263ea0210d5b39a21a21e440220133158430a1a236b51755e2e606fb3324207c9cd1f85c50c472561df7bca23e6cb6bc85e714e
+  metadata.gz: aaaff467e4e5c9d31b176d187f03145bc982b86e54b7de0862f50ed9cf6267e5d53419c1609007cd821be1c5bfe47cfbf9a2e528e4ff344513b0d0c0f5c0c4c0
+  data.tar.gz: 02fc749bd1e46d3fb9c8a980d2e70fd2ad5221cc218138db207901cd25b0640a9580d07d220b34d154f387d7b71f282a21b2b0819ae7ee69022bc3b81a68c671

data/lib/ogg_album_tagger/version.rb

@@ -1,3 +1,3 @@
 module OggAlbumTagger
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ogg_album_tagger
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Cyrille Faucheux
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-21 00:00:00.000000000 Z
+date: 2015-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -74,18 +74,12 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- Gemfile
-- LICENSE.txt
-- README.md
-- Rakefile
 - bin/ogg-album-tagger
 - lib/ogg_album_tagger/exceptions.rb
 - lib/ogg_album_tagger/library.rb
 - lib/ogg_album_tagger/picture.rb
 - lib/ogg_album_tagger/tag_container.rb
 - lib/ogg_album_tagger/version.rb
-- ogg_album_tagger.gemspec
 homepage: https://github.com/Sigill/OggAlbumTagger
 licenses:
 - MIT
@@ -109,5 +103,5 @@ rubyforge_project:
 rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: Interactive edition of ogg tags in an album or a compilation.
+summary: Interactive edition of ogg tags with support for whole albums.
 test_files: []

data/.gitignore

@@ -1,15 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log
-*.swp

data/Gemfile

@@ -1,4 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in ogg_album_tagger.gemspec
-gemspec

data/LICENSE.txt

@@ -1,22 +0,0 @@
-Copyright (c) 2014 Cyrille Faucheux
-
-MIT License
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,161 +0,0 @@
-# OggAlbumTagger
-
-OggAlbumTagger is an interactive command line tool that help you tag ogg files. As the name suggest, OggAlbumTagger is able to manage whole albums and compilations.
-
-## Why OggAlbumTagger
-
-I wanted a tool that would give me a full and easy access to all tags and would integrate some logic to quickly tag full albums or compilations.
-
-Current solutions were not satisfying enough to me:
-- No easy way to access non-standard tags.
-- No/limited support for tags with multiple values.
-- No easy way to tag full albums.
-- Unwanted padding of numerical tags.
-- No consistency concerning the case and order of the tags (ok, this point might be a bit excessive).
-
-Therefore, I wrote OggAlbumTagger. It is designed to enforce some good tagging practices (you can read about them in the "How to properly tag your music" section below), but it will let you do whatever you want.
-
-## Usage
-
-    $ ogg-album-tagger [options] files|directories
-    Options:
-        -a, --album    Album mode, treat a single directory as an album.
-        -v, --version  Display version information and exit.
-        -h, --help     Print this help.
-
-When executed, OggAlbumTagger extracts the tags of the ogg files passed as arguments (ogg files will be searched recursively in directories). Once done, you have to use the commands listed below to access and modify the tags.
-
-When the `-a` option is passed, OggAlbumTagger will require album (or compilation) specific tags, will enforce a few more good tagging practices and will allow you to rename the album directory along with the tracks. You have to work on a single directory.
-
-### Preliminary notes
-
-- OggAlbumTagger works like most terminals. Arguments need to be separated by one or more spaces. If your argument contains special characters (spaces, single or double quotes), you can either escape them with a backslash (`\`) or enclose your argument with single or double quotes. Inside a double-quoted argument, you can escape double quotes with a backslash. Single-quoted arguments do not support escaping.
-
-- OggAlbumTagger is capable of autocompletion and autosuggestion. Press the `tab` key to autocomplete your arguments, tag names, tag values and filenames. If you don't know what to do, double press `tab` to get suggestions.
-
-- Tag names are case insensitive, but they will be written uppercase in files.
-
-- Each tag can have multiple values (but in order to enforce good tagging practices, OggAlbumTagger will prevent you to do so for some tags).
-
-- OggAlbumTagger uses UTF-8 (but currently I don't know what happen if your terminal is not in UTF-8).
-
-### Available commands
-
-- `ls`: lists the files you have access to. Files are sorted according to their filename and are indexed by their position in the list. The star at the beginning of a line indicates that the file is selected (see the `select` command for more details).
-
-```
-> ls
-*    1: Queen - 1981 - Greatest Hits I - 01 - Bohemian Rapsody (1975).ogg
-*    2: Queen - 1981 - Greatest Hits I - 02 - Another One Bites The Dust (1980).ogg
-*    3: Queen - 1981 - Greatest Hits I - 03 - Killer Queen (1974).ogg
-...
-```
-
-- `select arg1 [arg2...]`: allow to select a subset of files to work on. The following selectors are available:
-    - `all`: selects all the files.
-    - `i`: selects the file at position `i` in the list.
-    - `i-j`: selects the files from position `i` to position `j` in the list.
-
-  Index-based arguments can be prefixed by a `+` or `-` sign (e.g. `-3` or `+10-20`). In this case your selector will add or remove elements to the current selection.
-
-  Multiple selectors can be specified at once. Order is important.
-
-- `show`: without argument, displays the tags of the selected files. Tags are sorted alphabetically, except for the `metadata_block_picture` which is listed last. The command can be restricted to a single tag XXX by using the `show tag xxx` command.
-
-- `set <tag> value1 [value2...]`: tags each selected files with the specified tag and all specified values. If the tag does not exists, it is created. If it already exists, all previous values are discarded before adding the new ones. Duplicated values are discarded.
-
-  If the tag is `metadata_block_picture` (also aliased as `picture`), you have to provide the path to a jpeg or png file (autocomplete also works here) and optionally a description of the picture. OggAlbumTagger currently only supports the "front cover" type (see http://xiph.org/flac/format.html#metadata_block_picture).
-
-- `add <tag> value1 [value2...]`: like `set`, but previous values are not discarded.
-
-- `rm <tag> [value1...]`: removes the specified values of the specified tag for all selected files. If no value is specified, the tag is deleted.
-
-- `auto tracknumber`: automatically sets the `TRACKNUMBER` tag based on the selection. Numbering starts at 1, there is no padding with zeros.
-
-- `auto rename`: renames the directory and the files based on the tags. Different patterns are used:
-
-  - Single files
-
-    Directory: N/A
-
-    Ogg files: ARTIST - DATE - TITLE.ogg
-
-  - Albums
-
-    Directory: ARTIST - DATE - ALBUM
-
-    Ogg files: ARTIST - DATE - ALBUM - [DISCNUMBER.]TRACKNUMBER - TITLE.ogg
-
-  - Single artist compilations (albums where tracks have different dates, like a best-of)
-
-    Directory: ARTIST - ALBUMDATE - ALBUM
-
-    Ogg files: ARTIST - ALBUMDATE - ALBUM - [DISCNUMBER.]TRACKNUMBER - TITLE - DATE.ogg
-
-  - Compilations
-
-    Directory: ALBUM - ALBUMDATE
-
-    Ogg files: ALBUM - ALBUMDATE - [DISCNUMBER.]TRACKNUMBER - ARTIST - DATE - TITLE.ogg
-
-  `DISCNUMBER` and `TRACKNUMBER` tags are automatically padded with zeros in order to be of equal length and allow alphabetical sort.
-
-  Those characters are not authorized in file names: `\/:*?"<>|`. They will be removed.
-
-  In album mode, all ogg files will be moved to the root of the album.
-
-- `check`: verify that you follow good tagging practices.
-
-- `write`: writes the tags in the files.
-
-- `quit`: discards all modifications and closes OggAlbumTagger.
-
-## How to install
-
-First, you need to install the `exiftool` tool and `libtag` (also called `taglib` on some systems) library (you need the development package, since the ruby gem will be built upon it). For example, on Debian/Ubuntu systems, run `apt-get install libimage-exiftool-perl libtag1-dev` from your terminal.
-
-### From source
-
-If you are planning to contribute, install the `rake` and `bundle` gems: `gem install rake bundle`.
-
-#### Install
-
-Run `bundle install` to install dependencies.
-
-Run `rake install` to install the gem from the sources.
-
-#### Run without installing
-
-From the root of the source folder, run `bundle exec ogg-album-tagger  ...`.
-
-## How to properly tag your music
-
-These good practices apply to Vorbis comments (the type of tags used in ogg files). There is nothing official about them, they only describe an efficient way to tag your music.
-
-Always specify the ARTIST, TITLE and DATE (OggAlbumTagger requires a year) tags.
-
-For albums, best-of (same artist, different dates) and compilations (different artists), specify the ALBUM and TRACKNUMBER. If there is multiple discs, use the DISCNUMBER tag. Do not pad numerical tags (TRACKNUMBER, DISCNUMBER) with zeros (if you media player is unable to know that 2 comes before 10, use another media player). If the tracks of your best-of/compilation are composed at different DATEs, use the ALBUMDATE tag.
-
-On compilations (and only compilations), set the ALBUMARTIST tag to "Various artists". This way, you can easily search for compilations in your audio library.
-
-The ALBUM, ARTIST, ALBUMARTIST and TITLE tags are designed for systems with limited display capabilities. When used, they must contain one single value.
-
-You can specify alternate values using the ALBUMSORT, ARTISTSORT, ALBUMARTISTSORT and TITLESORT tags. The ARTISTSORT is especially usefull if you want to specify the name of all members of a group (so that searching for John Lennon will give you its performances from The Beatles years and from its experimental period with Yoko Ono), or if you want The Beatles to be listed at "B" or Bob Dylan to also be listed as "Dylan, Bob". If your media player does not support these *SORT tags, use another media player.
-
-Its nice to have a GENRE (or several). Don't try to be too precise or too exhaustive, or it might make it harder to search by genre. Use the genres you are able to recognize. You also can split "hybrid" genres like "Pop-Rock".
-
-Other standard tags: see [this page](http://www.xiph.org/vorbis/doc/v-comment.html) and [this one](http://age.hobba.nl/audio/mirroredpages/ogg-tagging.html). But you can achieve pretty good tagging using the tags listed above.
-
-## TODO
-
-Not every functionality in this list has to be implemented. Actually, I don't need most of them. If you have some time to spare, I'll be happy to accept your contributions.
-
-* Support other audio formats: OggalbumTagger is built upon the [TagLib gem](http://robinst.github.io/taglib-ruby/), which support many audio formats. Theoretically, it is possible to support them in oggAlbumTagger (the name can be changed). In practice, I've no desire to play with those ugly ID3 tags and theirs versions and encodings. If you need this, it might be quicker for you to convert your music library to ogg (I've done it, no regret).
-* Make the code modular, so that each available command live in a single class that handle it's own autosuggestion, autocompletion, execution... Ok, it requires to rewrite half of the program, but it would be cool.
-* Fill tags from filenames or from some CDDB/FreeDB/... database. In the meantime, use [lltags](http://home.gna.org/lltag/).
-* Export cover pictures.
-* Whatever you feel useful...
-
-## License
-
-This tool is released under the terms of the MIT License. See the LICENSE.txt file for more details.

data/Rakefile

@@ -1,2 +0,0 @@
-require "bundler/gem_tasks"
-

data/ogg_album_tagger.gemspec

@@ -1,25 +0,0 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'ogg_album_tagger/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "ogg_album_tagger"
-  spec.version       = OggAlbumTagger::VERSION
-  spec.authors       = ["Cyrille Faucheux"]
-  spec.email         = ["cyrille.faucheux@gmail.com"]
-  spec.summary       = "Interactive edition of ogg tags in an album or a compilation."
-  spec.homepage      = "https://github.com/Sigill/OggAlbumTagger"
-  spec.license       = "MIT"
-
-  spec.files         = `git ls-files -z`.split("\x0")
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "bundler", "~> 1.7"
-  spec.add_development_dependency "rake", "~> 10.0"
-
-  spec.add_runtime_dependency "exiftool", ["~> 0.6"]
-  spec.add_runtime_dependency "taglib-ruby", ["~> 0.7"]
-end