Add files via upload

2026-07-07 18:19:47 +05:00 · 2026-07-07 18:19:47 +05:00 · 6e7f0c1505
commit 6e7f0c1505
parent 07f2ed525b
37 changed files with 4084 additions and 20 deletions
--- a/app/README.md
+++ b/app/README.md
@ -0,0 +1,94 @@
+# nexdex.space
+
+локальный веб-инструмент — качает музыку/видео, конвертирует файлы, редактирует
+метаданные треков, форматирует py/lua скрипты. открывается сам в браузере на
+`localhost`, тёмная тема, гугл-минимализм.
+
+---
+
+## что внутри
+
+**загрузчик** — вставляешь ссылку (youtube / soundcloud / apple music / spotify /
+yandex music) или ищешь по названию (видно обложку+автора перед скачиванием),
+выбираешь формат — качает и вшивает обложку+теги. для spotify/apple music метаданные
+берутся с официальных публичных api, а само аудио ищется и качается с youtube —
+без взлома drm. история последних скачиваний сохраняется локально.
+
+**конвертер** — картинки (webp, png, jpg, ico и генерация иконок из любой картинки),
+pdf, pptx, аудио (flac/wav/mp3/m4a/ogg/opus/aac), видео (mp4/avi/mov/mkv/webm/gif).
+честно: pptx → картинка/pdf не поддерживается (нужен libreoffice/powerpoint для
+рендера слайдов — тяжёлая внешняя зависимость, спорит с идеей лёгкого инструмента).
+
+**метаданные** — редактор тегов для mp3/flac/wav/m4a/ogg/opus: название, исполнитель,
+альбом, год, номер трека, обложка. есть массовый режим — применить одного исполнителя/
+альбом/обложку сразу на несколько файлов.
+
+**скрипты** — форматирование `.py` (black) и `.lua` (stylua, качается сам при первом
+использовании), подсветка синтаксических ошибок.
+
+---
+
+## что нужно
+
+- python 3.10+
+- ffmpeg — уже лежит в `ffmpeg\`, ничего доп. качать не надо
+
+## установка
+
+```
+pip install -r requirements.txt
+```
+
+## запуск
+
+```
+python app.py
+```
+
+или просто дважды кликнуть `start.bat`. браузер откроется сам на
+`http://127.0.0.1:5000`. порт меняется через `PORT=8080 python app.py`.
+
+---
+
+## форматы загрузчика
+
+| # | формат | качество |
+|---|--------|----------|
+| 1 | MP3 | 320 / 256 / 192 / 128 kbps |
+| 2 | FLAC | lossless |
+| 3 | WAV | lossless |
+| 4 | M4A | best |
+| 5 | ALAC | lossless |
+| 6 | OGG | best |
+| 7 | OPUS | best |
+| 8 | MP4 | видео + аудио |
+
+---
+
+## структура
+
+```
+app.py                    — flask entrypoint, сам открывает браузер
+backend/
+  downloader.py            — detect_platform, download_track (youtube/spotify/apple/yandex/vk)
+  jobs.py                  — фоновые задачи скачивания + прогресс
+  search.py                — поиск по youtube/soundcloud/apple music
+  history.py                — история скачанных треков (data/history.json)
+  converter.py               — картинки/pdf/pptx/аудио/видео
+  metadata.py                 — чтение/запись тегов+обложки
+  scripts_format.py            — black + stylua
+templates/index.html
+static/css/style.css
+static/js/app.js
+ffmpeg/                    — ffmpeg.exe, ffprobe.exe
+bin/                       — сюда качается stylua.exe при первом форматировании lua
+data/history.json
+downloads/ uploads/ outputs/
+```
+
+---
+
+UDP: часть про поиск/скачивание работает через публичные api и youtube — если
+ссылка "не режимного" сервиса не отдаёт данные без логина, так и напишет в ошибке.
+pptx рендер слайдов — эксперимент на будущее, если приспичит тащить libreoffice.
+made by savsis with ♥