README.md update

Author: paranoik1

README.md

@@ -15,7 +15,7 @@
 - 🛠️ Простое расширение новыми движками
 - 📦 Легкая интеграция в проекты
 - 🚀 Быстрая установка через pip
-- 🖥️ TUI (Textual User Interface) с поиском, прослушиванием и скачиванием
+- 🖥️ TUI (Terminal User Interface) с поиском, прослушиванием и скачиванием
 
 ---
 
@@ -46,12 +46,52 @@ msoc --tui
 python -m msoc --tui
 ```
 
+![alt text](image.png)
+
 TUI позволяет:
 - Искать треки по запросу
 - Прослушивать треки через ffmpeg (автоопределение PulseAudio/PipeWire)
 - Скачивать треки в текущую директорию
 - Видеть продолжительность треков
 
+> **Требование:** для работы TUI нужен ffmpeg в системе. При разработке
+> использовался `ffmpeg version n8.1.2`.
+
+### Эксперименты с оптимизацией
+
+В процессе разработки я экспериментировал с тем, как уменьшить количество
+сетевых запросов при проигрывании. Для тестов использовал
+[wondershaper](https://github.com/magnific0/wondershaper) — под Linuх он
+позволяет искусственно резать пропускную способность интерфейса, что удобно
+симулировать слабый интернет.
+
+Сейчас воспроизведение выглядит так:
+
+1. **ffmpeg скачивает трек во временную папку** (`-c:a copy` — без
+   перекодирования, просто сохраняет поток как есть).
+2. **Второй ffmpeg читает уже локальный файл**, декодирует в PCM
+   и отправляет в sounddevice.
+
+Загрузка и воспроизведение работают в разных потоках, поэтому не блокируют
+друг друга — можно начать слушать, не дожидаясь полной загрузки.
+
+Что хочется доделать: сейчас длительность и другие метаданные вытаскиваются
+отдельным вызовом ffprobe (по сути — ещё один запрос к недокачанному файлу).
+Планирую парсить `stderr` первого ffmpeg, чтобы получать ту же информацию
+без лишних походов в сеть.
+
+#### Как работает скачивание
+
+Когда пользователь нажимает Download, логика такая:
+
+- **Если трек уже загружен во временную папку** (докачался во время
+  прослушивания) — просто копируем оттуда в текущую директорию.
+  Никаких новых запросов в сеть.
+- **Если трек прямо сейчас играет, но ещё не докачался** — ждём, пока
+  фоновый ffmpeg закончит, и копируем. Пользователь видит `...` на кнопке.
+- **Если трек не играл и не загружался** — ffmpeg скачивает напрямую
+  (`-c:a copy`), сохраняя в текущую папку.
+
 ## 💻 В консоле
 
 Можно протестировать пакет обычным скриптом:
@@ -89,21 +129,21 @@ asyncio.run(main())
 
 Класс `Sound` содержит информацию о песне.
 
-Атрибуты:
-
-- `title (str)`: Название песни.
-- `url (str | None)`: Ссылка на скачивание песни. Может быть None, если ссылка недоступна (Необязательный атрибут).
-- `artist (str | None)`: Исполнитель песни. Может быть None, если информация об исполнителе недоступна (Необязательный атрибут).
-- `meta (dict[str, Any])`: Дополнительные метаданные трека.
-- `_engine (str | None)`: Название движка, нашедшего трек (заполняется автоматически).
+| Поле | Тип | Описание |
+|------|-----|----------|
+| `title` | `str` | Название песни |
+| `url` | `str` | Ссылка на скачивание |
+| `artist` | `str \| None` | Исполнитель (опционально) |
+| `meta` | `dict[str, Any]` | Дополнительные метаданные (по умолчанию `{}`) |
+| `_engine` | `str \| None` | Движок-источник, заполняется автоматически |
 
 
 ## 🔌 Реализованные движки поиска
 
 В настоящее время библиотека MSOC поддерживает следующие движки поиска:
 
 - zaycev_net: Поиск на сайте [zaycev.net](https://zaycev.net)
-- hitmo: Поиск на сайте [rus.hitmotop.com](https://rus.hitmotop.com) - реализован на основе [данного кода](https://github.com/Ushiiro82/MelodyHub/blob/master/parsing/hitmo_parser.py)
+- hitmo: Поиск на сайте [rus.hitmotop.com](https://rus.hitmotop.com) - реализован на основе [данного кода от Ushiiro82](https://github.com/Ushiiro82/MelodyHub/blob/master/parsing/hitmo_parser.py)
 - muzbomb: Поиск на сайте [muzbomb.net](https://muzbomb.net/) - создан [takilow](https://github.com/takilow)
 - trekson: Поиск на сайте [trekson.net](https://trekson.net/) - обновлённый парсер
 

image.png

@@ -497,6 +497,7 @@ def on_unmount(self, event):
 if __name__ == "__main__":
     logging.basicConfig(
         filename="journal_app.log",
+        filemode="w",
         level=logging.DEBUG,
         format="[%(asctime)s - %(name)s] - %(levelname)s - %(message)s",
     )