Skip to content

Latest commit

 

History

38 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ᯓ𝄞LIPS⋆by⋆AVIIˎˊ˗ ⓒ 2026

Lyrics & Instrumentation Prompt Synthesizer — веб-застосунок для створення професійних промптів для AI-музичних генераторів (Suno та ін.) з допомогою Claude Sonnet 4.5.

AVII = Artificial + Vitaliy + Iryna Intelligence

Netlify Status


🌐 Живі версії

Платформа URL
GitHub Pages https://vizarce.github.io/lips-by-avii/
Netlify https://lips-by-avii.netlify.app/

✦ Що це таке

LIPS by AVII генерує два типи промптів:

  • Lyrics-Prompt — структурований текст-підказка для пісенної лірики (≤ 5000 знаків)
  • Style-Prompt — технічний опис стилю, продакшну та звуку (≤ 200 знаків)

Додатково AI може написати лірику з нуля або доопрацювати вашу.


🆕 Що нового у v5.6.3

  • 🚫 Без markdown в AI-виводі**, ##, ---, backticks заборонені у lyrics-prompt і style-prompt; тільки plain text
  • 🔊 Bass architecture — non-negotiable — всі 5 шарів (L1–L5) завжди повні, ніколи не скорочуються; AI стискає narrative-секції (1-3) першими якщо промпт завеликий
  • 🔒 Feature freeze — фінальна приватна версія перед SaaS-розробкою (VIZARCE)
Попередні зміни (v5.6.0–v5.6.2)
  • 🌴 Dancehall — новий жанровий розділ: Dancehall, Dancehall Synthwave ✦ (dembow × 80s synths), Dancehall Electronic, Moombahton
  • 🌍 Нові жанри — UK Garage, Dub Techno, Space Disco, Psybient, Nu Disco, Electro Swing, Vaporwave, Witch House, Cyberpunk Electronic
  • 🕰️ Era Selector — 70s → 2020s + Modern Vintage, додає production-текстуру епохи в AI style-prompt
  • 🎛️ Genre Combiner — комбінує до 2 жанрів у єдиний рядок для Suno
  • 📝 Новий MT-формат лірики — один блок на секцію [vocal vocals|Bass Lx|instruments,SFX|bars], формула Post-Chorus, валідовані типи Drop
  • 🎙️ Артистичний style-prompt — наративний стандарт, вокал першим, фіксований BASS 5-Layer(L) polymorphic формат
  • ⏱️ AbortController timeout (55s) — захист від "зависання" AI-запитів
  • 🎙️ 5-Parameter Vocal Builder — Register + Texture + Style + Delivery + Effects, мульти-вибір до 2 опцій на групу, 8 пресетів одним кліком
  • 🧬 Vocal DNA / Sound DNA — розділені: Vocal DNA = характеристики голосу, Sound DNA = текстура продакшну; кнопка ⊕ Комбінувати з 5-param
  • 🔢 Bass Budget — контекстна таблиця по типу секції
  • 🗄️ Song Vault — JSON-експорт/імпорт пісень, повна структурована схема v1.0, ☁️ Supabase Sync
  • 🔢 Лічильник тегів у Style-prompt (зелений 4-7 / жовтий 8-10 / червоний >10)
  • ⚡ Extend Protocol — підказка для розширення треків у Suno
  • 🎤 Artist DNA — 32+32 артисти (Vocal/Sound) у 5 табах з повними описами
  • 🎼 Style Formula Builder — 33 жанрові пресети
  • 🚫 Negative Prompting — 47 тегів у 3 групах
  • 🏆 TIER_RULES — у всіх AI-функціях, забороняє placebo-теги
  • v5.6.2: заголовок anthropic-dangerous-direct-browser-access: true для GitHub Pages CORS
  • v5.6.1: GitHub Pages використовує прямий API-виклик (proxy тільки на Netlify)

🎛️ Як це працює — 4-кроковий візард

