MusicBrainz: Archive.org importer

Import audio files and collections into Musicbrainz. Also supports scanning bookmarks and search results for MusicBrainz relations.

目前為 2014-09-29 提交的版本,檢視 最新版本

您需要先安裝使用者腳本管理器擴展,如 TampermonkeyGreasemonkeyViolentmonkey 之後才能安裝該腳本。

You will need to install an extension such as Tampermonkey to install this script.

您需要先安裝使用者腳本管理器擴充功能,如 TampermonkeyViolentmonkey 後才能安裝該腳本。

您需要先安裝使用者腳本管理器擴充功能,如 TampermonkeyUserscripts 後才能安裝該腳本。

你需要先安裝一款使用者腳本管理器擴展,比如 Tampermonkey,才能安裝此腳本

您需要先安裝使用者腳本管理器擴充功能後才能安裝該腳本。

(我已經安裝了使用者腳本管理器,讓我安裝!)

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

(我已經安裝了使用者樣式管理器,讓我安裝!)

// ==UserScript==
// @name        MusicBrainz: Archive.org importer
// @namespace   http://www.jens-bertram.net/userscripts/import-internetarchive
// @description Import audio files and collections into Musicbrainz. Also supports scanning bookmarks and search results for MusicBrainz relations.
// @icon        http://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/Internet_Archive_logo_and_wordmark.png/240px-Internet_Archive_logo_and_wordmark.png
// @supportURL  https://github.com/JensBee/userscripts
// @license     MIT
// @version     0.4.3beta
//
// @grant       none
// @require     https://code.jquery.com/jquery-2.1.1.min.js
// @require     https://greasyfork.org/scripts/5140-musicbrainz-function-library/code/MusicBrainz%20function%20library.js
//
// @include     *://archive.org/details/*
// @include     *://archive.org/bookmarks.php
// @include     *//archive.org/search.php*
// ==/UserScript==
var mbz = mbz || {};
mbz.archive_org_importer = {
  // https://archive.org/about/faqs.php#Audio
  audioFormats: [
    'mp3',
    'flac',
    'ogg',
    'audio',
    'aiff',
    'shorten',
    'weba'],

  /**
    * Check file type for audio format. Filters out most (but not all) other
    * file types.
    * @formatStr file format name
    */
  isAudioFile: function(formatStr) {
    formatStr = formatStr.toLowerCase();
    for (format in this.audioFormats) {
      if (formatStr.contains(format)) {
        return true;
      }
    }
    return false;
  }
};

/**
  * Functions to parse a list of links for MusicBrainz relations.
  */
mbz.archive_org_importer.linkCheck = {
  btn: MBZ.Html.getMbzButton('Check link relations',
    'Check entries being linked from MusicBrainz.'),

  /**
    * Link scanner status values
    */
  links: {
    found: null,
    checked: 0,
    matched: 0
  },

  /**
    * RexEx to strip off current base-url.
    */
  re: new RegExp('^'+window.location.origin),

  /**
    * Scan status elements.
    */
  status: {
    base: $('<span>'),
    current: $('<span>'),
    matched: $('<span>')
  },

  /**
    * Start scanner.
    * @params[links] jQuery object with target links
    * @params[controlEl] jQuery element to append controls to
    */
  scan: function(params) {
    this.links.found = params.links;

    if (this.links.found.length > 0 && params.controlEl) {
      var self = this;

      this.status.current.text(this.links.checked);
      this.status.matched.text(this.links.matched);
      this.status.base.append('&nbsp;Checked: ')
        .append(this.status.current)
        .append('&nbsp;Matches: ')
        .append(this.status.matched)
        .hide();

      this.btn.click(function () {
        self.btn.prop("disabled", true);
        self.btn.text("Checking..");
        self.status.base.show();
        var urls = [];
        $.each(self.links.found, function(idx, link) {
          urls.push('http://archive.org'+$(link).attr('href'));
        });
        MBZ.Release.getUrlRelations({
          urls: MBZ.Util.expandProtocols(urls),
          cb: self.rel.attach,
          cbInc: self.rel.inc,
          cbDone: self.rel.done,
          scope: self
        });
      });
      params.controlEl.append(this.btn).append(this.status.base);
    }
  },

  /**
    * Callback handlers for relation parsing.
    */
  rel: {
    /**
      * Relation was found, data is attached.
      */
    attach: function(data) {
      if (!data._res) {
        return;
      }
      var res = data._res.replace(this.re, '');
      var self = this;
      $.each(self.links.found, function(idx, link) {
        var link = $(link);
        if (link.attr('href') == res) {
          self.status.matched.text(self.links.matched++);
          MBZ.Release.insertMBLink(data, link);
        }
      });
    },

    /**
      * All relations have been resolved.
      */
    done: function() {
      this.status.base.html('&nbsp;' + this.links.checked
        + ' links checked with ' + this.links.matched + ' matches.');
      this.btn.text('Check done');
    },

    /**
      * A relation was checked.
      */
    inc: function() {
      this.status.current.text(this.links.checked++);
    },
  }
}

