01 — интеграции · vaure pack

Один файл.
Один тап.
Ваша музыка в Vaure.

Vaure Pack — это файл .vau, который пользователь импортирует в приложение Vaure одним нажатием по ссылке. Внутри — треки с обложками и метаданными.

.vau · zip
https
один тап импорт
альбом / плейлист / библиотека

02 — путь от файлов до ссылки

Четыре шага.

Собрать ZIP

Треки + manifest.json в архив, переименовать в .vau.

Вшить теги

Название, артист, альбом, обложка — прямо в каждый аудиофайл.

Выложить по HTTPS

С Content-Length, по возможности с Range. Без интерактивной авторизации.

Собрать ссылку

Длинную с percent-encoded URL — или короткую, после регистрации у Vaure.

03 — анатомия .vau

Внутри — обычный ZIP.

my-album.vau
├── manifest.json
└── tracks/
    ├── 0F8A2C7E-….mp3
    └── 1B3D9F10-….m4a

Просто переименуйте .zip в .vau. В корне обязательно manifest.json. Аудиофайлы — по путям из манифеста. Сжатие любое, можно STORE без сжатия (аудио уже сжато). Лишние файлы игнорируются.

MIME-тип application/vnd.vaure.pack

04 — manifest.json

Сердце пака.

UTF-8 JSON в корне архива. Поля высокого уровня описывают пак, в tracks[] — список треков. Неизвестные ключи безопасно игнорируются.

createdAt — ISO-8601 с таймзоной, БЕЗ долей секунды.

id — канонический UUID (регистр не важен).

storedFileName — путь файла внутри ZIP, по соглашению tracks/<id>.<ext>.

05 — теги и обложки

Метаданные читаются из самого аудио.

При импорте Vaure берёт название, артиста, альбом и обложку из тегов файла (ID3, MP4 atoms, FLAC tags), а НЕ из манифеста. Поля title/artist/album в манифесте нужны только для окна выбора при импорте.

Отдельный файл cover.jpg в архиве

Не читается. Вшивайте обложку в теги каждого трека (ID3 APIC и аналоги).

✓

Метаданные внутри файла

ID3 для MP3, атомы для M4A, теги FLAC. Номер трека — TRCK в формате N/M.

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

MP3M4A (AAC/ALAC)FLACWAVAIFFCAF

OggVorbisOpus iOS не декодирует — не используйте.

06 — хостинг .vau

Файл должен доехать.

HTTPS с валидным сертификатом

Внутренний URL должен быть по https://.

Content-Length

Нужен для прогресса загрузки в приложении.

HTTP Range желательно

Accept-Ranges: bytes — устойчивее на нестабильной сети.

Опознаётся как пак

Любой из: расширение .vau, Content-Type: application/vnd.vaure.pack, либо Content-Disposition: attachment; filename="name.vau".

Без интерактивной авторизации

Если нужен контроль доступа — зашейте токен прямо в URL.

07 — ссылка для импорта

Соберите ссылку.

Вставьте полный HTTPS-адрес вашего .vau — мы percent-encoding'ом завернём его в импорт-ссылку Vaure. Длинная ссылка работает сразу, без согласования.

ваш URL до .vau

готовая ссылка

Хочешь короткую?

Короткая ссылка — это . вместо полного URL. Vaure знает базовый адрес вашего хоста и собирает полный путь сама. Чтобы получить идентификатор провайдера — напишите команде Vaure.

https://dl.vaure.app/i?url=1.aBcDeFgHiJkL Связаться с командой →

08 — чек-лист перед публикацией

Восемь пунктов.

Прогресс снизу — для самоконтроля. Ничего не отправляется.

manifest.json в корне архива, валидный JSON, все обязательные поля.
exportKind — одно из track / album / playlist / library.
createdAt — ISO-8601 с таймзоной, без долей секунды; id — валидный UUID.
Каждый storedFileName указывает на реально существующий файл в ZIP.
В каждый аудиофайл вшиты теги и обложка (а не только в манифест).
Аудио в поддерживаемом формате (MP3/M4A/FLAC/WAV/AIFF/CAF).
.vau отдаётся по HTTPS с Content-Length, опознаётся как пак.
Длинная ссылка собрана с percent-encoded url — или получен идентификатор провайдера.

0 / 8

09 — нужна помощь?

Напишите команде.

Регистрация провайдера для коротких ссылок, нестандартные форматы, интеграционные кейсы — всё это в @vaure_bot.

Открыть @vaure_bot ↗

Один файл.Один тап.Ваша музыка в Vaure.