ncm2mp3 0.3.2

Decrypt Netease Cloud Music NCM files to their original audio format (MP3/FLAC/M4A). Rust CLI with tags, cover art, filename templates, per-song folder mode, parallel batching, watch mode, shell completions, and bilingual EN/ZH UI.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

//! Write NCM metadata and cover art into the decrypted output file using
//! lofty, which abstracts over ID3v2 / Vorbis Comment / MP4 atoms.

use std::path::Path;

use anyhow::{Context, Result};
use lofty::config::WriteOptions;
use lofty::file::{AudioFile, TaggedFileExt};
use lofty::picture::{MimeType, Picture, PictureType};
use lofty::tag::{Accessor, Tag};
use ncm_core::{Cover, CoverMime, NcmMetadata};

pub fn write_tags(path: &Path, metadata: &NcmMetadata, cover: Option<&Cover>) -> Result<()> {
    let mut tagged = lofty::read_from_path(path)
        .with_context(|| format!("failed to read {} for tagging", path.display()))?;

    let tag_type = tagged.primary_tag_type();
    if tagged.primary_tag().is_none() {
        tagged.insert_tag(Tag::new(tag_type));
    }
    let tag = tagged
        .primary_tag_mut()
        .expect("primary_tag just inserted above");

    if !metadata.title.is_empty() {
        tag.set_title(metadata.title.clone());
    }
    if !metadata.artists.is_empty() {
        tag.set_artist(metadata.artists_joined(" / "));
    }
    if !metadata.album.is_empty() {
        tag.set_album(metadata.album.clone());
    }

    if let Some(cover) = cover {
        if let Some(picture) = build_picture(cover) {
            tag.push_picture(picture);
        }
    }

    tagged
        .save_to_path(path, WriteOptions::default())
        .with_context(|| format!("failed to write tags to {}", path.display()))?;

    Ok(())
}

fn build_picture(cover: &Cover) -> Option<Picture> {
    let mime = match cover.mime {
        CoverMime::Jpeg => MimeType::Jpeg,
        CoverMime::Png => MimeType::Png,
        CoverMime::Unknown => return None,
    };

    // lofty 0.24 replaced `Picture::new_unchecked(...)` with a builder
    // initiated by `Picture::unchecked(data)`.
    Some(
        Picture::unchecked(cover.data.clone())
            .pic_type(PictureType::CoverFront)
            .mime_type(mime)
            .build(),
    )
}