# Audset.ru

> Аудсет — бесплатный музыкальный сервис: слушать треки онлайн, скачать MP3, читать тексты песен с синхронизированной подсветкой строк (караоке-режим). Более 34 миллионов треков, без регистрации.

## О сервисе

Audset.ru — российский музыкальный сайт. Поиск работает по названию трека, строке из текста песни или имени исполнителя (полнотекстовый движок Manticore Search). Аудио отдаётся через адаптивный HLS-стриминг и прямые MP3-ссылки. Регистрация не требуется.

Ключевые возможности:
- Поиск более 34 миллионов треков
- Онлайн-прослушивание (HLS/MP3)
- Скачивание MP3
- Тексты песен с синхронизированной подсветкой строк (караоке-режим) при воспроизведении
- Страницы жанров, артистов, плейлистов
- Еженедельные подборки (плейлисты «Новинки» и «Лучшее недели»)

## Главная страница

URL: https://audset.ru/

Содержит: поисковую форму, блок «Популярное сейчас» (4 трека из недельного плейлиста), раздел «Лучшее по жанрам» с карточками жанров, два плейлиста — «Новинки» и «Лучшее недели».

Title: Аудсет — слушать музыку онлайн бесплатно, скачать mp3 и тексты песен

## Поиск

URL: https://audset.ru/search/{запрос}

Полнотекстовый поиск. Запрос передаётся в сегменте пути (не query-параметр). Возвращает список треков (название, исполнитель, обложка, плеер) и карусель похожих артистов. Пагинация через AJAX (?ajax=1&page=N). Максимум 200 результатов (20 на страницу).

Пример: https://audset.ru/search/metallica

## Жанры

Список всех жанров: https://audset.ru/genre/

Страница жанра: https://audset.ru/genre/{id}

Каждый жанр имеет числовой id, название, цвет для градиентной карточки, иконку. Страница жанра содержит список треков, карусель исполнителей жанра, кнопки шеринга.

Основные жанры (id — название):
- 35 — Поп
- 53 — Рок
- 105 — Рэп / Хип-хоп
- 83 — Альтернатива
- 87 — Электронная
- 67 — Металл
- 119 — Джаз
- 102 — Танцевальная
- 186 — Классика
- 1 — Шансон
- 131 — Фолк
- 138 — Блюз
- 127 — Панк
- 126 — Кантри
- 137 — Регги

## Треки

URL: https://audset.ru/track/{id}

Страница трека включает:
- Встроенный аудиоплеер (HLS-адаптивный стриминг, fallback MP3)
- Текст песни с синхронизированными таймкодами (отображается как «субтитры» при воспроизведении)
- Кнопку скачивания MP3
- Обложку альбома
- Название трека, имя исполнителя
- Ссылку на страницу артиста
- Похожие треки (список внизу)
- Микроразметку Schema.org (MusicRecording)
- OpenGraph-теги для шеринга

Таймкоды текста доступны через API: https://audset.ru/karaoke/{id} — возвращает JSON [[begin_ms, end_ms, "строка"], ...]

## Артисты

Список (со страницы трека или жанра): https://audset.ru/artist/
Страница артиста: https://audset.ru/artist/{id}

Содержит все треки исполнителя, микроразметку Schema.org (MusicGroup), обложку, кнопки шеринга.

## Плейлисты

URL: https://audset.ru/playlist/{id-или-slug}

Тематические и еженедельные подборки. Содержат название, описание, список треков, микроразметку Schema.org (MusicPlaylist).

Фиксированные плейлисты:
- playlist/1 — «Новинки» (еженедельно обновляется)
- playlist/best-week — «Лучшее недели» (еженедельно обновляется)

## Статические страницы

URL: https://audset.ru/page/{slug}

Информационные страницы (условия, о сервисе и т.п.). Содержимое хранится в БД.

## Технические эндпоинты

- https://audset.ru/suggest/ — автодополнение поиска (JSON, GET ?q=)
- https://audset.ru/karaoke/{id} — таймкоды текста (JSON)
- https://audset.ru/sitemap.xml — индекс sitemap
- https://audset.ru/sitemap/tracks-{n}.xml — дочерние карты треков
- https://audset.ru/sitemap/artists-{n}.xml — дочерние карты артистов

## Техническая архитектура

- Backend: PHP (без фреймворка), MariaDB/MySQL, Manticore Search (полнотекстовый поиск)
- Frontend: ванильный JS, без сторонних библиотек (кроме hls.js для адаптивного стриминга)
- Аудио: HLS (.m3u8) для современных браузеров, прямые MP3 как fallback
- SEO: Schema.org JSON-LD (MusicRecording, MusicGroup, MusicPlaylist), OpenGraph, breadcrumbs, sitemap
- Хостинг: nginx, PHP-FPM, ISPmanager