AutoDJ Mixer v16.4

AI-powered DJ mix engine. Автоматическое сведение треков с использованием нейросетевого структурного анализа (All-in-One Fix), машинного обучения (madmom beat tracking) и профессионального DSP (bar-by-bar warp, LR4 crossover, BPM normalization). Extended transitions 20-60s, A1F Fast default, vocal-heavy auto-switch, mix numbering, YouTube URL catalog, Russian track filter.

Разрабатывается Hermes (A1F интеграция, DSP, структурный анализ) + ClaudeClaw (warp, pipeline, AI transitions).

Pipeline

Полный конвейер автоматического сведения:

Step 0:      A1F Analysis       → all-in-one-fix (Demucs separation + structure)
Step 0.5:    Metadata Enrich    → enrich_metadata.py (yt-dlp + key detection)
Step 1:      Pre-Analyze        → BPM, Camelot, sections, optimal order
Step 1.5:    Preview             → transitions table → user confirms
Step 2:      Mix                → smart_mixer.py (A1F-aware crossfades)
Step 3:      Analyze            → mix_analyzer.py (v3 beat grid + v2 detectors)
Step 4:      Validate           → mix_validator.py (pass/warn/fail)
Step 5:      Upload             → catbox.moe / litterbox (auto)

# Preview only
uv run python3 smart_mixer.py --wav-dir ./shared/tracks --ann-dir ./shared/ann \
  --style "Progressive House" --preview-only

# Full mix with A1F analysis
uv run python3 smart_mixer.py --wav-dir ./shared/tracks --ann-dir ./shared/ann \
  --style "Progressive House" --author "Hermes" --bitrate 320k

All-in-One Fix анализ треков (A1F)

A1F — это нейросетевой анализ музыкальной структуры через OpenMIRLab All-in-One Fix. Использует Demucs для разделения по стемам + структурный парсер.

Что собирается о каждом треке

После A1F анализа для каждого трека генерируется 2 файла в shared/a1f_results/:

1. A1F JSON (`[id].json`) — нейросетевой анализ:

Поле	Тип	Описание
`bpm`	float	Темп в BPM
`beats`	float[]	Массив всех долей (в секундах)
`downbeats`	float[]	Массив сильных долей (каждый 4-й бит)
`beat_positions`	int[]	Позиция каждой доли в такте (1/2/3/4)
`segments`	{start, end, label}[]	Сегментная структура: intro, verse, chorus, bridge, inst, outro, break
`vocal_intervals`	{start, end, label}[]	Вокальные зоны — verse, chorus, bridge (вычисляются по сегментам)
`key`	str	Тональность (librosa chroma CQT + Krumhansl-Schmuckler)
`camelot`	str	Camelot код (напр. "6A", "8B")

2. Meta JSON (`[id].meta.json`) — метаданные:

Поле	Тип	Описание
`artist`	str	Исполнитель (из yt-dlp)
`track_title`	str	Название трека
`upload_date`	str	Дата загрузки (YYYYMMDD)
`year`	int	Год релиза
`tags`	str[]	YouTube-теги
`genre`	str	Определённый жанр (House / Techno / Electronic / Melodic / Deep House / Progressive)
`description`	str	Описание YouTube (первые 500 символов)

Как A1F запускается

# Полный анализ (Demucs + структура) — для финальных треков
~/ai-tools/all-in-one-fix/venv/bin/python -m allin1fix.cli track.wav \
  -o shared/a1f_results/ --overwrite

# Быстрый анализ (без Demucs) — для черновиков
~/ai-tools/all-in-one-fix/venv/bin/python -m allin1fix.cli track.wav \
  -o shared/a1f_results/ --overwrite --skip-separation

Автоматически запускается smart_mixer.py в фоне при первом обнаружении трека без A1F.
Режим --analysis-mode a1f_fast (default): без Demucs, 2-3 мин/трек
Режим --analysis-mode a1f: полный Demucs + full precision, 20-40 мин/трек (авто-включение при vocal_density > 0.5)
Режим --analysis-mode no_a1f: только fallback по тегам

Как собранная информация используется при сведении

1. Dynamic CF_BARS — длина кроссфейда по сегментам

Функция resolve_transition_params() анализирует сегменты обоих треков на стыке:

Сегмент A (exit)	Сегмент B (entry)	CF_BARS	Smooth EQ	Notch
outro / inst	intro / inst	16	да	-3.5 dB
outro / inst	любой	12	да	-3.5 dB
verse / chorus / bridge	intro / inst	8	да	-3.0 dB
verse / chorus	verse / chorus	4	нет (stepped)	-2.0 dB
break	chorus / drop	4	нет	-2.0 dB
любой (no A1F)	fallback	8	средне	-3.5 dB

2. Vocal overlap avoidance

