音楽ファイルのメタデータ文字化け問題を遂に解決した！

from mutagen.id3 import Encoding, ID3, TextFrame, TimeStampTextFrame, PairedTextFrame

file_path = '/path/to/music.mp3'

tags = ID3(file_path)
keys = list(tags.keys())   # tags は順次書き換えるので先にタグ名のリストを保管
for key in keys:
    if not re.match(r'^T.*', key):  # "T" で始まるタグ以外はスキップ
        continue
    tag_list = tags.getall(key)  # 各データフレームの内容も書き換えるのでリストとして保管
    for tag in tag_list:
        if (
            (not issubclass(type(tag), TextFrame)) or     # TextFrame の派生クラスのみを対象とする。
            issubclass(type(tag), TimeStampTextFrame) or  # ただし TimeStampTextFrame の派生クラスと
            issubclass(type(tag), PairedTextFrame)        # PairedTextFrame の派生クラスは除外。
        ):
            continue

        if tag.encoding != Encoding.LATIN1:
            continue

        # 以下実際の変換処理

from unicodedata import category

def check_cc(s: str) -> bool:
    """str オブジェクトの制御コード有無をチェック

    Args:
        s (str): チェック対象の str オブジェクト
    Return:
        (bool): 判定結果 - 制御コードが含まれていれば True, いなければ False
    """
    if type(s) is not str:
        logger.info(f'Invalid type {type(s)} detected')
        return False
    return any(map(lambda c: category(c) == 'Cc', s))

"""check all id3 tags"""
import logging
import re
import shutil
from pathlib import Path
from unicodedata import category

from mutagen.id3 import Encoding, ID3, ID3NoHeaderError, TextFrame, TimeStampTextFrame, PairedTextFrame

logger = logging.getLogger(__name__)

ORG_ENCODING = 'latin_1'  # 修正対象の元のエンコーディング
CAND_ENCODING = 'cp932'   # 修正後の候補のエンコーディング


def check_cc(s: str) -> bool:
    """str オブジェクトの制御コード有無をチェック

    Args:
        s (str): チェック対象の str オブジェクト
    Return:
        (bool): 判定結果 - 制御コードが含まれていれば True, いなければ False
    """
    if type(s) is not str:
        logger.info(f'Invalid type {type(s)} detected')
        return False
    return any(map(lambda c: category(c) == 'Cc', s))


def update_id3_tags(file_path: Path) -> bool:
    """ファイルのタグを更新

    T で始まるタグでエンコーディングが LATIN1 であるもののみを対象とする。

    Args:
        file_path (Path): チェック対象の Path オブジェクト
    Return:
        (bool): 更新ありの時 True, なしの時 False
    """
    tags = ID3(file_path)
    updated = False
    keys = list(tags.keys())   # tags は順次書き換えるので先にタグ名のリストを保管
    for key in keys:
        if not re.match(r'^T.*', key):  # "T" で始まるタグ以外はスキップ
            continue
        logger.debug(f'{key}')
        tag_list = tags.getall(key)  # 各データフレームの内容も書き換えるのでリストとして保管
        for tag in tag_list:
            tag_updated = False
            if (
                (not issubclass(type(tag), TextFrame)) or     # TextFrame の派生クラスのみを対象とする。
                issubclass(type(tag), TimeStampTextFrame) or  # ただし TimeStampTextFrame の派生クラスと
                issubclass(type(tag), PairedTextFrame)        # PairedTextFrame の派生クラスは除外。
            ):
                logger.debug(f'{type(tag)} found, skipping.')
                continue

            if tag.encoding != Encoding.LATIN1:
                logger.debug(f'Encoding is {tag.encoding}, skipping.')
                continue
            new_text = []
            new_encoding = Encoding.LATIN1
            for text in tag.text:  # tag.text は str 型のテキストデータのリスト
                text_bytes = text.encode(ORG_ENCODING)
                try:
                    fixed_text = text_bytes.decode(CAND_ENCODING)
                except UnicodeDecodeError:  # CP932 にデコードできない場合は Latin-1 のままが正しい
                    logger.exception(f'Tried to decode {text_bytes} as {CAND_ENCODING} but failed.')
                    continue
                if text != fixed_text and check_cc(text):  # 文字化けありの場合 (後者の条件だけでも良かったはず)
                    logger.info(f'Fixed: {str(file_path)}\t{key}\t{text}\t{text_bytes}\t{fixed_text}')
                    new_text.append(fixed_text)
                    new_encoding = Encoding.UTF8
                else:
                    logger.debug(f'Preserved: {str(file_path)}\t{key}\t{text}\t{text_bytes}\t{fixed_text}')
                    new_text.append(text)
            if new_encoding != tag.encoding:
                tag.encoding = new_encoding
                tag.text = new_text
                tag_updated = True
                logger.debug('Tag frame updated.')
        if tag_updated:
            updated = True
            logger.info(f'{key} updated.')

    if updated:  # 更新がある場合は元ファイルのバックアップを作成したうえで修正を保存
        logger.info(f'Saving update for {str(file_path)}.')
        shutil.copyfile(file_path, file_path.with_suffix(file_path.suffix + '.org'))
        tags.save()
    return updated


def main():
    logging.basicConfig(level='DEBUG')
    base_dir_path = Path('/path/to/music_file_dir')
    logger.info('searching sub directories')
    sub_dirs = [x for x in base_dir_path.iterdir() if x.is_dir()]
    logger.info(f'{len(sub_dirs)} sub directories found')
    for sub_dir in sub_dirs:
        logger.info(f'searching files in {str(sub_dir)}')
        files = list(sub_dir.glob('**/*.mp3'))
        if len(files) == 0:
            logger.info('no mp3 files found')
            continue
        files = sorted(files)  # ソートは必須ではない
        for file in files:
            parent_dir = file.parent
            if re.match(r'.*__MACOSX', str(parent_dir)):  # MACOS 用キャッシュは処理対象外
                continue
            try:
                if update_id3_tags(file):
                    logger.info(f'{str(file)} updated')
            except ID3NoHeaderError:  # ID3 が含まれない場合はログを残して次へ
                logger.exception('Error occured in check_id3_latin1()')
                continue


if __name__ == '__main__':
    main()