菜单
ProjectM/MilkDrop preset engine inside the visualization window — preset loading, controls, modes, audio sensitivity, beat sensitivity, drag-suspend behavior. Use when editing the ProjectM wrapper, preset folder logic, or its menu.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Audio engine architecture, local/streaming pipelines, EQ, spectrum analysis, and playback flow. Use when working on audio playback, streaming, equalization, spectrum visualization, BPM detection, or ProjectM integration.
Flow network throughput window — live download/upload meter, interface selection, single-height center-stack docking, classic/modern window controllers, and rendering behavior.
Coordinate systems, scaling architecture, hit testing, skin sprite rendering, window layout, and Compact Mode for NullPlayer's UI. Use when working on window scaling, skin rendering, coordinate transforms, visual layout, compact/status-item windows, or playlist/marquee text rendering.
Index of NullPlayer's visualization systems. Use this to discover which sub-skill covers the specific visualizer you're working on (main window vis, spectrum window, album art, ProjectM/MilkDrop, Geiss, Tripex, Met Museum, vis_classic, Metal mode internals).
Modern skin engine, skin.json schema, element catalog, and custom skin creation. Use when creating or modifying modern skins, working on ModernSkin components, or adding UI elements to the modern system.
The PeppyMeter analog VU meter window — a skinnable needle/bar meter (port of project-owner/PeppyMeter) in classic + modern UI. Covers the meters.txt geometry, the CoreGraphics compositor (needle rotation + linear masks), the stereo-tap level model, meter selection/random, bundled GPL assets, and WindowManager integration. Use when modifying the PeppyMeter window, its renderer, meter templates, or level plumbing.
| name | projectm-milkdrop |
| description | ProjectM/MilkDrop preset engine inside the visualization window — preset loading, controls, modes, audio sensitivity, beat sensitivity, drag-suspend behavior. Use when editing the ProjectM wrapper, preset folder logic, or its menu. |
Renders classic MilkDrop presets using OpenGL. The visualization window has two implementations (classic/modern UI modes) both embedding VisualizationGLView for rendering. The same window hosts the ProjectM, Geiss, Tripex, and Met Museum engines, switchable from the right-click Visualization Engine submenu.
For sibling engines see geiss-port, tripex-port, met-museum-visualizer.
NullPlayer ships bundled presets. Custom presets go in:
~/Library/Application Support/NullPlayer/Presets/
Place .milk files there and use "Reload Presets" from the context menu.
Keyboard:
Context Menu:
| Mode | Behavior |
|---|---|
| Manual Only | Presets only change via user input (default) |
| Auto-Cycle | Advances to next preset sequentially at interval |
| Auto-Random | Jumps to random preset at interval |
Auto-switching modes are disabled by default for stability — some presets may glitch during transitions.
Cycle mode and interval are persistent user preferences:
projectM.cycleMode (off, cycle, random)projectM.cycleInterval (seconds, default 30)Amplitude of audio samples fed to the visualization engine:
| Preset | Gain |
|---|---|
| Low | 0.5× |
| Normal | 1.0× (default) |
| High | 1.5× |
| Intense | 2.0× |
| Max | 3.0× |
Persisted: projectMPCMGain (UserDefaults)
Persisted: projectMBeatSensitivity (UserDefaults)
.windowDragDidBegin / .windowDragDidEnd from WindowManager). This prevents WindowServer stalls on Apple Silicon caused by simultaneous OpenGL compositing and window repositioning. If adding window-movement code that runs outside a drag, do NOT rely on ProjectM being suspended — the suspend is drag-scoped only.Windows/ProjectM/ProjectMWindowController.swift — window controller (classic)Windows/ProjectM/ProjectMView.swift — container with classic chromeWindows/ModernProjectM/ModernProjectMWindowController.swift — window controller (modern)Windows/ModernProjectM/ModernProjectMView.swift — container with modern chromeVisualization/VisualizationGLView.swift — OpenGL rendering (shared)Visualization/ProjectMWrapper.swift — ProjectM library wrapperApp/ProjectMWindowProviding.swift — protocol abstracting classic/modernBlack screen: ProjectM requires OpenGL 4.1; check Console.app for projectM init errors; try reloading presets.
No presets loading: verify preset files exist in bundle or custom folder; check folder permissions.
Choppy animation: close other GPU-intensive apps; try a different preset.
Crashes during preset switching: fixed by disabling soft cuts (blended transitions); check Console.app for projectM errors.
Null texture pointer crash: fixed by removing direct OpenGL calls from reshape() — the render thread now handles all viewport updates safely.