Если оба трека имеют вокальные зоны рядом со стыком, slave трек сдвигается на безвокальный участок. Используются vocal_intervals из A1F JSON.

3. Camelot — гармоническое сведение

Тональность G min (6A) → совместимы 6A, 6B, 5A
Несовместимые тональности получают longer CF + notch
Camelot отображается в preview-таблице переходов

4. BPM normalization

A1F BPM — источник истины (заменяет madmom BPM)
BPM Transition: линейный ramp-back 15s после кроссфейда
Dynamic ramp: <1bpm → skip, 1-3bpm → 30s, 3-8bpm → 15s, >8bpm → 10.5s

5. Beat grid синхронизация

downbeats из A1F полностью заменяют madmom downbeats
Используются для: выбор точек exit/entry, расчёт shift, snap_bar
Полная сетка beats используется для micro-alignment (FFT cross-correlation)

Shared directory structure

Все ресурсы доступны обоим агентам (Hermes + ClaudeClaw) через группу users:

/opt/autodj-mixer/
├── shared/
│   ├── tracks/          ← WAV-файлы треков (в .gitignore)
│   ├── a1f_results/     ← A1F JSON (анализ) + .meta.json (метаданные)
│   ├── ann/             ← Madmom beat annotations (.txt)
│   └── catalog/         ← catalog_index.json, catalog_utils.py
├── smart_mixer.py       ← Основной миксер
├── enrich_metadata.py   ← Обогащение метаданных (yt-dlp + key)
├── mix_analyzer.py      ← Пост-микс анализ качества
├── SKILL.md             ← Полная документация (canonical source)
└── CHANGELOG.md         ← История изменений

Key scripts

Скрипт	Назначение
`smart_mixer.py`	DJ mix engine v16: A1F-aware crossfades, dynamic CF_BARS, EQ Sweep, BPM Transition, Camelot
`enrich_metadata.py`	Обогащение: yt-dlp метаданные + тональность + вокальные интервалы
`mix_analyzer.py`	Post-mix diagnostics: 10 детекторов качества (v3 madmom + v2 detectors)
`mix_validator.py`	Threshold-based validation (pass/warn/fail)
`yt_download.py`	YouTube → WAV → madmom annotations (Warp proxy)
`batch_annotate.py`	Пакетное аннотирование всех WAV в shared/tracks/
`repaint_transition.py`	AI-переходы через ACE-Step 1.5 Repaint
`register_new_tracks.py`	Регистрация новых треков в каталоге

Quality chain

Source WAV (24-bit/44.1kHz PCM)
  → float32 processing (lossless)
  → A1F structural analysis (segments + vocal zones + key)
  → LUFS normalization (-14 LUFS)
  → Bar-by-bar warp + LR4 crossover (float64→float32)
  → EQ Sweep + soft_clipper_tanh
  → -3dB headroom after norm_lufs
  → WAV PCM_24 master (archival quality)
  → MP3 320kbps (final delivery)

Configuration

# CLI flags (smart_mixer.py)
--wav-dir ./shared/tracks    # WAV files
--ann-dir ./shared/ann       # Madmom annotations
--style "Progressive House"  # Genre (auto-filename)
--author "Hermes"            # MP3 artist tag
--bitrate 320k               # MP3 bitrate
--analysis-mode a1f_fast      # a1f_fast (default) / a1f / no_a1f
--cf-bars auto               # Dynamic CF_BARS (default)
--transitions-dir ./transitions  # AI transitions
--preview-only               # Preview mode (no mix)

Version history

