pmosource provides the foundational abstractions for different music sources in the PMOMusic ecosystem, such as Radio Paradise, Qobuz, and potentially others in the future.

Features

MusicSource trait: Common interface for all music sources
Default images: Standardized 300x300px WebP images embedded in binaries
Source identification: Consistent naming and ID scheme

Usage

Implementing the trait

use pmosource::MusicSource;

const DEFAULT_IMAGE: &[u8] = include_bytes!("../assets/default.webp");

#[derive(Debug)]
pub struct MyMusicSource;

impl MusicSource for MyMusicSource {
    fn name(&self) -> &str {
        "My Music Service"
    }

    fn id(&self) -> &str {
        "my-music-service"
    }

    fn default_image(&self) -> &[u8] {
        DEFAULT_IMAGE
    }
}

Using a music source

use pmosource::MusicSource;
use pmoparadise::RadioParadiseSource;
use pmoqobuz::QobuzSource;

let rp = RadioParadiseSource;
let qobuz = QobuzSource;

println!("Source: {} ({})", rp.name(), rp.id());
println!("Image size: {} bytes", rp.default_image().len());

Image Format

All default images should be:

Format: WebP
Dimensions: 300x300 pixels (square)
Quality: 85 (good balance between size and quality)
Location: <crate>/assets/default.webp

Converting images

Use the provided Python script or similar tool:

from PIL import Image

def convert_to_webp(input_path, output_path, size=300):
    img = Image.open(input_path)

    # Convert to RGB if necessary
    if img.mode not in ('RGB', 'RGBA'):
        img = img.convert('RGB')

    # Make it square (center crop)
    width, height = img.size
    if width != height:
        min_dim = min(width, height)
        left = (width - min_dim) // 2
        top = (height - min_dim) // 2
        right = left + min_dim
        bottom = top + min_dim
        img = img.crop((left, top, right, bottom))

    # Resize to target size
    img = img.resize((size, size), Image.Resampling.LANCZOS)

    # Save as WebP
    img.save(output_path, 'WEBP', quality=85, method=6)

Current Implementations

pmoparadise: Radio Paradise
pmoqobuz: Qobuz

Future Enhancements

The MusicSource trait can be extended with additional methods such as:

Authentication status
Available quality levels
Streaming capabilities
Search functionality
Playlist management
And more...

License

MIT OR Apache-2.0