yamusic-downloader-pro

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

yamusic-downloader-pro

★ 17 Open GitHub ↗

Мощное расширение (Chrome, Firefox, Edge, Opera, Яндекс Браузер) для загрузки MP3 с Яндекс Музыки. Точный перехват треков из «Моей Волны», сохранение оригинальных названий и красивый popup-плеер.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🎵 YaMusic PRO (Yandex Music Downloader PRO)

**Ультимативный пульт управления и премиальный медиа-менеджер для Яндекс Музыки в вашем браузере.**

*(Официальное переименование проекта из Yandex Music Downloader PRO)*

[![Chrome Web Store](https://img.shields.io/chrome-web-store/v/klgmmeljbkpjblolcdnaiaeepdfbhbhg.svg?style=for-the-badge&logo=google-chrome&color=brightgreen&label=Chrome%20Web%20Store)](https://chromewebstore.google.com/detail/yamusic-pro/klgmmeljbkpjblolcdnaiaeepdfbhbhg)
[![Version](https://img.shields.io/badge/Версия-1.5.1-blue.svg?style=for-the-badge)](https://github.com/KernelPace/yamusic-downloader-pro/releases)
[![Chromium](https://img.shields.io/badge/Chrome_|_Edge_|_Yandex_|_Opera-4CAF50.svg?style=for-the-badge&logo=google-chrome)](https://github.com/KernelPace/yamusic-downloader-pro)
[![Firefox](https://img.shields.io/badge/Firefox-FF7139.svg?style=for-the-badge&logo=firefox-browser)](https://addons.mozilla.org/ru/firefox/addon/yamusic-pro/)
[![License](https://img.shields.io/badge/Лицензия-GPLv3-blue.svg?style=for-the-badge)](https://raw.githubusercontent.com/KernelPace/yamusic-downloader-pro/main/LICENSE)
[![Downloads](https://img.shields.io/github/downloads/KernelPace/yamusic-downloader-pro/total.svg?style=for-the-badge&color=brightgreen)](https://github.com/KernelPace/yamusic-downloader-pro/releases)
[![Stars](https://img.shields.io/github/stars/KernelPace/yamusic-downloader-pro.svg?style=for-the-badge&color=yellow)](https://github.com/KernelPace/yamusic-downloader-pro/stargazers)

https://github.com/user-attachments/assets/22e3d049-55e5-4f49-9bc1-34bb98bfa5b4

*Управляйте музыкой из любой вкладки браузера и сохраняйте любимые треки в максимальном студийном качестве — Lossless FLAC, современный M4A (AAC) или классический MP3.*

</div>

🎉 **ОФИЦИАЛЬНЫЙ РЕЛИЗ:** Расширение успешно прошло модерацию Google. Устанавливайте в 1 клик с поддержкой автоматических обновлений:

👉 **[🚀 Установить YaMusic PRO из Chrome Web Store](https://chromewebstore.google.com/detail/yamusic-pro/klgmmeljbkpjblolcdnaiaeepdfbhbhg)**
⚠️ Временно недоступно в магазине (аккаунт разработчика на проверке).
Установите вручную из архива `yamusic-pro.zip` — инструкция ниже.

*(⭐ Если расширение оказалось для вас полезным, пожалуйста, оставьте отзыв в магазине Chrome — это очень поможет развитию проекта!)*

**🦊 НОВИНКА: Официальный релиз в Firefox Add-ons (AMO)! 🎉**

Расширение успешно прошло модерацию Mozilla и теперь доступно для установки в один клик с автоматическими обновлениями:

👉 **[🦊 Установить YaMusic PRO из Firefox Add-ons](https://addons.mozilla.org/ru/firefox/addon/yamusic-pro/)**

*(⭐ Огромное спасибо всем, кто поддерживает расширение оценками и отзывами в Firefox Add-ons — это очень ценный вклад в развитие проекта!)*

---

## 🚀 Главные преимущества

YaMusic PRO глубоко и бесшовно интегрируется в архитектуру Яндекс Музыки (актуальный интерфейс 2026 года), предоставляя беспрецедентный уровень контроля над аудиопотоком и вашей медиатекой.

* 🎵 **Три студийных формата (FLAC, M4A, MP3):** Скачивайте музыку именно в том качестве, которое нужно вам. **Lossless FLAC** — для аудиофилов, студийное качество без сжатия. **M4A (AAC)** — современный индустриальный стандарт: при битрейте ~260 kbps этот кодек звучит чище и детальнее, чем MP3 320 kbps (точнее сохраняет высокие частоты и стереобазу), а файл весит на ~20% меньше. **MP3** — максимальная совместимость. Расширение работает честно: если вы нажмете на бейдж `[FLAC]`, а у Яндекса на сервере физически нет этого трека в формате без потерь, расширение не станет обманывать и скачивать MP3, а сразу предупредит об этом (кнопка станет красной с текстом `[НЕТ FLAC]`). Однако, если вы выберете формат FLAC или M4A для основной кнопки скачивания, сработает умный алгоритм: при отсутствии выбранной версии на сервере расширение автоматически загрузит трек в MP3 максимального качества.
* 📁 **Массовое скачивание (Скачать всё):** Загружайте целые альбомы, личные плейлисты и эксклюзивные редакторские подборки Яндекса в один клик. Встроенная интеллектуальная очередь с безопасной задержкой между треками надежно защищает ваш аккаунт и IP-адрес от блокировок.
* 🗂️ **Умная организация медиатеки:** Для тех, кто предпочитает строгую сортировку файлов, расширение умеет автоматически создавать правильную структурированную иерархию папок прямо на вашем диске (например: `Исполнитель / Альбом (Год) / Диск X / 01 - Трек.flac`).
* 🎛️ **Премиальный глобальный пульт 2.0:** Управляйте музыкой из абсолютно любой вкладки браузера. Перематывайте треки, ставьте лайки и скачивайте музыку в один клик, находясь на любом сайте в интернете. Клики по обложке, треку и исполнителю мягко открывают нужные страницы на играющей вкладке без перезагрузки, а специальная кнопка «Перейти к плееру» мгновенно возвращает к активному плееру. Красивый мини-плеер с эффектом матового стекла (Glassmorphism) безошибочно найдет активный плеер даже среди десятков фоновых вкладок.
* 🎧 **Студийные метаданные (ID3v2, Vorbis Comments, Apple ILST):** В каждый файл на лету вшивается исчерпывающий набор тегов: Название, Исполнитель, Исполнитель альбома, Альбом, Год, Жанр, Номер трека, Общее число треков, Номер диска и Издатель (Лейбл). Оригинальная обложка скачивается в выбранном разрешении (от 200 до 1000 px) и внедряется прямо в аудиофайл. Для формата M4A реализовано двойное тегирование Издателя — лейбл вшивается сразу двумя методами для идеальной совместимости с экосистемой Apple, плеерами уровня AIMP и Проводником Windows. Любые приписки *(feat., Remix, Live)* филигранно переносятся в заголовок, оставляя поле исполнителя чистым для идеальной сортировки.
* 🛠️ **Собственный M4A Tag Engine:** Для формата M4A с нуля написан парсер MP4-контейнеров, который математически сдвигает бинарные блоки и пересчитывает таблицы смещений. Это гарантирует 100% целостность аудиопотока и исключает переполнение памяти при обработке тяжёлых файлов.
* 🧠 **Безупречный перехват «Моей Волны»:** Алгоритм анализирует скрытые ID и сверяет обложки, гарантируя скачивание **именно играющей песни**, полностью игнорируя фоновые подгрузки браузера.
* 📥 **Массовое скачивание популярных треков исполнителя:** Сохраняйте весь топ любимого исполнителя в один клик прямо со страницы `/artist/.../tracks`. При включённой опции «Умные папки» треки автоматически раскладываются по пути `Плейлисты / Имя исполнителя — Популярные треки` со всеми тегами и обложками.
* 🎨 **Точные обложки и метаданные альбома:** При скачивании треков обложка и полная информация соответствуют их собственному альбому — даже если та же песня встречается в нескольких релизах.
* 🚀 **Бесшовная SPA-навигация:** Встроенные кнопки скачивания органично работают внутри SPA-режима Яндекс Музыки — переходы между страницами, альбомами и плейлистами происходят мгновенно на уровне самого сайта, без полной перезагрузки вкладки в браузере. История навигации (кнопки «Назад/Вперёд») и воспроизведение музыки работают без перебоев.
* 🧩 **Поддержка «скрытых» треков:** Расширение корректно скачивает и отображает кнопки для треков с ограниченными метаданными или отсутствующими ссылками на стороне сервиса.
* 🌍 **Глобальная доступность:** Расширение автоматически адаптирует свои API-запросы под ваш локальный регион и стабильно работает на доменах `.ru`, `.by`, `.kz`, `.uz` и `.com`.

## ✨ Основной функционал

* 📥 **Бесшовная интеграция в интерфейс:** Аккуратные кнопки скачивания идеально сливаются с дизайном Яндекса. 
  * Кнопка `[Скачать]` встроена в шапки альбомов и плейлистов.
  * Стильные кнопки `[MP3]` и `[FLAC]` органично добавлены в нижнюю панель плеера, в интерфейс «Моей Волны» на главной странице, в списки треков и в правую боковую панель.
* ⏱️ **Интерактивный таймлайн:** Плавная перемотка треков с отображением текущего и общего времени прямо из окна расширения.
* 🔗 **Умная навигация и взаимодействие:** Обложка, название трека и имена исполнителей в мини-плеере кликабельны. Клики по ним мягко переключают на играющую вкладку и открывают нужную страницу без перезагрузки сайта (музыка не прерывается). Если песню исполняют несколько музыкантов, каждый из них является отдельной независимой ссылкой. Левый клик мгновенно откроет выбранный трек или исполнителя прямо в играющей вкладке (без перезагрузки), а клик колесиком — откроет их в новой вкладке, не отрывая вас от текущих дел. При этом текст с названием песни теперь можно свободно выделять мышкой, а для быстрого обмена музыкой добавлена удобная мини-кнопка, копирующая прямую ссылку на трек в один клик.
* 👎 **Безопасное управление рекомендациями:** Добавлена кнопка «Не нравится». Чтобы защитить вашу медиатеку от случайных нажатий, реализовано всплывающее меню подтверждения. Вы можете либо отменить действие, либо подтвердить его — и только после подтверждения трек уберется из ваших рекомендаций, а плеер переключится на следующую песню.
* 🔄 **Живая синхронизация:** Если оставить окно мини-плеера открытым, при автоматическом переключении песни расширение само плавно обновит обложку, имя трека и имена исполнителей и сбросит таймлайн.
* ⚡ **Мгновенный отклик и Умный кэш:** Окно расширения открывается моментально. Алгоритм заранее кэширует данные играющего трека в фоне, полностью исключая визуальные задержки и «моргание» интерфейса.
* 🌗 **Адаптация к светлой теме:** Кнопки расширения на сайте автоматически меняют свой цвет на контрастно-тёмный при переключении Яндекс Музыки в светлую тему оформления.
* 📋 **Комфортное выделение текста:** Название трека и имя исполнителя в мини-плеере можно свободно выделять мышкой для копирования. Случайные переходы по ссылкам при выделении сведены к минимуму благодаря интеллектуальному порогу срабатывания.
* 🔔 **Встроенный чекер обновлений:** Расширение само уведомит вас о выходе новых версий прямо в интерфейсе мини-плеера.
* 👋 **Приветственная страница (Онбординг):** Добавлена красивая стартовая страница при первой установке с описанием всех главных функций и полезными ссылками.
* 🎯 **Кнопка «Перейти к плееру»:** Компактная иконка в левом верхнем углу мини-плеера для мгновенного перехода на ту вкладку браузера, где прямо сейчас играет музыка. Работает даже если активная вкладка Яндекса скрыта среди десятков других.
* 🔄 **Автоматическое восстановление вкладок:** При выходе новых версий YaMusic PRO расширение автоматически перезагружает вкладки Яндекс Музыки, не прерывая музыку на играющей странице.

---

## 📦 Инструкция по установке

### 🌐 Установка в 1 клик (Chrome, Edge, Яндекс Браузер, Opera)
Расширение официально доступно в Chrome Web Store. Это самый удобный и безопасный способ: все будущие обновления будут устанавливаться в фоновом режиме автоматически.

👉 **[Установить YaMusic PRO из Chrome Web Store](https://chromewebstore.google.com/detail/yamusic-pro/klgmmeljbkpjblolcdnaiaeepdfbhbhg)**

*(Совет: После установки рекомендую закрепить иконку на панели браузера. Нажмите на значок «пазла» 🧩 в правом верхнем углу и кликните на «скрепку» 📌 рядом с YaMusic PRO).*

### 🦊 Firefox Add-ons + Ручная установка
**Самый простой способ** — установить в один клик из каталога Mozilla: [🦊 Установить из Firefox Add-ons](https://addons.mozilla.org/ru/firefox/addon/yamusic-pro/) (все обновления будут прилетать автоматически). Ручная установка подписанного `.xpi` — для опытных пользователей ниже.
1. Скачайте файл `yamusic-pro.xpi` из раздела **[Releases](../../releases)**.
2. Откройте Firefox и просто **перетащите** скачанный файл мышкой прямо в открытое окно браузера (или нажмите `Ctrl+O` на клавиатуре и выберите этот файл).
3. Нажмите «Добавить» во всплывающем окне. Расширение установится как полноценное дополнение и не исчезнет после перезапуска браузера! *(Скачанный файл .xpi после этого можно удалить).*

### 🛠 Ручная установка из архива (.zip)
<details>
<summary>Нажмите, чтобы развернуть инструкцию для ручной установки без магазина (ровно 1 минута)</summary>

> ⚠️ **ОЧЕНЬ ВАЖНО:** Распакуйте скачанный архив в надежное постоянное место (например, в папку `Документы/YaMusicPRO` или в `D:\YaMusicPRO`), **откуда вы не будете его удалять**. Браузер читает файлы прямо из вашей папки. Если вы удалите ее – расширение перестанет работать!

1. Скачайте архив `yamusic-pro.zip` из раздела **[Releases](../../releases)**.
2. **Распакуйте архив** в безопасную папку (см. предупреждение выше).
3. В браузере откройте страницу расширений: `chrome://extensions/`
4. В правом верхнем углу включите тумблер **"Режим разработчика"** (Developer mode).
5. Нажмите кнопку **"Загрузить распакованное расширение"** (Load unpacked) и выберите вашу папку.
6. Для удобства закрепите иконку на панели браузера: нажмите на значок "Пазла" 🧩 (Расширения) в правом верхнем углу браузера и кликните на "Скрепку" 📌 рядом с расширением.
</details>

**🎉 Готово!** Зайдите на Яндекс Музыку и нажмите **F5** для обновления страницы.

---

## ⚙️ Премиальные параметры

Страница настроек переписана с нуля. Она получила современный дизайн (Glassmorphism) и интерактивное дерево папок, которое визуально обновляется прямо в процессе настройки. Чтобы открыть параметры, кликните по иконке **шестеренки** ⚙️ в левом нижнем углу мини-плеера.

* **Качество и Обложки:** Выбирайте желаемый приоритетный формат загрузки (FLAC, M4A (AAC), MP3 320 или MP3 192) и точное разрешение вшиваемых обложек (`200x200`, `400x400`, `600x600`, `800x800` или `1000x1000`). Пресет 200x200 — идеальный выбор для огромных офлайн-медиатек на телефоне, ПК или флешке для автомагнитолы: безупречная визуальная эстетика при максимальной экономии места. Если огромной обложки 1000x1000 нет на сервере, расширение мгновенно и незаметно скачает стабильный размер 400x400.
* **Кастомизация интерфейса:** Настройте внешний вид под себя. Вы можете включить отображение отдельного бейджа `[FLAC]` для загрузки Lossless в один клик. Дополнительно доступен тумблер для отключения кнопок скачивания в нижней панели плеера Яндекса (по умолчанию они включены). Также вы можете создать режим «чистого пульта», отключив тумблеры отображения кнопок скачивания на сайте Яндекса и в самом мини-плеере.
* **Организация файлов:** Укажите имя корневой подпапки для загрузок, включите «Умные папки» для автоматической сортировки по исполнителям и альбомам, активируйте индексацию треков (автоматическое добавление префиксов `01 - `, `02 - ` в имена файлов). При включённой опции «Умные папки» дополнительно доступно сохранение обложки альбома отдельным файлом \cover.jpg` в максимальном качестве (1000×1000). Активация пункта «Кнопка экспорта списка» добавляет на страницы альбомов, плейлистов и популярных треков кнопку для сохранения полного списка треков в TXT-файл.
* **Автосохранение:** Любые изменения настроек применяются мгновенно (появляется элегантное уведомление внизу экрана)..

---

## 📸 Галерея интерфейса

### Глобальная интеграция (Нижний плеер, боковая панель и списки)
<img src="https://github.com/user-attachments/assets/31f84652-c67e-40cc-95d4-33748f9ec71e" alt="Общий вид интерфейса" width="100%"/>

### Кнопки везде, где они нужны
| Плеер "Моя Волна" | Очередь воспроизведения |
|:---:|:---:|
| <img src="https://github.com/user-attachments/assets/4ce39522-262c-4bb8-ae1e-f7b865d47131" alt="Моя Волна" width="100%"/> | <img src="https://github.com/user-attachments/assets/c4b0503e-0f84-4893-9e4c-bcfb5b628c66" alt="Очередь" width="100%"/> |

| Популярные треки Исполнителя | Страница Альбома |
|:---:|:---:|
| <img src="https://github.com/user-attachments/assets/b7953820-5012-4808-82fc-4bce1ef9fef6" alt="Популярное" width="100%"/> | <img src="https://github.com/user-attachments/assets/f006a778-a67f-4f6e-88ba-dc23df7bc4db" alt="Альбом" width="100%"/> |

### Массовое скачивание плейлистов
<img src="https://github.com/user-attachments/assets/1a4cd913-c4fc-4958-ad21-315c00c06c30" alt="Плейлист" width="100%"/>

---

## 🙏 Благодарности

В мире Open Source мы стоим на плечах гигантов. Отдельное спасибо авторам этих замечательных проектов, которые послужили вдохновением и базой знаний:
* [PaulZtx/ya-music-downloader-extension](https://github.com/PaulZtx/ya-music-downloader-extension) — за начальную идею и отправную точку.
* [MarshalX/yandex-music-api](https://github.com/MarshalX/yandex-music-api) — за великолепный реверс-инжиниринг и документацию неофициального API Яндекса.

---

## ⚖️ Правовая информация и Дисклеймер

Данное программное обеспечение (YaMusic PRO) разработано исключительно в **образовательных исследовательских целях** и предназначено для **личного использования**.

1. Расширение функционирует **только при наличии активной оплаченной подписки** пользователя на сервис Яндекс Музыка. Оно не обходит защиту от неоплаченного доступа (paywall).
2. Разработчик расширения **не несет ответственности** за любые прямые или косвенные последствия использования данного ПО. Вся ответственность за использование скачанных материалов лежит на конечном пользователе.
3. Категорически запрещается использовать данное расширение для пиратства, коммерческого распространения или нарушения авторских прав создателей музыкальных произведений. Сохраненные файлы предназначены исключительно для локального офлайн-прослушивания владельцем подписки.

---

## 💬 Сообщество и Обновления

Если у вас есть идеи по улучшению расширения, вы нашли баг или просто хотите следить за выходом новых версий — присоединяйтесь к Telegram-каналу:

👉 **[YaMusic PRO в Telegram](https://t.me/yamusic_pro)**

В комментариях к постам можно обсуждать работу расширения, предлагать идеи и общаться с комьюнити.

---

## ☕ Поддержать автора

Проект разрабатывается и поддерживается в свободное время. Адаптация расширения под новые обновления интерфейса Яндекса требует регулярного тестирования и отладки кода.

Если утилита оказалась для вас полезной, работает стабильно и просто делает прослушивание любимой музыки чуточку комфортнее, вы можете сказать автору "спасибо" чашкой виртуального кофе:

👉 **[Поддержать проект на CloudTips (Карты РФ, СБП, T-Pay)](https://pay.cloudtips.ru/p/5647818e)**

*Любая поддержка невероятно мотивирует выпускать обновления быстрее и добавлять новые фичи! Огромное спасибо всем, кто поддерживает Open-Source! 🚀*

---
<div align="center">
<i>Сделано с фокусом на качество кода и любовь к хорошей музыке.</i>
</div>

yamusic-downloader-pro

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README