Add optional 360° video processing dependencies
- Add video-360 extra for core 360° processing (py360convert, opencv, numpy, scipy) - Add spatial-audio extra for spatial audio processing (librosa, soundfile) - Add metadata-360 extra for enhanced metadata extraction (exifread) - Add video-360-full extra for complete 360° feature set - Update README with installation options and feature documentation - Maintain backward compatibility with existing basic installation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
parent
665fa1db4b
commit
9c0bd90299
52
README.md
52
README.md
@ -63,6 +63,17 @@
|
|||||||
- **uv** for lightning-fast dependency management
|
- **uv** for lightning-fast dependency management
|
||||||
- **ruff** for code quality and formatting
|
- **ruff** for code quality and formatting
|
||||||
|
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td colspan="2">
|
||||||
|
|
||||||
|
### 🌐 **360° Video Support** *(Optional)*
|
||||||
|
- **Spherical video detection** and metadata extraction
|
||||||
|
- **Projection conversions** (equirectangular, cubemap, stereographic)
|
||||||
|
- **360° thumbnail generation** with multiple viewing angles
|
||||||
|
- **Spatial audio processing** for immersive experiences
|
||||||
|
|
||||||
</td>
|
</td>
|
||||||
</tr>
|
</tr>
|
||||||
</table>
|
</table>
|
||||||
@ -74,11 +85,45 @@
|
|||||||
### Quick Install
|
### Quick Install
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Using uv (recommended - fastest!)
|
# Basic installation (standard video processing)
|
||||||
uv add video-processor
|
uv add video-processor
|
||||||
|
|
||||||
# Or with pip
|
# With 360° video support
|
||||||
|
uv add "video-processor[video-360]"
|
||||||
|
|
||||||
|
# With spatial audio processing
|
||||||
|
uv add "video-processor[spatial-audio]"
|
||||||
|
|
||||||
|
# Complete 360° feature set
|
||||||
|
uv add "video-processor[video-360-full]"
|
||||||
|
|
||||||
|
# Or using pip
|
||||||
pip install video-processor
|
pip install video-processor
|
||||||
|
pip install "video-processor[video-360-full]"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Optional Features
|
||||||
|
|
||||||
|
#### 🌐 360° Video Processing
|
||||||
|
For immersive video processing capabilities:
|
||||||
|
- **`video-360`**: Core 360° video processing (py360convert, opencv, numpy, scipy)
|
||||||
|
- **`spatial-audio`**: Spatial audio processing (librosa, soundfile)
|
||||||
|
- **`metadata-360`**: Enhanced 360° metadata extraction (exifread)
|
||||||
|
- **`video-360-full`**: Complete 360° package (includes all above)
|
||||||
|
|
||||||
|
#### 📦 Dependency Details
|
||||||
|
```bash
|
||||||
|
# Core 360° processing
|
||||||
|
uv add "video-processor[video-360]"
|
||||||
|
# Includes: py360convert, opencv-python, numpy, scipy
|
||||||
|
|
||||||
|
# Spatial audio support
|
||||||
|
uv add "video-processor[spatial-audio]"
|
||||||
|
# Includes: librosa, soundfile
|
||||||
|
|
||||||
|
# Complete 360° experience
|
||||||
|
uv add "video-processor[video-360-full]"
|
||||||
|
# Includes: All 360° dependencies + exifread
|
||||||
```
|
```
|
||||||
|
|
||||||
### Development Setup
|
### Development Setup
|
||||||
@ -90,6 +135,9 @@ cd video_processor
|
|||||||
# Install with all development dependencies
|
# Install with all development dependencies
|
||||||
uv sync --dev
|
uv sync --dev
|
||||||
|
|
||||||
|
# Install with dev + 360° features
|
||||||
|
uv sync --dev --extra video-360-full
|
||||||
|
|
||||||
# Verify installation
|
# Verify installation
|
||||||
uv run pytest
|
uv run pytest
|
||||||
```
|
```
|
||||||
|
@ -28,6 +28,30 @@ dev = [
|
|||||||
"pytest-cov>=4.0.0",
|
"pytest-cov>=4.0.0",
|
||||||
]
|
]
|
||||||
|
|
||||||
|
# Core 360° video processing
|
||||||
|
video-360 = [
|
||||||
|
"py360convert>=0.1.0", # 360° projection conversions
|
||||||
|
"opencv-python>=4.5.0", # Advanced image processing
|
||||||
|
"numpy>=1.21.0", # Mathematical operations
|
||||||
|
"scipy>=1.7.0", # Scientific computing for spherical geometry
|
||||||
|
]
|
||||||
|
|
||||||
|
# Spatial audio processing for 360° videos
|
||||||
|
spatial-audio = [
|
||||||
|
"librosa>=0.9.0", # Audio analysis and processing
|
||||||
|
"soundfile>=0.11.0", # Multi-channel audio I/O
|
||||||
|
]
|
||||||
|
|
||||||
|
# Enhanced metadata extraction for 360° videos
|
||||||
|
metadata-360 = [
|
||||||
|
"exifread>=3.0.0", # 360° metadata parsing
|
||||||
|
]
|
||||||
|
|
||||||
|
# Complete 360° video package
|
||||||
|
video-360-full = [
|
||||||
|
"video-processor[video-360,spatial-audio,metadata-360]"
|
||||||
|
]
|
||||||
|
|
||||||
[tool.hatch.build.targets.wheel]
|
[tool.hatch.build.targets.wheel]
|
||||||
packages = ["src/video_processor"]
|
packages = ["src/video_processor"]
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user