Skip to content

README.md

Latest commit

 

History

History
85 lines (65 loc) · 4.88 KB

README.md

File metadata and controls

85 lines (65 loc) · 4.88 KB

Описание скрипта

Сгенерирован с помощью qwen3-coder:480b Вроде работает.

📋 Краткое описание

PowerShell скрипт для конвертации музыкальной библиотеки в формат MP3 с сохранением структуры папок и интеллектуальной обработкой файлов.

🎯 Основные функции

  • Конвертация без потерь → MP3: FLAC, WAV, AIFF, APE, WV, TTA, M4A, DSD, DSF в MP3 (320 кбит/с)
  • Копирование аудио с потерями: MP3, WMA, AAC, MP4, OGG, OPUS без изменений
  • Сохранение структуры: Полное сохранение иерархии папок и подпапок
  • Интеллектуальная проверка: Пропуск уже существующих файлов для возобновляемой обработки
  • Обработка специальных символов: Корректная работа с файлами, содержащими скобки, квадратные скобки и другие спецсимволы
  • Отладка: Опциональный вывод ffmpeg для диагностики

⚙️ Особенности

  • Безопасная обработка: Проверка существования файлов перед обработкой
  • Возобновляемая работа: Автоматический пропуск уже обработанных файлов
  • Сетевая совместимость: Работа с SMB сетевыми хранилищами
  • Подробная статистика: Отслеживание прогресса и результатов обработки
  • Обработка ошибок: Устойчивость к проблемным файлам и путям

📁 Поддерживаемые форматы

Конвертируются в MP3: .flac, .wav, .aiff, .aif, .ape, .wv, .tta, .m4a, .dsd, .dsf
Копируются без изменений: .mp3, .wma, .aac, .mp4, .ogg, .opus
Вспомогательные файлы: Обложки, тексты и другие файлы копируются как есть

🛠 Требования

  • Установленный FFmpeg в PATH
  • PowerShell 5.1+
  • Доступ к исходной и целевой директориям

🚀 Использование

  1. Настройте пути $SourcePath и $DestinationPath
  2. Установите $ShowFFmpegOutput = $true для отладки (опционально)
  3. Запустите скрипт как обычный PowerShell файл

Идеально подходит для создания резервных копий музыкальных библиотек и конвертации в универсальный формат MP3.

Neurotranslated to English:

Here is the English translation of the Russian text:

Script Description

Generated with qwen3-coder:480b
Seems to work fine.

📋 Brief Overview

PowerShell script for converting a music library to MP3 format while preserving folder structure and intelligently processing files.

🎯 Core Functions

  • Lossless → MP3 conversion: FLAC, WAV, AIFF, APE, WV, TTA, M4A, DSD, DSF to MP3 (320 kbps)
  • Direct copy of lossy audio: MP3, WMA, AAC, MP4, OGG, OPUS remain unchanged
  • Structure preservation: Full preservation of folder/subfolder hierarchy
  • Smart skip check: Automatically skips existing files for resumable processing
  • Special character handling: Correctly processes filenames with parentheses, brackets and other special symbols
  • Debugging: Optional ffmpeg output for diagnostics

⚙️ Features

  • Safe processing: Pre-checks file existence before handling
  • Resumable operation: Automatic skip of already processed files
  • Network compatibility: Works with SMB network storages
  • Detailed statistics: Tracks progress and processing results
  • Error resilience: Handles problematic files/paths robustly

📁 Supported Formats

Converted to MP3: .flac, .wav, .aiff, .aif, .ape, .wv, .tta, .m4a, .dsd, .dsf
Copied unchanged: .mp3, .wma, .aac, .mp4, .ogg, .opus
Auxiliary files: Cover art, lyrics and other files are copied as-is

🛠 Requirements

  • FFmpeg installed in PATH
  • PowerShell 5.1+
  • Access to source and destination directories

🚀 Usage

  1. Configure paths $SourcePath and $DestinationPath
  2. Set $ShowFFmpegOutput = $true for debugging (optional)
  3. Run the script as a standard PowerShell file

Perfect for creating music library backups and universal MP3 format conversion.