pmomusic/pmosource/README.md

pmosource

Common traits and types for PMOMusic sources.

Overview

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