Move common libs to libs/common

libs/common/beetsplug/lastgenre/__init__.py

@@ -0,0 +1,456 @@
+# -*- coding: utf-8 -*-
+# This file is part of beets.
+# Copyright 2016, Adrian Sampson.
+#
+# 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.
+
+from __future__ import division, absolute_import, print_function
+import six
+
+"""Gets genres for imported music based on Last.fm tags.
+
+Uses a provided whitelist file to determine which tags are valid genres.
+The included (default) genre list was originally produced by scraping Wikipedia
+and has been edited to remove some questionable entries.
+The scraper script used is available here:
+https://gist.github.com/1241307
+"""
+import pylast
+import codecs
+import os
+import yaml
+import traceback
+
+from beets import plugins
+from beets import ui
+from beets import config
+from beets.util import normpath, plurality
+from beets import library
+
+
+LASTFM = pylast.LastFMNetwork(api_key=plugins.LASTFM_KEY)
+
+PYLAST_EXCEPTIONS = (
+    pylast.WSError,
+    pylast.MalformedResponseError,
+    pylast.NetworkError,
+)
+
+REPLACE = {
+    u'\u2010': '-',
+}
+
+
+def deduplicate(seq):
+    """Remove duplicates from sequence wile preserving order.
+    """
+    seen = set()
+    return [x for x in seq if x not in seen and not seen.add(x)]
+
+
+# Canonicalization tree processing.
+
+def flatten_tree(elem, path, branches):
+    """Flatten nested lists/dictionaries into lists of strings
+    (branches).
+    """
+    if not path:
+        path = []
+
+    if isinstance(elem, dict):
+        for (k, v) in elem.items():
+            flatten_tree(v, path + [k], branches)
+    elif isinstance(elem, list):
+        for sub in elem:
+            flatten_tree(sub, path, branches)
+    else:
+        branches.append(path + [six.text_type(elem)])
+
+
+def find_parents(candidate, branches):
+    """Find parents genre of a given genre, ordered from the closest to
+    the further parent.
+    """
+    for branch in branches:
+        try:
+            idx = branch.index(candidate.lower())
+            return list(reversed(branch[:idx + 1]))
+        except ValueError:
+            continue
+    return [candidate]
+
+
+# Main plugin logic.
+
+WHITELIST = os.path.join(os.path.dirname(__file__), 'genres.txt')
+C14N_TREE = os.path.join(os.path.dirname(__file__), 'genres-tree.yaml')
+
+
+class LastGenrePlugin(plugins.BeetsPlugin):
+    def __init__(self):
+        super(LastGenrePlugin, self).__init__()
+
+        self.config.add({
+            'whitelist': True,
+            'min_weight': 10,
+            'count': 1,
+            'fallback': None,
+            'canonical': False,
+            'source': 'album',
+            'force': True,
+            'auto': True,
+            'separator': u', ',
+            'prefer_specific': False,
+        })
+
+        self.setup()
+
+    def setup(self):
+        """Setup plugin from config options
+        """
+        if self.config['auto']:
+            self.import_stages = [self.imported]
+
+        self._genre_cache = {}
+
+        # Read the whitelist file if enabled.
+        self.whitelist = set()
+        wl_filename = self.config['whitelist'].get()
+        if wl_filename in (True, ''):  # Indicates the default whitelist.
+            wl_filename = WHITELIST
+        if wl_filename:
+            wl_filename = normpath(wl_filename)
+            with open(wl_filename, 'rb') as f:
+                for line in f:
+                    line = line.decode('utf-8').strip().lower()
+                    if line and not line.startswith(u'#'):
+                        self.whitelist.add(line)
+
+        # Read the genres tree for canonicalization if enabled.
+        self.c14n_branches = []
+        c14n_filename = self.config['canonical'].get()
+        if c14n_filename in (True, ''):  # Default tree.
+            c14n_filename = C14N_TREE
+        if c14n_filename:
+            c14n_filename = normpath(c14n_filename)
+            with codecs.open(c14n_filename, 'r', encoding='utf-8') as f:
+                genres_tree = yaml.load(f)
+            flatten_tree(genres_tree, [], self.c14n_branches)
+
+    @property
+    def sources(self):
+        """A tuple of allowed genre sources. May contain 'track',
+        'album', or 'artist.'
+        """
+        source = self.config['source'].as_choice(('track', 'album', 'artist'))
+        if source == 'track':
+            return 'track', 'album', 'artist'
+        elif source == 'album':
+            return 'album', 'artist'
+        elif source == 'artist':
+            return 'artist',
+
+    def _get_depth(self, tag):
+        """Find the depth of a tag in the genres tree.
+        """
+        depth = None
+        for key, value in enumerate(self.c14n_branches):
+            if tag in value:
+                depth = value.index(tag)
+                break
+        return depth
+
+    def _sort_by_depth(self, tags):
+        """Given a list of tags, sort the tags by their depths in the
+        genre tree.
+        """
+        depth_tag_pairs = [(self._get_depth(t), t) for t in tags]
+        depth_tag_pairs = [e for e in depth_tag_pairs if e[0] is not None]
+        depth_tag_pairs.sort(reverse=True)
+        return [p[1] for p in depth_tag_pairs]
+
+    def _resolve_genres(self, tags):
+        """Given a list of strings, return a genre by joining them into a
+        single string and (optionally) canonicalizing each.
+        """
+        if not tags:
+            return None
+
+        count = self.config['count'].get(int)
+        if self.c14n_branches:
+            # Extend the list to consider tags parents in the c14n tree
+            tags_all = []
+            for tag in tags:
+                # Add parents that are in the whitelist, or add the oldest
+                # ancestor if no whitelist
+                if self.whitelist:
+                    parents = [x for x in find_parents(tag, self.c14n_branches)
+                               if self._is_allowed(x)]
+                else:
+                    parents = [find_parents(tag, self.c14n_branches)[-1]]
+
+                tags_all += parents
+                # Stop if we have enough tags already, unless we need to find
+                # the most specific tag (instead of the most popular).
+                if (not self.config['prefer_specific'] and
+                        len(tags_all) >= count):
+                    break
+            tags = tags_all
+
+        tags = deduplicate(tags)
+
+        # Sort the tags by specificity.
+        if self.config['prefer_specific']:
+            tags = self._sort_by_depth(tags)
+
+        # c14n only adds allowed genres but we may have had forbidden genres in
+        # the original tags list
+        tags = [x.title() for x in tags if self._is_allowed(x)]
+
+        return self.config['separator'].as_str().join(
+            tags[:self.config['count'].get(int)]
+        )
+
+    def fetch_genre(self, lastfm_obj):
+        """Return the genre for a pylast entity or None if no suitable genre
+        can be found. Ex. 'Electronic, House, Dance'
+        """
+        min_weight = self.config['min_weight'].get(int)
+        return self._resolve_genres(self._tags_for(lastfm_obj, min_weight))
+
+    def _is_allowed(self, genre):
+        """Determine whether the genre is present in the whitelist,
+        returning a boolean.
+        """
+        if genre is None:
+            return False
+        if not self.whitelist or genre in self.whitelist:
+            return True
+        return False
+
+    # Cached entity lookups.
+
+    def _last_lookup(self, entity, method, *args):
+        """Get a genre based on the named entity using the callable `method`
+        whose arguments are given in the sequence `args`. The genre lookup
+        is cached based on the entity name and the arguments. Before the
+        lookup, each argument is has some Unicode characters replaced with
+        rough ASCII equivalents in order to return better results from the
+        Last.fm database.
+        """
+        # Shortcut if we're missing metadata.
+        if any(not s for s in args):
+            return None
+
+        key = u'{0}.{1}'.format(entity,
+                                u'-'.join(six.text_type(a) for a in args))
+        if key in self._genre_cache:
+            return self._genre_cache[key]
+        else:
+            args_replaced = []
+            for arg in args:
+                for k, v in REPLACE.items():
+                    arg = arg.replace(k, v)
+                args_replaced.append(arg)
+
+            genre = self.fetch_genre(method(*args_replaced))
+            self._genre_cache[key] = genre
+            return genre
+
+    def fetch_album_genre(self, obj):
+        """Return the album genre for this Item or Album.
+        """
+        return self._last_lookup(
+            u'album', LASTFM.get_album, obj.albumartist, obj.album
+        )
+
+    def fetch_album_artist_genre(self, obj):
+        """Return the album artist genre for this Item or Album.
+        """
+        return self._last_lookup(
+            u'artist', LASTFM.get_artist, obj.albumartist
+        )
+
+    def fetch_artist_genre(self, item):
+        """Returns the track artist genre for this Item.
+        """
+        return self._last_lookup(
+            u'artist', LASTFM.get_artist, item.artist
+        )
+
+    def fetch_track_genre(self, obj):
+        """Returns the track genre for this Item.
+        """
+        return self._last_lookup(
+            u'track', LASTFM.get_track, obj.artist, obj.title
+        )
+
+    def _get_genre(self, obj):
+        """Get the genre string for an Album or Item object based on
+        self.sources. Return a `(genre, source)` pair. The
+        prioritization order is:
+            - track (for Items only)
+            - album
+            - artist
+            - original
+            - fallback
+            - None
+        """
+
+        # Shortcut to existing genre if not forcing.
+        if not self.config['force'] and self._is_allowed(obj.genre):
+            return obj.genre, 'keep'
+
+        # Track genre (for Items only).
+        if isinstance(obj, library.Item):
+            if 'track' in self.sources:
+                result = self.fetch_track_genre(obj)
+                if result:
+                    return result, 'track'
+
+        # Album genre.
+        if 'album' in self.sources:
+            result = self.fetch_album_genre(obj)
+            if result:
+                return result, 'album'
+
+        # Artist (or album artist) genre.
+        if 'artist' in self.sources:
+            result = None
+            if isinstance(obj, library.Item):
+                result = self.fetch_artist_genre(obj)
+            elif obj.albumartist != config['va_name'].as_str():
+                result = self.fetch_album_artist_genre(obj)
+            else:
+                # For "Various Artists", pick the most popular track genre.
+                item_genres = []
+                for item in obj.items():
+                    item_genre = None
+                    if 'track' in self.sources:
+                        item_genre = self.fetch_track_genre(item)
+                    if not item_genre:
+                        item_genre = self.fetch_artist_genre(item)
+                    if item_genre:
+                        item_genres.append(item_genre)
+                if item_genres:
+                    result, _ = plurality(item_genres)
+
+            if result:
+                return result, 'artist'
+
+        # Filter the existing genre.
+        if obj.genre:
+            result = self._resolve_genres([obj.genre])
+            if result:
+                return result, 'original'
+
+        # Fallback string.
+        fallback = self.config['fallback'].get()
+        if fallback:
+            return fallback, 'fallback'
+
+        return None, None
+
+    def commands(self):
+        lastgenre_cmd = ui.Subcommand('lastgenre', help=u'fetch genres')
+        lastgenre_cmd.parser.add_option(
+            u'-f', u'--force', dest='force',
+            action='store_true', default=False,
+            help=u're-download genre when already present'
+        )
+        lastgenre_cmd.parser.add_option(
+            u'-s', u'--source', dest='source', type='string',
+            help=u'genre source: artist, album, or track'
+        )
+
+        def lastgenre_func(lib, opts, args):
+            write = ui.should_write()
+            self.config.set_args(opts)
+
+            for album in lib.albums(ui.decargs(args)):
+                album.genre, src = self._get_genre(album)
+                self._log.info(u'genre for album {0} ({1}): {0.genre}',
+                               album, src)
+                album.store()
+
+                for item in album.items():
+                    # If we're using track-level sources, also look up each
+                    # track on the album.
+                    if 'track' in self.sources:
+                        item.genre, src = self._get_genre(item)
+                        item.store()
+                        self._log.info(u'genre for track {0} ({1}): {0.genre}',
+                                       item, src)
+
+                    if write:
+                        item.try_write()
+
+        lastgenre_cmd.func = lastgenre_func
+        return [lastgenre_cmd]
+
+    def imported(self, session, task):
+        """Event hook called when an import task finishes."""
+        if task.is_album:
+            album = task.album
+            album.genre, src = self._get_genre(album)
+            self._log.debug(u'added last.fm album genre ({0}): {1}',
+                            src, album.genre)
+            album.store()
+
+            if 'track' in self.sources:
+                for item in album.items():
+                    item.genre, src = self._get_genre(item)
+                    self._log.debug(u'added last.fm item genre ({0}): {1}',
+                                    src, item.genre)
+                    item.store()
+
+        else:
+            item = task.item
+            item.genre, src = self._get_genre(item)
+            self._log.debug(u'added last.fm item genre ({0}): {1}',
+                            src, item.genre)
+            item.store()
+
+    def _tags_for(self, obj, min_weight=None):
+        """Core genre identification routine.
+
+        Given a pylast entity (album or track), return a list of
+        tag names for that entity. Return an empty list if the entity is
+        not found or another error occurs.
+
+        If `min_weight` is specified, tags are filtered by weight.
+        """
+        # Work around an inconsistency in pylast where
+        # Album.get_top_tags() does not return TopItem instances.
+        # https://github.com/pylast/pylast/issues/86
+        if isinstance(obj, pylast.Album):
+            obj = super(pylast.Album, obj)
+
+        try:
+            res = obj.get_top_tags()
+        except PYLAST_EXCEPTIONS as exc:
+            self._log.debug(u'last.fm error: {0}', exc)
+            return []
+        except Exception as exc:
+            # Isolate bugs in pylast.
+            self._log.debug(u'{}', traceback.format_exc())
+            self._log.error(u'error in pylast library: {0}', exc)
+            return []
+
+        # Filter by weight (optionally).
+        if min_weight:
+            res = [el for el in res if (int(el.weight or 0)) >= min_weight]
+
+        # Get strings from tags.
+        res = [el.item.get_name().lower() for el in res]
+
+        return res

