Skip to content

Load a Genre Profile

Loads a genre reference profile by name and returns the complete profile data as JSON: loudness targets, frequency balance offsets, stereo conventions, and the spatial processing notes. This is the same data compare_to_profile compares your mix against.

Parameters

Parameter Type Default Description
name string required Genre profile name, e.g. "pop", "hip-hop", "lofi". Case-insensitive. Use list_profiles to see all available names.

Example Output

$ load_profile pop

{ "genre": "pop", "description": "Modern pop: polished, radio-ready, vocal-forward, wide stereo image.", "loudness": { "lufs_range": [-10.0, -7.0], "crest_factor_range": [6.0, 10.0], "true_peak_max_dbtp": -1.0 }, "frequency": { "bands": { "31_hz": 1.0, "62_hz": 1.0, "125_hz": 1.0, "250_hz": 0.0, "500_hz": 0.0, "1000_hz": 1.0, "2000_hz": 1.0, "4000_hz": 2.0, "8000_hz": 2.0, "16000_hz": 1.0 } }, "stereo": { "width": "wide", "mono_below_hz": 100.0 }, "spatial": { "reverb_type": "plate", "reverb_amount": "moderate", "pre_delay_ms": "medium" }, "processing_notes": "Vocals are king. Everything serves the vocal. Clean low end, bright top end, wide stereo field. Heavy automation on vocal levels. Sidechain compression from kick to bass for clarity. Parallel compression for energy without squashing dynamics."

What the Numbers Mean

  • loudness — The target ranges for a genre: integrated loudness in LUFS (lufs_range), crest factor in dB (crest_factor_range), and the true-peak ceiling in dBTP (true_peak_max_dbtp).

  • frequency.bands — Target frequency balance as dB offsets from flat, one per octave band from 31 Hz to 16 kHz. Positive means that band sits above a flat response, negative means it sits below. Pop’s +2 dB at 4 kHz and 8 kHz is the classic presence lift.

  • stereo — width is the conventional stereo image for the genre, one of narrow, moderate, wide, or very_wide (ambient is the only profile using the last); mono_below_hz is where the low end is typically mono-compatible.

  • spatial — Reverb and delay conventions: reverb_type (“plate”, “hall”, “room”), reverb_amount, and pre_delay_ms.

  • processing_notes — Genre-specific mixing and mastering approach written for AI interpretation. This is how the assistant knows a genre’s rules of thumb, not just its numbers.

Profile Availability

Phantom ships nine built-in profiles: pop, rock, hip-hop, electronic, EDM, metal, rock-metal, lo-fi, and ambient. There is no built-in “country”, “jazz”, or “acoustic” profile.

  • Custom profiles — set PHANTOM_PROFILES_DIR to a directory of *.json profiles using the same schema. A custom profile with the same name as a built-in replaces it; set PHANTOM_PROFILE_MERGE to merge the custom file over the built-in instead.

  • Not found — loading a name with no matching profile fails with an error listing the available profiles.

Example Prompts

Read a profile

Load the hip-hop profile and show me its loudness target and processing notes

Decide between genres

Load the rock and rock-metal profiles — which one is a closer stylistic match for my track?

Pro tip

Profile names are case-insensitive and accept aliases: “hiphop” resolves to “hip-hop”, “lofi” to “lo-fi”, “rockmetal” to “rock-metal”.