image-video-optimizer 3.3.3 → 3.3.31

package/README.md

@@ -1,11 +1,14 @@
 # Image Video Optimizer
 
-A powerful CLI tool to optimize images and videos with configurable resize and compression settings.
+A powerful CLI tool to optimize images, videos, audio, and PDFs with configurable resize and compression settings.
 
 ## Features
 
 - **Image Optimization**: Resize and convert images to specified formats
 - **Video Optimization**: Resize videos and encode to specified formats
+- **Audio Optimization**: Convert and compress audio files to MP3
+- **PDF Compression**: Compress PDF files using Ghostscript
+- **Resume Support**: Track processed files and resume interrupted sessions
 - **Configurable Settings**: Use `.image-video-optimizer.conf` files for custom settings
 - **Smart Compression**: Only keeps optimized files if compression is effective (>1%)
 - **Recursive Search**: Finds all media files in subdirectories
@@ -32,7 +35,7 @@ image-video-optimizer /path/to/directory [options]
 ```
 
 - `<directory>`: Target directory to optimize (required)
-- `-d, --dry-run`: Show what would be processed without making changes
+- `-r, --reset`: Reset status file and start fresh
 - `-v, --verbose`: Enable verbose logging
 - `-V, --version`: Show version number
 - `-h, --help`: Show help
@@ -49,6 +52,12 @@ img_format=jpg              # Target format for image conversion
 # Video settings
 video_max_width=720         # Maximum width for videos (pixels)
 video_encode=h264           # Video encoding format
+
+# Audio settings
+audio_ext=mp3              # Audio extension for audio files
+
+# PDF settings
+pdf_compress=true           # Enable/disable PDF compression
 ```
 
 ### Default Configuration
@@ -58,6 +67,8 @@ If no configuration file is found, these defaults are used:
 - `img_format`: jpg
 - `video_max_width`: 720
 - `video_encode`: h264
+- `audio_ext`: mp3
+- `pdf_compress`: true
 
 ## Supported Formats
 
@@ -69,6 +80,14 @@ If no configuration file is found, these defaults are used:
 - Input: avi, mov, wmv, flv, webm, mkv, m4v, mp4
 - Output: mp4 (with configurable encoding)
 
+### Audio
+- Input: mp3, wav, flac, aac, ogg, m4a
+- Output: mp3 (configurable)
+
+### Documents
+- Input: pdf
+- Output: pdf (compressed)
+
 ## Processing Logic
 
 ### Image Processing
@@ -86,6 +105,24 @@ If no configuration file is found, these defaults are used:
 5. Converts to MP4 format
 6. Compares file sizes and keeps optimized version only if compression > 1%
 
+### Audio Processing
+1. Searches for audio files recursively
+2. Converts to target format (default: MP3)
+3. Applies aggressive compression (single channel, 16kHz, 32k bitrate)
+4. Replaces original with compressed version
+
+### PDF Processing
+1. Searches for PDF files recursively
+2. Uses Ghostscript to compress PDFs
+3. Falls back to copy if Ghostscript is not available
+4. Replaces original with compressed version
+
+### Resume Logic
+1. Creates `.image-video-optimizer-status.json` to track processed files
+2. Skips already processed files on subsequent runs
+3. Updates status file after each file is processed
+4. Use `--reset` to clear status and start fresh
+
 ## Examples
 
 ### Optimize a directory with default settings
@@ -93,9 +130,14 @@ If no configuration file is found, these defaults are used:
 image-video-optimizer ./photos
 ```
 
-### Dry run to see what would be processed
+### Reset status and start fresh
+```bash
+image-video-optimizer ./photos --reset
+```
+
+### Verbose output
 ```bash
-image-video-optimizer ./photos --dry-run
+image-video-optimizer ./photos --verbose
 ```
 
 ### Custom configuration
@@ -105,11 +147,14 @@ img_max_width=1920
 img_format=webp
 video_max_width=1080
 video_encode=h265
+audio_ext=mp3
+pdf_compress=true
 ```
 
 Then run:
 ```bash
-image-video-optimizer ./media
+image-video-optimizer . # and image-video-optimizer the same as it will proceed the current directory
+image-video-optimizer ./media/path/to/directory # will proceed the specified directory
 ```
 
 ## Dependencies
@@ -117,30 +162,29 @@ image-video-optimizer ./media
 - [sharp](https://sharp.pixelplumbing.com/) - Image processing
 - [fluent-ffmpeg](https://github.com/fluent-ffmpeg/node-fluent-ffmpeg) - Video processing
 - [commander](https://github.com/tj/commander.js) - CLI framework
-- [chalk](https://github.com/chalk/chalk) - Terminal styling
 
 ## System Requirements
 
 - Node.js >= 14.0.0
-- FFmpeg (for video processing)
+- FFmpeg (for video and audio processing)
+- Ghostscript (for PDF compression, optional)
 
-### Installing FFmpeg
-
-**Ubuntu/Debian:**
+### Installing Requirements
+**Arch/GopiOS:**
 ```bash
 sudo pacman -Syu ffmpeg x264
+```
 
-sudo apt update && sudo apt install ffmpeg
+**Ubuntu/Debian:**
+```bash
+sudo apt install ffmpeg ghostscript
 ```
 
 **macOS:**
 ```bash
-brew install ffmpeg
+brew install ffmpeg ghostscript
 ```
 
-**Windows:**
-Download from [ffmpeg.org](https://ffmpeg.org/download.html) and add to PATH
-
 ## License
 
 nirvána

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "image-video-optimizer",
-  "version": "3.3.3",
+  "version": "3.3.31",
   "description": "CLI tool to optimize and compress images and videos with configurable settings",
   "main": "src/index.js",
   "bin": {