Версия	Изменения
v16.4	Extended transitions (20-60s). A1F Fast default. Vocal-heavy auto-switch to full A1F. Mix numbering (MIX-#). YouTube URL in catalog/metadata. Russian track filter. delete_tracks.py.
v16.3.3	Shared directory structure (`shared/`) для dual-agent доступа. Все пути → `shared/tracks/`, `shared/a1f_results/`, `shared/ann/`.
v16.3.2	A1F extended: vocal_intervals, beats, key/camelot. Metadata enrichment: yt-dlp artist, title, year, genre.
v16.3.1	Camelot integration + vocal overlap avoidance.
v16.3	Сегментная логика переходов. Dynamic CF_BARS по сегментам A/B. Три режима анализа (a1f/a1f_fast/no_a1f).
v16.2	Per-track style profiles. A1F bar labels в load_a1f_track_data().
v15	DSP overhaul: EQ Sweep HPF/LPF, soft_clipper_tanh, BPM Transition, -3dB headroom, sosfilt.
v14	CHANGELOG overhaul. 9 artefact detectors. Zone scanning (±15s). fix_ht v4 frozen.
v13	Seamless blend→ramp. ACE-Step Repaint. Preview step.
v12-v7	RMS stabilizer, bar-by-bar warp, LR4 crossover.

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 152 Commits
.github/workflows		.github/workflows
ann		ann
ann_full		ann_full
data		data
docs		docs
examples		examples
genres		genres
scripts		scripts
shared		shared
skills		skills
tests		tests
.gitignore		.gitignore
.mix_counter		.mix_counter
.optimized_config.py		.optimized_config.py
.preview_pending.txt		.preview_pending.txt
CHANGELOG.md		CHANGELOG.md
CLAUDE_SYNC.md		CLAUDE_SYNC.md
CONCEPT.md		CONCEPT.md
MIX-1_Report_Template.md		MIX-1_Report_Template.md
MIX-1_Report_UKR_Tech_House.md		MIX-1_Report_UKR_Tech_House.md
README.md		README.md
SKILL.md		SKILL.md
TECHNICAL.md		TECHNICAL.md
UKR_Tech_House_Report.md		UKR_Tech_House_Report.md
a1f.py		a1f.py
batch_annotate.py		batch_annotate.py
brief_parser.py		brief_parser.py
build_seedlist.py		build_seedlist.py
catalog_register.py		catalog_register.py
cleanup_wavs.py		cleanup_wavs.py
curate_tracks.py		curate_tracks.py
curation_bridge.py		curation_bridge.py
curation_config.py		curation_config.py
do_ann.sh		do_ann.sh
enrich_cache.py		enrich_cache.py
enrich_metadata.py		enrich_metadata.py
gen_ann.py		gen_ann.py
genre_detector.py		genre_detector.py
lastfm.py		lastfm.py
local_enrich.py		local_enrich.py
log_change.sh		log_change.sh
mix_analyzer.py		mix_analyzer.py
mix_analyzer_test.py		mix_analyzer_test.py
mix_config.py		mix_config.py
mix_config_128.py		mix_config_128.py
mix_config_128bpm.py		mix_config_128bpm.py
mix_config_4track_test.py		mix_config_4track_test.py
mix_config_6track.py		mix_config_6track.py
mix_config_french.py		mix_config_french.py
mix_config_house.py		mix_config_house.py
mix_config_organic.py		mix_config_organic.py
mix_config_prog.py		mix_config_prog.py
mix_config_ukr_tech_house.py		mix_config_ukr_tech_house.py
mix_validator.py		mix_validator.py
more_tracks.md		more_tracks.md
orchestrate.py		orchestrate.py
playwright_scraper.py		playwright_scraper.py
prescreen.py		prescreen.py
pytest.ini		pytest.ini
redo_ann.py		redo_ann.py
register_new_tracks.py		register_new_tracks.py
repaint_transition.py		repaint_transition.py
report.py		report.py
requirements.txt		requirements.txt
resolve_metadata.py		resolve_metadata.py
run_annotations.py		run_annotations.py
run_mix3.py		run_mix3.py
run_pipeline.py		run_pipeline.py
run_preflight.py		run_preflight.py
seed_discover.py		seed_discover.py
smart_mixer.py		smart_mixer.py
smart_mixer_orig.py		smart_mixer_orig.py
source_check.py		source_check.py
style_resolver.py		style_resolver.py
track_analyzer.py		track_analyzer.py
transitions_reel.py		transitions_reel.py
v14_test_config.py		v14_test_config.py
yt_download.py		yt_download.py
yt_mix_config.py		yt_mix_config.py

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

AutoDJ Mixer v16.4

Pipeline

All-in-One Fix анализ треков (A1F)

Что собирается о каждом треке

1. A1F JSON (`[id].json`) — нейросетевой анализ:

2. Meta JSON (`[id].meta.json`) — метаданные:

Как A1F запускается

Как собранная информация используется при сведении

1. Dynamic CF_BARS — длина кроссфейда по сегментам

2. Vocal overlap avoidance

3. Camelot — гармоническое сведение

4. BPM normalization

5. Beat grid синхронизация

Shared directory structure

Key scripts

Quality chain

Configuration

Version history

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

AutoDJ Mixer v16.4

Pipeline

All-in-One Fix анализ треков (A1F)

Что собирается о каждом треке

1. A1F JSON ([id].json) — нейросетевой анализ:

2. Meta JSON ([id].meta.json) — метаданные:

Как A1F запускается

Как собранная информация используется при сведении

1. Dynamic CF_BARS — длина кроссфейда по сегментам

2. Vocal overlap avoidance

3. Camelot — гармоническое сведение

4. BPM normalization

5. Beat grid синхронизация

Shared directory structure

Key scripts

Quality chain

Configuration

Version history

License

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

1. A1F JSON (`[id].json`) — нейросетевой анализ:

2. Meta JSON (`[id].meta.json`) — метаданные:

Packages