/**
  * Functions to import a single release.
  */
mbz.archive_org_importer.release = {
  btn: MBZ.Html.getMbzButton('Import', 'Import this release to MusicBrainz'),
  dEl: $('<div id="mbzDialog">').hide(), // dialog elements
  mbLinkTarget: null,
  importRunning: false,
  importInitialized: false,

  /**
    * Initialize release parsing.
    */
  init: function() {
    this.tracks.detectSources.call(this);

    var playerJSON = $('#midcol > script').text().trim()
      .match(/Play\([\s\S]*?\[([\s\S]*)\]/);
    if (!playerJSON) {
      console.error('Player JSON data not found. Disabling MusicBrainz import.');
      return;
    }

    var self = this;
    var cEl = $('<div id="mbzControls">'); // control elements
    var url = MBZ.Util.rmTrSlash($(location).attr('href'));
    var urlJSON = url + '&output=json';
    var trackData = $.parseJSON('[' + playerJSON[1] + ']');
    var pageJSON = null; // page data as JSON object

    this.btn.click(function () {
      if (!self.importInitialized) {
        self.btn.prop("disabled", true);
        self.btn.text("Initializing import");
        // prepare source data
        $.getJSON(urlJSON, function (data) {
          pageJSON = data;
          self.tracks.parseSources.call(self, data);
        }).fail(function(jqxhr, textStatus, error) {
          var err = textStatus + ', ' + error;
          console.error("Request (" + urlJSON + ") failed: " + err);
          self.btn.text("ERROR");
        });
        return;
      }

      self.dEl.hide();
      self.btn.prop("disabled", true);
      // *** static data
      self.release.addMedium({
        idx: 0,
        fmt: 'Digital Media'
      });
      self.release.setPackaging('none');
      self.release.setNote('Imported from The Internet Archive (' + url + ')');
      // *** parsed data from release JSON object
      self.parseJSON.urls.call(self, pageJSON);
      self.parseJSON.artists.call(self, pageJSON);
      self.parseJSON.title.call(self, pageJSON);
      self.parseJSON.labels.call(self, pageJSON);
      self.parseJSON.release.call(self, pageJSON);
      self.parseJSON.annotation.call(self, pageJSON);
      self.tracks.commit.call(self);
      // submit
      //self.release.dump();
      self.release.submitRelease();
      self.btn.text("Data submitted");
    });
    $('.breadcrumbs').before(cEl.append(this.btn));
    cEl.after(self.dEl);
    self.mbLinkTarget = self.btn;
    MBZ.Release.getUrlRelations({
      urls: MBZ.Util.expandProtocol(url),
      cb: MBZ.Release.insertMBLink,
      scope: self
    });
  },

  tracks: {
    /**
    * Target element to display track source contents.
    */
    contentHtml: $('<div>'),
    /**
    * Store parsed track data objects to allow multiple data editing passes.
    */
    data: {},
    /**
    * Track data sources available.
    */
    sources: [],
    /**
    * Track source to use.
    */
    selectedSource: null,
    /**
      * Number of unique valid sources.
      */
    validSources: 0,

    /**
      * Add all available track sources to a user dialog.
      */
    addSources: function(show) {
      var self = this;
      var sourceSelect = $('<select>');

      sourceSelect.on('change', function(){
        self.tracks.selectedSource = this.value;
        self.tracks.showSources.call(self);
      });

      // add sources
      $.each(this.tracks.sources, function(idx, source) {
        //var source = self.tracks.sources[idx];

        if (!source.dupe && source.files && source.files.length > 0) {
          var sourceTitle = '';
          if (source.type == 'player') {
            sourceTitle = 'Web Player';
          } else {
            sourceTitle = 'Playlist (' + source.name + ')';
          }
          sourceSelect.append('<option value="' + idx + '">'
            + sourceTitle + '</option>');
        }
      });

      // add elements
      this.dEl.append(sourceSelect);
      sourceSelect.before('Found multiple track listings with different items.'
        + '<br/>Please select a track data source to import: ');
      this.dEl.append(this.tracks.contentHtml);
    },

    /**
      * Commit currently selected tracks source to be included in MusicBrainz
      * submission.
      */
    commit: function() {
      var self = this;

      $.each(this.tracks.sources[this.tracks.selectedSource].files,
          function(idx, val) {
        self.tracks.data[val].idx = idx; // reset track number
        self.release.addTrack(self.tracks.data[val]);
      });
    },

    /**
      * Check which track sources are available. Called on page loading.
      */
    detectSources: function() {
      var self = this;

      // internal player data
      var playerJSON = $('#midcol > script').text().trim()
        .match(/Play\([\s\S]*?\[([\s\S]*)\]/);
      if (playerJSON) {
        this.tracks.sources.push({
          type: 'player',
          name: 'web-player',
          data: $.parseJSON('[' + playerJSON[1] + ']')
        });
      }

      // playlists
      $('#ff0 a').each(function(idx, item){
        var url = $(item).attr('href');
        if (url.endsWith('.m3u')) {
          self.tracks.sources.push({
            type: 'playlist',
            //name: listName,
            name: MBZ.Util.getLastPathSegment(decodeURIComponent(url)),
            url: url //window.location.origin + url
          });
        }
      });

      if (this.tracks.sources.length > 0) {
        // default to first entry
        this.tracks.selectedSource = 0;
      }
    },

    /**
      * Parse track data from all available sources. Called, when import is
      * initialized.
      * @pageData page data as JSON object
      */
    parseSources: function(pageData) {
      var self = this;
      var sourceParsedCount = 0;

      function incParsedCount() {
        // increase parsed sources counter
        if (++sourceParsedCount == self.tracks.sources.length) {
          self.tracks.squashSources.call(self);
          if (self.tracks.validSources > 1) {
            self.tracks.addSources.call(self);
          }
          // all data parsed, proceed with import
          self.enableImport();
        }
      }

      function getTrackList(source) {
        if (source.files && source.files.length > 0) {
          // looks like data is already set
          return;
        }
        source.files = [];
        if (source.type == 'player') {
          $.each(source.data, function(idx, val) {
            var file = val.sources[0].file;
            if (file) {
              source.files.push(MBZ.Util.getLastPathSegment(file));
            }
          });
          // done
          incParsedCount();
        } else if (source.type == 'playlist') {
          // needed, since we get redirected to differet subdomain
          var url = 'https://cors-anywhere.herokuapp.com/archive.org:443'
            + source.url;
          $.get(url, function(data) {
            //source.data = data;
            var files = data.split('\n');
            $.each(files, function(idx, file) {
              file = MBZ.Util.getLastPathSegment(file.trim());
              if (file.length > 0) {
                source.files.push(file);
              }
            });
          }, 'text').fail(function(jqxhr, textStatus, error) {
            var err = textStatus + ', ' + error;
            console.error("Request (" + url + ") failed: " + err);
          }).always(function() {
            // done
            incParsedCount();
          });
        }
      }

      // First try to parse data from the internal player as a basis. This data
      // may be incomplete (cropped track names) so add it first and overwrite it
      // later with more complete data from the page's JSON.
      $.each(this.tracks.sources, function(idx, val) {
        var source = self.tracks.sources[idx];
        if (source.type == 'player') {
          // parse some track data from the player
          self.parseJSON.tracksFromPlayer.call(self, source.data);
        }
      });

      // try to get missing data from page's JSON object
      if (pageData.files) {
        self.parseJSON.tracksFromPage.call(self, pageData);
      }

      // since track data is available, pase the track list for each source
      $.each(this.tracks.sources, function(idx, val) {
        getTrackList(val);
      });
    },

    /**
      * Initialize and show the source's track data dialog. Also called, to update
      * on track source data select change.
      */
    showSources: function() {
      var self = this;
      var trackTable = $('<table id="mbzImportTrackTable">'
        + '<thead>'
        + '<tr>'
        + '<td>#</td><td>Title</td><td>Length</td>'
        + '</tr></thead></table>');
      var trackList = $('<tbody>');

      $.each(this.tracks.sources[this.tracks.selectedSource].files,
          function(idx, val) {
        if (self.tracks.data[val]) {
          var duration = self.tracks.data[val].dur;
          duration = (duration ? MBZ.Util.msToHms(duration) : '&mdash;');
          trackList.append($('<tr>'
            + '<td>' + (idx + 1) + '</td>'
            + '<td>' + self.tracks.data[val].tit + '</td>'
            + '<td>' + duration + '</td>'
            + '</tr>'));
        } else {
          console.warn('No data for file "' + val + '" found.');
        }
      });

      trackTable.append(trackList);
      this.tracks.contentHtml.html(trackTable);

      this.dEl.show();
    },

    /**
      * Remove duplicated sources which have the same track lists.
      */
    squashSources: function() {
      var self = this;

      /**
        * Compare files for two sources.
        */
      function compareFiles(a, b) {
        if (a.length != b.length) {
          return false;
        }

        for (var i=0; i<a.length; i++) {
          if (a[i] != b[i]) {
            return false;
          }
        }
        return true;
      }

      // go through all source's files
      for (var i=0; i<this.tracks.sources.length; i++) {
        var src = this.tracks.sources[i];
        if (!src.dupe) {
          var a = src.files;
          if (!a || a.length == 0) {
            src.dupe = true;
            console.warn("Remove source '" + src.name + "' no files found.");
          } else if ((i + 1) < this.tracks.sources.length) {
            for (var j=i + 1; j<this.tracks.sources.length; j++) {
              var b = this.tracks.sources[j];
              if (!b.dupe) {
                if (compareFiles(a, b.files)) {
                  b.dupe = true;
                }
              }
            }
          }
        }
      }

      // count valid sources
      $.each(this.tracks.sources, function(idx, val) {
        if (!val.dupe && val.files.length > 0) {
          self.tracks.validSources++;
        }
      });
    },

    /**
      * Update track metadata with new values. If a value is already set, it will
      * get overwritten with the new one.
      */
    updateData: function(data) {
      function isValid(dataEntry) {
        if (typeof dataEntry !== 'undefined' && dataEntry != null) {
          if (typeof dataEntry === 'string') {
            if (dataEntry.trim().length > 0) {
              return true;
            }
            return false;
          } else {
            return true;
          }
        }
        return false;
      }

      if (this.tracks.data[data.file]) {
        var tData = this.tracks.data[data.file];
        // update
        if (isValid(data.med)) {
          tData.med = data.med;
        }
        if (isValid(data.tit)) {
          tData.tit = data.tit.trim();
        }
        if (isValid(data.idx)) {
          tData.idx = data.idx;
        }
        if (isValid(data.dur)) {
          tData.dur = data.dur;
        }
      } else {
        // add new
        this.tracks.data[data.file] = data;
      }
    },
  },

  /**
    * Callback function. Called when all sources are parsed.
    */
  enableImport: function() {
    this.importInitialized = true;

    if (this.tracks.validSources > 1) {
      this.tracks.showSources.call(this);
      this.btn.text("Start import");
      this.btn.prop("disabled", false);
    } else {
      this.btn.click();
    }
  },

  /**
    * Parse JSON response for a release.
    */
  parseJSON: {
    annotation: function (data) {
      if (data.metadata.notes) {
        this.release.setAnnotation(data.metadata.notes[0]);
      }
    },
    artists: function (data) {
      if (data.metadata.creator) {
        var self = this;
        $.each(data.metadata.creator, function (idx, val) {
          self.release.addArtist(val);
        });
      }
    },
    labels: function (data) {
      if (data.metadata.collection) {
        var self = this;
        $.each(data.metadata.collection, function (idx, val) {
          self.release.addLabel({
            name: val,
            catNo: data.metadata.identifier[0]
          });
        });
      }
    },
    release: function (data) {
      var dates = data.metadata.date || data.metadata.publicdate;
      if (dates) {
        var self = this;
        $.each(dates, function (idx, val) {
          var date = val.match(/([0-9]{4})-([0-9]{2})-([0-9]{2}).*/);
          if (date && date.length == 4) {
            self.release.addRelease({
              y: date[1],
              m: date[2],
              d: date[3],
              cc:'XW'
            });
          }
        });
      }
    },
    urls: function (data) {
      var url = $(location).attr('href');
      this.release.addUrl(url, '75');
      this.release.addUrl(url, '85');
      if (data.creativecommons && data.creativecommons.license_url) {
        this.release.addUrl(data.creativecommons.license_url, '301');
      }
    },
    title: function (data) {
      if (data.metadata.title) {
        this.release.setTitle(data.metadata.title[0]);
      }
    },
    /**
      * First parse track list from player JSON data. The provided information
      * may not be complete, so gather the parsed data in a local array.
      */
    tracksFromPlayer: function(data) {
      if (data.length > 0) {
        var self = this;
        $.each(data, function(idx, val) {
          var duration = MBZ.Util.hmsToSeconds(val.duration);
          duration = Math.round(parseFloat(duration) * 1000); // sec to msec
          if (isNaN(duration)) {
            duration = null;
          }
          // get source file name
          var file = val.sources[0].file;
          if (file) {
            self.tracks.updateData.call(self, {
              med: 0,
              tit: val.title.replace(/^[0-9]+\.\s/,''),
              idx: idx,
              dur: duration,
              file: MBZ.Util.getLastPathSegment(file)
            });
          } else {
            console.log("Could not parse file name from player JSON.");
          }
        });
      }
    },
    tracksFromPage: function(data) {
      if (data && data.files) {
        var self = this;
        $.each(data.files, function(file, val){
          if (mbz.archive_org_importer.isAudioFile(val.format)) {
            var fileName = file.replace(/^\//, ''); // remove leading slash
            var duration = MBZ.Util.hmsToSeconds(val.duration);
            duration = Math.round(parseFloat(duration) * 1000); // sec to msec
            if (isNaN(duration)) {
              duration = null;
            }

            self.tracks.updateData.call(self, {
              med: 0,
              tit: val.title,
              dur: duration,
              file: fileName
            });
          }
        });
      }
    }
  },

  /**
    * Release data object finally passed on to MusicBrainz.
    */
  release: new MBZ.Release(),
};

mbz.archive_org_importer.init = function() {
  var pageType = window.location.pathname.split('/');
  if (pageType.length >= 2) {
    pageType = pageType[1].toLowerCase()
  } else {
    return;
  }

  MBZ.Html.globStyle.append(
    '#mbzImportTrackTable {margin-top:0.5em;margin-left:0.5em;}'
    + '#mbzImportTrackTable thead {'
      + 'font-weight:bold;'
      + 'background-color:rgba(115,108,174,0.5);'
    + '}'
    + '#mbzImportTrackTable tbody td:nth-child(1) {'
      + 'border-right:1px solid #666;'
      + 'padding-right:0.15em;'
    + '}'
    + '#mbzImportTrackTable tbody tr:nth-child(odd) {'
      + 'background-color:rgba(0,0,0,0.1);'
    + '}'
    + '#mbzImportTrackTable tbody td:nth-child(2) {'
      + 'padding-left:0.3em;'
    + '}'
    + '#mbzImportTrackTable tbody td:nth-child(3) {'
      + 'padding-left:0.3em;'
      + 'font-family:courier,monospace;'
      + 'text-align:right;'
    + '}'
  );

  if (pageType == 'details' && $('body').hasClass('Audio')) {
    // import a release
    mbz.archive_org_importer.release.init();
  } else if (pageType == 'bookmarks.php') {
    // check all bookmarks for MusicBrainz relations
    var links = $('.box>table>tbody a').filter(function(idx) {
      // no way to check type for audio here
      return $(this).attr('href').startsWith('/details/');
    });
    var control = $('<div id="mbzControls">');
    $('.box>h1').after(control);
    if (links.length > 0) {
      mbz.archive_org_importer.linkCheck.scan({
        links: links,
        controlEl: control
      });
    }
  } else if (pageType == 'search.php') {
    var links = [];
    // check audio links for MusicBrainz relations
    var audioItems = $('.numberCell>img[alt="[audio]"]').filter(function(idx) {
      // get the first linked audio item..
      var el = $(this).parent().next().children('a')[0];
      if (el) {
        el = $(el);
        if (el.attr('href').startsWith('/details/')) {
          // ..and extract it's url
          links.push(el);
        }
      }
    });
    var control = $('<div>');
    var col = $('<td colspan="2">');
    col.append(control);
    var row = $('<tr>').append(col);
    $('.resultsTable').prepend(row);
    if (links.length > 0) {
      mbz.archive_org_importer.linkCheck.scan({
        links: links,
        controlEl: control
      });
    }
  }
};

mbz.archive_org_importer.init();