Крок 1 — Інпут (Концепція)

  • Назва пісні
  • Концепція, настрій, ідея (AI розширить автоматично)
  • Режим лірики: своя / AI пише з нуля / обидва варіанти
  • Мова лірики: English / Українська / Білінгвальна / Spanish / Français
  • Власна лірика (необов'язково — AI оформить у формат Suno з тегами)
  • Рима: точна / баланс / зміст пріоритет
  • Жанр та піджанр
  • 🕰️ Era Selector — епоха продакшну (70s-2020s, Modern Vintage) додає текстуру в style-prompt
  • 🎛️ Genre Combiner — комбінує до 2 жанрів у єдиний рядок (макс. 2 для Suno)
  • BPM (від → до, або пресет)
  • Тональність
  • Тип і стиль вокалу
  • 🎙️ 5-Parameter Vocal Builder — Register / Texture / Style / Delivery / Effects з Tier 1/2/3 індикаторами та 8 пресетами одним кліком

Крок 2 — Жанр і Структура

  • AI-аналіз жанру: опис, темп, продакшн, вокальні особливості
  • AI-рекомендації для вибраного стилю
  • Структура пісні з drag-and-drop секціями
  • Автоматичне призначення тегів по жанру
  • AI-генерація тегів секцій (кнопка ✦ AI теги)

Крок 3 — Теги

Вибір тегів з хмар по категоріях: настрій, інструменти, продакшн (90+ тегів у 11 секціях), вокал, SFX. Також: 5-Layer Polymorphic Bass — налаштування бас-структури (L1–L5) з іменованими пресетами. Negative Prompting — 47 тегів що виключаються з промпту (3 групи). Style Formula Builder — 25 жанрових формул для швидкого налаштування стилю.

Крок 4 — Генерація

  • AI формує обидва промпти (вокал — першим у style-prompt, за новим стандартом)
  • Лічильники знаків з кольоровим індикатором (зелений / жовтий / червоний)
  • Лічильник тегів у Style-prompt (зелений 4-7 / жовтий 8-10 / червоний >10)
  • Кнопка Копіювати для кожного блоку
  • Кнопки: Регенерувати / Уточнити
  • 💾 Зберегти у Vault — зберігає пісню в Song Vault (+ авто-синхронізація з Supabase)
  • ↓ HTML — завантажує автономний HTML-файл з обома промптами
  • ↓ JSON — експортує поточну пісню у структурований .json файл
  • ⚡ Extend Protocol — підказка, як коректно розширювати трек у Suno

🗄️ Song Vault

Натисніть кнопку 🗄️ Song Vault у шапці застосунку, щоб:

  • Переглянути всі збережені пісні
  • Завантажити промпти збереженої пісні назад у Step 4
  • Зберегти пісню як HTML (↓ HTML) або структурований JSON (↓ JSON)
  • 📂 Імпорт JSON — завантажити .json файл пісні, переглянути у модальному вікні (мета, lyrics, style, структура) і зберегти у Vault або одразу перегенерувати (prefillFromJson())
  • ☁️ Sync — підтягнути пісні з Supabase у локальний Vault
  • Видалити окрему пісню або очистити весь Vault

🌐 Двомовний інтерфейс

У правому верхньому куті є перемикач UA | EN — натисніть щоб переключити мову інтерфейсу між:

  • UA — українська (за замовчуванням)
  • EN — English

Налаштування мови зберігається в localStorage.


🎵 Жанри та стилі

House

Варіант Опис
Vocal Melodic House Вокальний мелодійний хаус
Vocal House / Nu Disco / Lo-Fi Мікс вокального хаусу, ну-діско та ло-фай
Deep House / Lo-Fi / Late Night Глибокий хаус з ло-фай атмосферою
Bass House Бас-орієнтований хаус
Slap House Slap House

Electronic

Варіант Опис
EDM Загальна електронна танцювальна музика
Deep House / Melodic Techno Глибокий хаус з мелодійним техно
Dreamy Synthwave / Chamber Pop Атмосферний синтвейв і камерний поп
New Wave Нью-вейв
Acid Reggaeton × Electro-Pop Кислотний регетон з електропопом
Melodic Reggaeton / Pop Мелодійний регетон

Pop / Indie

Варіант Опис
Indie-Pop / Alt Indie-Pop Інді-поп та альтернативний інді-поп
Modern Pop Сучасний поп
Female / Male Confessional Indie ✦ Жіночий/чоловічий відвертий інді

Chill / Lo-Fi

Варіант Опис
Chill / Lo-Fi Спокійна ло-фай музика
Electro-Orchestral / Neo-Classical Електронно-оркестровий / нео-класичний

Soul / Hip-Hop

Варіант Опис
R&B / Soul Ар-ен-бі та соул
Hip-Hop / Rap Хіп-хоп та реп
Trap Треп
Funk / Neo-Soul Фанк та нео-соул

Jazz / Rock

Варіант Опис
Jazz Джаз
Rock Рок
Metal Метал

World / Ambient

Варіант Опис
Ethno / Folk Етно та фолк
City Pop / J-Pop Сіті-поп та j-pop
Ambient Ембієнт
Phonk Фонк
UK Garage 2-step, soulful, 130 BPM
Dub Techno Атмосферний, насичений ехо
Space Disco Космічний, грувовий, 120 BPM
Psybient Психоделічний ембієнт, 90–110 BPM
Nu Disco Ретро-діско × сучасна електроніка
Electro Swing Джаз × електроніка, 120–130 BPM
Vaporwave Ностальгійний, сповільнений, lo-fi
Witch House Темний, окультний, сповільнений, атмосферний
Cyberpunk Electronic Темний, індустріальний, футуристичний

🌴 Dancehall

Варіант Опис
Dancehall Ямайський, ритм dembow
Dancehall Synthwave ✦ Dembow × синти 80-х, 95–115 BPM
Dancehall Electronic Цифровий dembow, глянцевий мікс
Moombahton Dancehall × House, 108 BPM

⟨Z⟩ Zifferblatt (стилізовані по країнах)

Код Опис
FR ①②③ French Touch, Nu-Disco Deep House, Deep Trip-hop House
ES ①②③ Trip-hop House, Flamenco Electronic, Iberian Cinematic
DE ①②③④ Trip-hop House, Berlin Dark House, Cabaret Electronic, Krautrock
IT ①②③④ Trip-hop House, Italian Cinematic, Italo House Deep, Mediterranean Deep

Також підтримується ввід жанру вручну.


⏱️ BPM пресети

BPM Стиль
70 Slow Ballad
80 Soul
85 Lo-Fi / Jazz
88 Boom Bap
90 Hip-Hop
92 Reggaeton
95 R&B
98 Indie-Pop
105 Chill House
108 Trap
110 Deep House
115 Nu Disco
118 Vocal House
120 House
124 Tech House
128 EDM
138 DnB
140 Dubstep
174 Hardstyle

🎭 Теги настрою

romantic melancholic dark energetic atmospheric passionate warm playful ethereal bittersweet introspective hypnotic uplifting mysterious epic calm dreamy soulful haunting triumphant sensual nostalgic euphoric tender raw intimate futuristic cinematic tense lonely


🎹 Інструменти

piano saxophone acoustic guitar electric guitar strings synthesizer bass guitar drums brass choir Rhodes flute cello trumpet harp organ vibraphone accordion marimba sitar Moog synthesizer mellotron theremin Wurlitzer clavinet contrabass bongo drums pan flute duduk


🎚️ Продакшн-теги

analog lo-fi layered sidechain wide stereo minimal reverb heavy distorted warm mix punchy cinematic vintage crisp atmospheric progressive build trap production orchestral compressed dry vocal tape saturation frequency modulation glitch processing spatial audio lo-fi drums parallel compression vinyl mastering hard clipping


🎤 Вокальні характеристики

raspy breathy falsetto spoken word whispered vibrato gospel runs ad-libs harmonies baritone soprano soulful confessional autotune call-and-response powerhouse growls layered vocals intimate delivery scatting


⚡ SFX та спецефекти

vinyl crackle tape hiss terminal boot-up binary whoosh digital glitch vocal chops UI ping server hum modem hiss rain ambience reverse reverb sub rumble bass impact orchestral riser crash cymbal spring birdsong 808 sub white noise sweep matrix rain hard drive pulse error alert FX keyboard typing door creak crowd cheering heartbeat pulse thunder crack wind howl tape rewind needle drop


🏗️ Структури пісні по жанру

Жанр Структура
House / EDM / Pop Intro → Hook → Verse → Pre-Chorus → Chorus → Verse 2 → Chorus 2 → Drop → Bridge → Chorus Finale → Outro
R&B / Soul Intro → Hook 1 → Verse 1 → Pre-Chorus 1 → Chorus 1 → Hook 2 → Verse 2 → Chorus 2 → Bridge → Chorus Finale → Outro
Hip-Hop / Trap / Rap Intro → Rap Verse → Hook 1 → Rap Verse → Hook 2 → Bridge → Hook 3 → Outro
Jazz Intro → Hook 1 → Verse 1 → Solo Section → Hook 2 → Bridge → Outro
Rock / Metal Intro → Verse 1 → Pre-Chorus 1 → Chorus 1 → Verse 2 → Chorus 2 → Bridge → Guitar Solo → Chorus Finale → Outro
Indie / Confessional Intro → Verse 1 → Chorus 1 → Verse 2 → Chorus 2 → Bridge → Chorus Finale → Outro 1 → Outro 2
Folk / Ethno Intro → Verse 1 → Chorus 1 → Instrumental Transition → Verse 2 → Chorus 2 → Bridge → Chorus Finale → Outro
Ambient Intro → Build-up 1 → Hook 1 → Verse 1 → Drop 1 → Chorus 1 → Bridge → Chorus Finale → Outro 1 → Outro 2

Структуру можна редагувати вручну: додавати, видаляти та перетягувати секції.


🔊 5-Layer Polymorphic Bass

Система налаштування бас-структури з п'ятьма шарами:

Шар Роль
L1 Sub-bass floor
L2 Mid groove
L3 High stab
L4 Extra wave / overtone
L5 Cosmic / atmospheric layer

Режими: ✦ Повний (5 шарів) / Повний (3 шари) / Помірний (2 шари) / Мінімальний / Без басів

Іменовані пресети: ∞ IE Cosmic / Stellar / Orbital, Zifferblatt UA ①②, FR/ES/DE/IT варіанти.

Для жанрів без домінантного басу (Ambient, Folk, Jazz) застосовується автоматичне попередження.


🤖 AI-інтеграція

  • Модель: Claude Sonnet 4.5 (claude-sonnet-4-5-20250929) від Anthropic
  • API ключ: вводиться вручну у верхній панелі, зберігається в localStorage
  • Що робить AI:
    • Аналізує жанр і дає рекомендації
    • Генерує теги для секцій пісні
    • Пише лірику з нуля або доопрацьовує вашу
    • Формує Lyrics-Prompt і Style-Prompt

Архітектура запитів

На Netlify запити йдуть через серверну функцію-проксі (вирішує CORS):

Browser → /.netlify/functions/proxy → api.anthropic.com/v1/messages

На GitHub Pages і локально — прямий виклик з заголовком anthropic-dangerous-direct-browser-access: true:

Browser → api.anthropic.com/v1/messages

Перемикання відбувається автоматично: isDeployed перевіряє лише netlify.app.


💾 Сесії та зберігання

  • Зберегти сесію 💾 — зберігає всі налаштування в localStorage
  • Завантажити сесію 📂 — відновлює попередній стан
  • 🗄️ Song Vault — постійне сховище готових промптів (localStorage + Netlify Storage), з опційною синхронізацією через Supabase
  • JSON-експорт/імпорт — повна структурована схема пісні (schemaVersion: "1.0") для резервного копіювання та перенесення між пристроями
  • Автозбереження при введенні

🛠️ Технічний стек

  • Чистий HTML / CSS / JavaScript — без фреймворків і бандлерів
  • Шрифти: IBM Plex Mono + Outfit (Google Fonts)
  • Netlify Serverless Functions (Node.js) — проксі для Anthropic API
  • GitHub → Netlify автодеплой при кожному git push

Структура репозиторію

lips-by-avii/
├── index.html                  # Весь застосунок (HTML + CSS + JS)
├── netlify.toml                # Конфігурація Netlify (publish dir, functions dir)
├── netlify/
│   └── functions/
│       └── proxy.js            # Serverless proxy → Anthropic API
├── CHANGELOG.md
├── .gitignore
├── README.md
└── LICENSE

📋 Журнал версій

Версія Що нового
v5.6.3 Заборона markdown в AI-виводі, bass priority (всі 5 шарів завжди), feature freeze
v5.6.2 Заголовок anthropic-dangerous-direct-browser-access для GitHub Pages CORS
v5.6.1 GitHub Pages → прямий API-виклик (proxy тільки на Netlify)
v5.6.0 Dancehall Synthwave, Era Selector, Genre Combiner, +9 жанрів, +8 Style Formula пресетів
v5.5.5 Timeout (AbortController 55s), артистичний style-prompt, новий MT-формат лірики
v5.5.4 Виправлення назви моделі (claude-sonnet-4-5-20250929)
v5.5.3 DNA-розділення (Vocal/Sound), ⊕ Комбінувати з 5-param, мульти-вибір вокалу, відновлена щільність директив
v5.5.2 Виправлення мета-відповідей style-prompt, дедуп Female/Male Vocal, контекстний Bass Budget
v5.5.1 Виправлення TDZ-помилки vocalDesc5
v5.5.0 Vocal-First standard, правило ()/[], лічильник тегів, Extend Protocol, +14 продакшн-тегів
v5.4.1 Кнопка ↓ JSON на Кроці 4 (exportCurrentSongJson)
v5.4.0 5-Parameter Vocal Builder, 8 пресетів, новий артистичний style-prompt, Bass Budget
v5.3.1 Supabase credentials для синхронізації Vault
v5.3.0 Song Vault: JSON-експорт/імпорт, Supabase sync, prefill для перегенерації
v5.2.0 Artist DNA, Triple-Stack Vocal Builder, Style Formula Builder, Negative Prompting, TIER_RULES, +90 теги, 40+ BPM пресетів
v5.0.1 Виправлення кольору [Section] тегів, 4-кольорові категорії tag-prompt у HTML-експорті
v5.0.0 5-шаровий бас, Infinite Embrace, Zifferblatt UA, інструментальний режим, Artist Reference, +54 теги, HTML-експорт redesign
v4.0.0 Бібліотека промптів, HTML-експорт, двомовний UI (UA/EN), французька мова лірики, версія в шапці
v3.5 Виправлення аналізу жанру, покращення стабільності
v3.0 Проксі-архітектура Netlify, нові теги, вокальні пресети
v2.0 4-кроковий візард, drag-and-drop структура пісні
v1.0 Базова генерація промптів

ᯓ𝄞LIPS⋆by⋆AVIIˎˊ˗ ⓒ 2026 — by @AVII (Vitaliy + Iryna + AI)