mikkeli/uj-mastering-master
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updating CLAUDE settings to match initial rules

Browse Source
This commit is contained in:
Mikkeli Matlock
2025-08-22 00:36:33 +09:00
parent 9e65e721d4
commit fa844dfde1
1 changed files with 40 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+40 -36
View File
@@ -2,9 +2,9 @@
A custom mastering toolkit that provides metrics to evaluate audio masterings through visual analysis. A custom mastering toolkit that provides metrics to evaluate audio masterings through visual analysis.
## Current Implementation ## Current implementation
### Core Features ### Core features
- **Audio Analysis**: Uses librosa to analyze audio files (MP3/WAV/FLAC support) - **Audio Analysis**: Uses librosa to analyze audio files (MP3/WAV/FLAC support)
- **Power Visualization**: Generates colorized power magnitude graphs over time - **Power Visualization**: Generates colorized power magnitude graphs over time
- **Metadata Extraction**: Reads ID3 tags from MP3 files for better file identification - **Metadata Extraction**: Reads ID3 tags from MP3 files for better file identification
@@ -12,14 +12,14 @@ A custom mastering toolkit that provides metrics to evaluate audio masterings th
- **Font Management**: Comprehensive CJK-compatible font system with user-provided font support - **Font Management**: Comprehensive CJK-compatible font system with user-provided font support
- **Threading & Logging**: Robust background processing with detailed logging system - **Threading & Logging**: Robust background processing with detailed logging system
### Technical Stack ### Technical stack
- **Audio Processing**: librosa, numpy - **Audio Processing**: librosa, numpy
- **Visualization**: matplotlib with custom colormaps and embedded Qt widgets - **Visualization**: matplotlib with custom colormaps and embedded Qt widgets
- **GUI Framework**: PyQt5 with modular widget architecture - **GUI Framework**: PyQt5 with modular widget architecture
- **Metadata**: mutagen for audio tag reading - **Metadata**: mutagen for audio tag reading
- **Font Support**: Custom font loading system with CJK fallback - **Font Support**: Custom font loading system with CJK fallback
### Key Components ### Key components
#### `main.py` #### `main.py`
- Complete GUI application with modular architecture - Complete GUI application with modular architecture
@@ -47,79 +47,83 @@ A custom mastering toolkit that provides metrics to evaluate audio masterings th
- `AudioFile` class with comprehensive metrics extraction - `AudioFile` class with comprehensive metrics extraction
- RMS power analysis and BPM detection - RMS power analysis and BPM detection
### Current Analysis Features ### Current analysis features
- **RMS Power Analysis**: 10-second rolling window with 2-second hops - **RMS power analysis**: 10-second rolling window with 2-second hops
- **Adaptive Color Mapping**: Automatically adjusts scale based on detected headroom - **Adaptive colour mapping**: Automatically adjusts scale based on detected headroom
- High dynamic range: 0-0.6 scale for loud masters - High dynamic range: 0-0.6 scale for loud masters
- Conservative mastering: 0-0.3 scale for quiet masters - Conservative mastering: 0-0.3 scale for quiet masters
- **BPM Detection**: Automatic tempo analysis - **BPM detection**: Automatic tempo analysis
- **Metadata Display**: Artist and title from audio tags - **Metadata display**: Artist and title from audio tags
- **Real-time Visualization**: Embedded matplotlib plots with font-aware rendering - **Real-time visualization**: Embedded matplotlib plots with font-aware rendering
### GUI Features ### GUI features
- **File Management**: Drag-and-drop and file dialog for audio selection - **File management**: Drag-and-drop and file dialog for audio selection
- **Font Control**: Unified font selector with size control and plot regeneration - **Font control**: Unified font selector with size control and plot regeneration
- **Analysis Display**: Real-time visualization with metadata panels - **Analysis display**: Real-time visualization with metadata panels
- **Modular Architecture**: Self-contained widgets for easy layout management - **Modular architecture**: Self-contained widgets for easy layout management
## Future Development Plans ## Future development plans
### Short-term (Urgent) ### Short-term (urgent)
1. **Plot Control Widget Cluster** 1. **Plot control widget cluster**
- Move 'Refresh Plot' into dedicated plot/graph widget cluster - Move 'Refresh Plot' into dedicated plot/graph widget cluster
- Add metric selection widget (choose which analysis to display) - Add metric selection widget (choose which analysis to display)
- Implement plot style controller (colormap, line vs bar, etc.) - Implement plot style controller (colormap, line vs bar, etc.)
- Prepare foundation for mastering comparison features - Prepare foundation for mastering comparison features
### Short-term (Not Urgent) ### Short-term (not urgent)
1. **Enhanced Metrics** 1. **Enhanced metrics**
- LUFS loudness measurement implementation - LUFS loudness measurement implementation
- Dynamic range measurement (DR meter) - Dynamic range measurement (DR meter)
- Peak-to-average ratio analysis - Peak-to-average ratio analysis
- Frequency spectrum analysis - Frequency spectrum analysis
2. **Interactive Plot Features** 2. **Interactive plot features**
- GUI-controllable plotting styles (colormap, visualization type) - GUI-controllable plotting styles (colormap, visualization type)
- Select axis ranges on the fly with automatic graph updates - Select axis ranges on the fly with automatic graph updates
- Zoom/pan controls for detailed analysis - Zoom/pan controls for detailed analysis
- Export analysis results to CSV/JSON - Export analysis results to CSV/JSON
3. **Advanced GUI Controls** 3. **Advanced GUI controls**
- Plot style customization interface - Plot style customization interface
- Real-time axis range selection - Real-time axis range selection (zooming in/out)
- Interactive plot manipulation tools - Interactive plot manipulation tools
### Mid-Long term (Not Urgent) 4. **Better looking UI**
1. **Audio Comparison System** - Graphical loading bar
- Graphical logging text box
### Mid-to-long-term (very not urgent)
1. **Audio comparison system**
- Reference vs. comparee audio file analysis - Reference vs. comparee audio file analysis
- Side-by-side track comparison interface - Side-by-side track comparison interface
- A/B testing for mastering versions - A/B testing for mastering versions
- Overlay visualization for comparative analysis - Overlay visualization for comparative analysis
2. **Distribution & Deployment** 2. **Distribution & deployment**
- Self-contained executable releases - Self-contained executable releases
- Cross-platform packaging - Cross-platform packaging
- Installer creation and distribution - Installer creation and distribution
### Future Vision ### Future vision
1. **Advanced Analysis Tools** 1. **Advanced analysis tools**
- Spectral centroid and bandwidth analysis - Spectral centroid and bandwidth analysis
- Stereo width measurements - Stereo width measurements
- Transient detection and analysis - Transient detection and analysis
- Harmonic distortion detection - Harmonic distortion detection
2. **Professional Features** 2. **Professional features**
- EBU R128 compliance checking - EBU R128 compliance checking
- Custom target curves - Custom target curves
- Professional reporting formats - Professional reporting formats
- Multi-format export capabilities - Multi-format export capabilities
3. **VST Plugin Development** 3. **VST plugin development**
- Real-time analysis during mixing/mastering - Real-time analysis during mixing/mastering
- Integration with DAWs - Integration with DAWs
- Live feedback during production - Live feedback during production
## Development Notes ## Development notes
### Dependencies ### Dependencies
- librosa: Audio analysis and feature extraction - librosa: Audio analysis and feature extraction
@@ -128,13 +132,13 @@ A custom mastering toolkit that provides metrics to evaluate audio masterings th
- mutagen: Audio metadata extraction - mutagen: Audio metadata extraction
- PyQt5: GUI framework - PyQt5: GUI framework
### Architecture Considerations ### Architecture considerations
- Current code mixes analysis and visualization - consider separation - Current code mixes analysis and visualization - consider separation
- File path handling needs improvement for cross-platform compatibility - File path handling needs improvement for cross-platform compatibility
- Error handling should be enhanced for production use - Error handling should be enhanced for production use
- Consider moving from PyQt5 to PyQt6 or PySide for better licensing - Consider moving from PyQt5 to PyQt6 or PySide for better licensing
### Testing Requirements ### Testing requirements
- Unit tests for audio analysis functions - Unit tests for audio analysis functions
- GUI component testing - GUI component testing
- File format compatibility testing - File format compatibility testing
@@ -142,18 +146,18 @@ A custom mastering toolkit that provides metrics to evaluate audio masterings th
## Usage ## Usage
### Current Usage ### Current usage
1. Run `python main.py` to launch the GUI application 1. Run `python main.py` to launch the GUI application
2. Use "Open Audio File..." button or drag-and-drop audio files for analysis 2. Use "Open Audio File..." button or drag-and-drop audio files for analysis
3. Adjust font settings using the Font Settings panel 3. Adjust font settings using the Font Settings panel
4. View real-time analysis results with embedded matplotlib plots 4. View real-time analysis results with embedded matplotlib plots
5. Select different analyzed files from the file list to compare results 5. Select different analyzed files from the file list to compare results
### Legacy Usage (Batch Mode) ### Legacy usage (batch Mode)
1. Add audio file paths to `files.txt` 1. Add audio file paths to `files.txt`
2. Run `python master_core.py` for batch analysis 2. Run `python master_core.py` for batch analysis
### Planned Usage Enhancements ### Planned usage enhancements
1. Interactive plot manipulation and style customization 1. Interactive plot manipulation and style customization
2. LUFS and advanced metric analysis 2. LUFS and advanced metric analysis
3. Audio file comparison features 3. Audio file comparison features