libs/common/beetsplug/lastgenre/genres-tree.yaml

@@ -0,0 +1,749 @@
+- african:
+    - african heavy metal
+    - african hip hop
+    - afrobeat
+    - apala
+    - benga
+    - bikutsi
+    - bongo flava
+    - cape jazz
+    - chimurenga
+    - coupé-décalé
+    - fuji music
+    - genge
+    - highlife
+    - hiplife
+    - isicathamiya
+    - jit
+    - jùjú
+    - kapuka
+    - kizomba
+    - kuduro
+    - kwaito
+    - kwela
+    - makossa
+    - maloya
+    - marrabenta
+    - mbalax
+    - mbaqanga
+    - mbube
+    - morna
+    - museve
+    - palm-wine
+    - raï
+    - sakara
+    - sega
+    - seggae
+    - semba
+    - soukous
+    - taarab
+    - zouglou
+- asian:
+    - east asian:
+        - anison
+        - c-pop
+        - cantopop
+        - enka
+        - hong kong english pop
+        - j-pop
+        - k-pop
+        - kayōkyoku
+        - korean pop
+        - mandopop
+        - onkyokei
+        - taiwanese pop
+    - fann at-tanbura
+    - fijiri
+    - khaliji
+    - liwa
+    - sawt
+    - south and southeast asian:
+        - baila
+        - bhangra
+        - bhojpuri
+        - dangdut
+        - filmi
+        - indian pop
+        - lavani
+        - luk thung:
+            - luk krung
+        - manila sound
+        - morlam
+        - pinoy pop
+        - pop sunda
+        - ragini
+        - thai pop
+- avant-garde:
+    - experimental music
+    - lo-fi
+    - musique concrète
+- blues:
+    - african blues
+    - blues rock
+    - blues shouter
+    - british blues
+    - canadian blues
+    - chicago blues
+    - classic female blues
+    - contemporary r&b
+    - country blues
+    - delta blues
+    - detroit blues
+    - electric blues
+    - gospel blues
+    - hill country blues
+    - hokum blues
+    - jazz blues
+    - jump blues
+    - kansas city blues
+    - louisiana blues
+    - memphis blues
+    - piano blues
+    - piedmont blues
+    - punk blues
+    - soul blues
+    - st. louis blues
+    - swamp blues
+    - texas blues
+    - west coast blues
+- caribbean and latin american:
+    - bachata
+    - baithak gana
+    - bolero
+    - brazilian:
+        - axé
+        - bossa nova
+        - brazilian rock
+        - brega
+        - choro
+        - forró
+        - frevo
+        - funk carioca
+        - lambada
+        - maracatu
+        - música popular brasileira
+        - música sertaneja
+        - pagode
+        - samba
+        - samba rock
+        - tecnobrega
+        - tropicalia
+        - zouk-lambada
+    - calypso
+    - chutney
+    - chutney soca
+    - compas
+    - mambo
+    - merengue
+    - méringue
+    - other latin:
+        - chicha
+        - criolla
+        - cumbia
+        - huayno
+        - mariachi
+        - ranchera
+        - tejano
+    - punta
+    - punta rock
+    - rasin
+    - reggaeton
+    - salsa
+    - soca
+    - son
+    - timba
+    - twoubadou
+    - zouk
+- classical:
+    - ballet
+    - baroque:
+        - baroque music
+    - cantata
+    - chamber music:
+        - string quartet
+    - classical music
+    - concerto:
+        - concerto grosso
+    - contemporary classical
+    - modern classical
+    - opera
+    - oratorio
+    - orchestra:
+        - orchestral
+        - symphonic
+        - symphony
+    - organum
+    - mass:
+        - requiem
+    - sacred music:
+        - cantique
+        - gregorian chant
+    - sonata
+- comedy:
+    - comedy music
+    - comedy rock
+    - humor
+    - parody music
+    - stand-up
+- country:
+    - alternative country:
+        - cowpunk
+    - americana
+    - australian country music
+    - bakersfield sound
+    - bluegrass:
+        - progressive bluegrass
+        - reactionary bluegrass
+    - blues country
+    - cajun:
+        - cajun fiddle tunes
+    - christian country music
+    - classic country
+    - close harmony
+    - country pop
+    - country rap
+    - country rock
+    - country soul
+    - cowboy/western music
+    - dansband music
+    - franco-country
+    - gulf and western
+    - hellbilly music
+    - hokum
+    - honky tonk
+    - instrumental country
+    - lubbock sound
+    - nashville sound
+    - neotraditional country
+    - outlaw country
+    - progressive country
+    - psychobilly/punkabilly
+    - red dirt
+    - rockabilly
+    - sertanejo
+    - texas country
+    - traditional country music
+    - truck-driving country
+    - western swing
+    - zydeco
+- easy listening:
+    - background music
+    - beautiful music
+    - elevator music
+    - furniture music
+    - lounge music
+    - middle of the road
+    - new-age music
+- electronic:
+    - ambient:
+        - ambient dub
+        - ambient house
+        - ambient techno
+        - dark ambient
+        - drone music
+        - illbient
+        - isolationism
+        - lowercase
+    - asian underground
+    - breakbeat:
+        - 4-beat
+        - acid breaks
+        - baltimore club
+        - big beat
+        - breakbeat hardcore
+        - broken beat
+        - florida breaks
+        - nu skool breaks
+    - chiptune:
+        - bitpop
+        - game boy music
+        - nintendocore
+        - video game music
+        - yorkshire bleeps and bass
+    - disco:
+        - cosmic disco
+        - disco polo
+            - euro disco
+        - italo disco
+        - nu-disco
+        - space disco
+    - downtempo:
+        - acid jazz
+        - balearic beat
+        - chill out
+        - dub music
+        - dubtronica
+        - ethnic electronica
+        - moombahton
+        - nu jazz
+        - trip hop
+    - drum and bass:
+        - darkcore
+        - darkstep
+        - drumfunk
+        - drumstep
+        - hardstep
+        - intelligent drum and bass
+        - jump-up
+        - liquid funk
+        - neurofunk
+        - oldschool jungle:
+            - darkside jungle
+            - ragga jungle
+        - raggacore
+        - sambass
+        - techstep
+    - electro:
+        - crunk
+        - electro backbeat
+        - electro-grime
+        - electropop
+    - electroacoustic:
+        - acousmatic music
+        - computer music
+        - electroacoustic improvisation
+        - field recording
+        - live coding
+        - live electronics
+        - soundscape composition
+        - tape music
+    - electronic rock:
+        - alternative dance:
+            - baggy
+            - madchester
+        - dance-punk
+        - dance-rock
+        - dark wave
+        - electroclash
+        - electronicore
+        - electropunk
+        - ethereal wave
+        - indietronica
+        - new rave
+        - space rock
+        - synthpop
+        - synthpunk
+    - electronica:
+        - berlin school
+        - chillwave
+        - electronic art music
+        - electronic dance music
+        - folktronica
+        - freestyle music
+        - glitch
+        - idm
+        - laptronica
+        - skweee
+        - sound art
+        - synthcore
+    - eurodance:
+        - bubblegum dance
+        - italo dance
+        - turbofolk
+    - hardcore:
+        - bouncy house
+        - bouncy techno
+        - breakcore
+        - digital hardcore
+        - doomcore
+        - dubstyle
+        - gabber
+        - happy hardcore
+        - hardstyle
+        - jumpstyle
+        - makina
+        - speedcore
+        - terrorcore
+        - uk hardcore
+    - hi-nrg:
+        - eurobeat
+        - hard nrg
+        - new beat
+    - house:
+        - acid house
+        - chicago house
+        - deep house
+        - diva house
+        - dutch house
+        - electro house
+        - freestyle house
+        - french house
+        - funky house
+        - ghetto house
+        - hardbag
+        - hip house
+        - italo house
+        - latin house
+        - minimal house
+        - progressive house
+        - rave music
+        - swing house
+        - tech house
+        - tribal house
+        - uk hard house
+        - us garage
+        - vocal house
+    - industrial:
+        - aggrotech
+        - coldwave
+        - cybergrind
+        - dark electro
+        - death industrial
+        - electro-industrial
+        - electronic body music:
+            - futurepop
+        - industrial metal:
+            - neue deutsche härte
+        - industrial rock
+        - noise:
+            - japanoise
+            - power electronics
+            - power noise
+        - witch house
+    - post-disco:
+        - boogie
+        - dance-pop
+    - progressive:
+        - progressive house/trance:
+            - disco house
+            - dream house
+            - space house
+        - progressive breaks
+        - progressive drum & bass
+        - progressive techno
+    - techno:
+        - acid techno
+        - detroit techno
+        - free tekno
+        - ghettotech
+        - minimal
+        - nortec
+        - schranz
+        - techno-dnb
+        - technopop
+        - tecno brega
+        - toytown techno
+    - trance:
+        - acid trance
+        - classic trance
+        - dream trance
+        - goa trance:
+            - dark psytrance
+            - full on
+            - psybreaks
+            - psyprog
+            - suomisaundi
+        - hard trance
+        - tech trance
+        - uplifting trance:
+            - orchestral uplifting
+        - vocal trance
+    - uk garage:
+        - 2-step
+        - 4x4
+        - bassline
+        - breakstep
+        - dubstep
+        - funky
+        - grime
+        - speed garage
+        - trap
+- folk:
+    - american folk revival
+    - anti-folk
+    - british folk revival
+    - celtic music
+    - contemporary folk
+    - filk music
+    - freak folk
+    - indie folk
+    - industrial folk
+    - neofolk
+    - progressive folk
+    - psychedelic folk
+    - sung poetry
+    - techno-folk
+- hip hop:
+    - alternative hip hop
+    - avant-garde hip hop
+    - chap hop
+    - christian hip hop
+    - conscious hip hop
+    - country-rap
+    - crunkcore
+    - cumbia rap
+    - east coast hip hop:
+        - brick city club
+        - hardcore hip hop
+        - mafioso rap
+        - new jersey hip hop
+    - electro music
+    - freestyle rap
+    - g-funk
+    - gangsta rap
+    - golden age hip hop
+    - hip hop soul
+    - hip pop
+    - hyphy
+    - industrial hip hop
+    - instrumental hip hop
+    - jazz rap
+    - low bap
+    - lyrical hip hop
+    - merenrap
+    - midwest hip hop:
+        - chicago hip hop
+        - detroit hip hop
+        - horrorcore
+        - st. louis hip hop
+        - twin cities hip hop
+    - motswako
+    - nerdcore
+    - new jack swing
+    - new school hip hop
+    - old school hip hop
+    - political hip hop
+    - rap opera
+    - rap rock:
+        - rap metal
+        - rapcore
+    - songo-salsa
+    - southern hip hop:
+        - atlanta hip hop:
+            - snap music
+        - bounce music
+        - houston hip hop:
+            - chopped and screwed
+        - miami bass
+    - turntablism
+    - underground hip hop
+    - urban pasifika
+    - west coast hip hop:
+        - chicano rap
+        - jerkin'
+- jazz:
+    - asian american jazz
+    - avant-garde jazz
+    - bebop
+    - boogie-woogie
+    - british dance band
+    - chamber jazz
+    - continental jazz
+    - cool jazz
+    - crossover jazz
+    - cubop
+    - dixieland
+    - ethno jazz
+    - european free jazz
+    - free funk
+    - free improvisation
+    - free jazz
+    - gypsy jazz
+    - hard bop
+    - jazz fusion
+    - jazz rock
+    - jazz-funk
+    - kansas city jazz
+    - latin jazz
+    - livetronica
+    - m-base
+    - mainstream jazz
+    - modal jazz
+    - neo-bop jazz
+    - neo-swing
+    - novelty ragtime
+    - orchestral jazz
+    - post-bop
+    - punk jazz
+    - ragtime
+    - shibuya-kei
+    - ska jazz
+    - smooth jazz
+    - soul jazz
+    - straight-ahead jazz
+    - stride jazz
+    - swing
+    - third stream
+    - trad jazz
+    - vocal jazz
+    - west coast gypsy jazz
+    - west coast jazz
+- other:
+    - worldbeat
+- pop:
+    - adult contemporary
+    - arab pop
+    - baroque pop
+    - bubblegum pop
+    - chanson
+    - christian pop
+    - classical crossover
+    - europop:
+        - austropop
+        - balkan pop
+        - french pop
+        - latin pop
+        - laïkó
+        - nederpop
+        - russian pop
+    - iranian pop
+    - jangle pop
+    - latin ballad
+    - levenslied
+    - louisiana swamp pop
+    - mexican pop
+    - motorpop
+    - new romanticism
+    - pop rap
+    - popera
+    - psychedelic pop
+    - schlager
+    - soft rock
+    - sophisti-pop
+    - space age pop
+    - sunshine pop
+    - surf pop
+    - teen pop
+    - traditional pop music
+    - turkish pop
+    - vispop
+    - wonky pop
+- rhythm and blues:
+    - funk:
+        - deep funk
+        - go-go
+        - p-funk
+    - soul:
+        - blue-eyed soul
+        - neo soul
+        - northern soul
+- rock:
+    - alternative rock:
+        - britpop:
+            - post-britpop
+        - dream pop
+        - grunge:
+            - post-grunge
+        - indie pop:
+            - dunedin sound
+            - twee pop
+        - indie rock
+        - noise pop
+        - nu metal
+        - post-punk revival
+        - post-rock:
+            - post-metal
+        - sadcore
+        - shoegaze
+        - slowcore
+    - art rock
+    - beat music
+    - chinese rock
+    - christian rock
+    - dark cabaret
+    - desert rock
+    - experimental rock
+    - folk rock
+    - garage rock
+    - glam rock
+    - hard rock
+    - heavy metal:
+        - alternative metal
+        - black metal:
+            - viking metal
+        - christian metal
+        - death metal:
+            - goregrind
+            - melodic death metal
+            - technical death metal
+        - doom metal
+        - drone metal
+        - folk metal:
+            - celtic metal
+            - medieval metal
+        - funk metal
+        - glam metal
+        - gothic metal
+        - metalcore:
+            - deathcore
+            - mathcore:
+                - djent
+        - power metal
+        - progressive metal
+        - sludge metal
+        - speed metal
+        - stoner rock
+        - symphonic metal
+        - thrash metal:
+            - crossover thrash
+            - groove metal
+    - math rock
+    - new wave:
+        - world fusion
+    - paisley underground
+    - pop rock
+    - post-punk:
+        - gothic rock
+        - no wave
+        - noise rock
+    - power pop
+    - progressive rock:
+        - canterbury scene
+        - krautrock
+        - new prog
+        - rock in opposition
+    - psychedelic rock:
+        - acid rock
+        - freakbeat
+        - neo-psychedelia
+        - raga rock
+    - punk rock:
+        - anarcho punk:
+            - crust punk:
+                - d-beat
+        - art punk
+        - christian punk
+        - deathrock
+        - folk punk:
+            - celtic punk
+            - gypsy punk
+        - garage punk
+        - grindcore:
+            - crustgrind
+            - noisegrind
+        - hardcore punk:
+            - post-hardcore:
+                - emo:
+                    - screamo
+            - powerviolence
+            - street punk
+            - thrashcore
+        - horror punk
+        - pop punk
+        - psychobilly
+        - riot grrrl
+        - ska punk:
+            - ska-core
+        - skate punk
+    - rock and roll
+    - southern rock
+    - sufi rock
+    - surf rock
+    - visual kei:
+        - nagoya kei
+- reggae:
+    - roots reggae
+    - reggae fusion
+    - reggae en español:
+        - spanish reggae
+        - reggae 110
+        - reggae bultrón
+        - romantic flow
+    - lovers rock
+    - raggamuffin:
+        - ragga
+    - dancehall
+    - ska:
+        - 2 tone
+        - dub
+        - rocksteady