From 39b238cb08ff1c73e40172119f59da24daab6430 Mon Sep 17 00:00:00 2001
From: drholy <dr.holyblack@gmail.com>
Date: Sun, 18 Jan 2026 23:46:12 +0700
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?=
 =?UTF-8?q?=D1=8C=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..98cac88
--- /dev/null
+++ b/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 ''`).
+- Вывод подробного прогресса: каждый файл помечается как ✅ (успех) или ❌ (ошибка).
+
+## Лицензия
+
+Этот скрипт распространяется без каких-либо ограничений. Используйте на своё усмотрение.
\ No newline at end of file