Добавить README.md

README.md

@@ -0,0 +1,52 @@
+# m4a-to-mp3
+
+Простой Bash-скрипт для пакетной конвертации аудиофайлов из формата `.m4a` в `.mp3` с последующим удалением исходных файлов.
+
+## Требования
+
+- **Bash** (обычно предустановлен в большинстве Linux/macOS систем)
+- **ffmpeg** — должен быть установлен и доступен в `PATH`
+
+Убедитесь, что `ffmpeg` поддерживает кодек `libmp3lame` (обычно входит в стандартную сборку).
+
+## Установка
+
+Скопируйте скрипт в удобное место и сделайте его исполняемым:
+
+```bash
+chmod +x m4a-to-mp3.sh
+```
+
+## Использование
+
+```bash
+./m4a-to-mp3.sh [путь_к_директории]
+```
+
+- Если путь не указан, скрипт обработает текущую директорию (`.`).
+- Скрипт рекурсивно находит все файлы с расширением `.m4a` (регистронезависимо) и конвертирует их в `.mp3`.
+- После успешной конвертации исходный `.m4a` файл удаляется.
+- Все ошибки записываются во временный лог и выводятся в конце выполнения.
+
+### Примеры
+
+Конвертация файлов в текущей директории:
+```bash
+./m4a-to-mp3.sh
+```
+
+Конвертация файлов в указанной директории:
+```bash
+./m4a-to-mp3.sh ~/Music/audiobooks
+```
+
+## Особенности
+
+- Используется высокое качество MP3 (`-qscale:a 1`, эквивалентно ~256 kbps VBR).
+- Сохраняются метаданные (ID3v2.3).
+- Безопасная обработка имён файлов с пробелами и специальными символами (благодаря `-print0` и `read -d ''`).
+- Вывод подробного прогресса: каждый файл помечается как ✅ (успех) или ❌ (ошибка).
+
+## Лицензия
+
+Этот скрипт распространяется без каких-либо ограничений. Используйте на своё усмотрение.