# Thyron

> Thyron — бесплатный музыкальный плеер для локальных аудиофайлов на Windows, macOS, Linux, Android и iOS. Воспроизведение, поиск и плейлисты работают офлайн, без аккаунта и подписки. Музыка добавляется из ваших файлов; встроенного каталога стриминга нет.

- [На главную](https://thyron.ru/)
- [Документация](https://thyron.ru/documentation.html): Инструкции по установке, добавлению аудиофайлов, работе с плейлистами и передаче библиотеки между устройствами.
- [Установка](https://thyron.ru/documentation.html#installation): Выберите операционную систему. В соответствующей вкладке указаны формат установщика, порядок установки и способ добавления аудиофайлов.
- [Добавление аудиофайлов](https://thyron.ru/documentation.html#library): Библиотека формируется из файлов выбранного хранилища. Можно подключить несколько папок и переключаться между ними в разделе «Хранилище». У каждого хранилища отдельные списки треков и плейлистов.
- [Поиск треков и плейлистов](https://thyron.ru/documentation.html#search): Поиск работает в текущем хранилище и учитывает названия треков, исполнителей и плейлистов. Результаты обновляются при вводе запроса.
- [Создание и изменение плейлистов](https://thyron.ru/documentation.html#playlists): Плейлист содержит выбранные треки из текущего хранилища. Треки можно добавить в существующий плейлист или создать новый при добавлении.
- [Управление воспроизведением](https://thyron.ru/documentation.html#playback): Панель воспроизведения находится в нижней части окна. Она показывает текущий трек и позицию воспроизведения, позволяет переключать треки, включать паузу, перемешивание и повтор.
- [Управление с клавиатуры (VIM-мод)](https://thyron.ru/documentation.html#vim): VIM-мод позволяет перемещать фокус между треками и плейлистами с клавиатуры. Перемещение фокуса само по себе не меняет воспроизводимый трек.
- [Синхронизация по локальной сети](https://thyron.ru/documentation.html#sync): Передача запускается вручную между двумя устройствами в одной локальной сети. Ведущее устройство отправляет недостающие треки принимающему устройству; плейлисты объединяются.
- [Язык и масштаб интерфейса](https://thyron.ru/documentation.html#settings): Панель «Настройки» открывается значком меню слева от строки поиска. В ней находятся настройки языка и масштаба, синхронизация по локальной сети и раздел «О приложении».
- [Поддерживаемые аудиоформаты](https://thyron.ru/documentation.html#supported-formats): Библиотека сканирует файлы MP3, M4A, AAC, ALAC, FLAC, OGG, WAV и AIFF. OGG поддерживается на Windows, Linux и Android. На Apple-платформах OGG исключён из воспроизведения. Поддержка также зависит от кодека внутри файла.
- [Поддержка](https://thyron.ru/documentation.html#support): Если треки не отображаются, выполните проверки ниже. Если проблема сохраняется, отправьте сообщение об ошибке через GitHub или обратитесь по электронной почте.
- [Политика конфиденциальности](https://thyron.ru/privacy.html)
- [Условия использования](https://thyron.ru/terms.html)
- [Использование cookie](https://thyron.ru/consent.html)

## Установка

Выберите операционную систему. В соответствующей вкладке указаны формат установщика, порядок установки и способ добавления аудиофайлов.

### Windows

- [Скачать Windows](https://github.com/E-Bor/thyron-feedback/releases/latest/download/thyron.exe)
- [Документация](https://thyron.ru/documentation.html#windows)

1. Скачивание установщика: Скачайте файл .exe по ссылке ниже.
2. Установка приложения: Откройте скачанный файл и выполните инструкции установщика.
3. Добавление папки: Запустите Thyron. В разделе «Хранилище» нажмите «Добавить папку хранилища» и выберите папку с аудиофайлами.

Приложение читает файлы из выбранной папки. Если папка перемещена или переименована, выберите её заново в разделе «Хранилище».

### macOS

- [Скачать macOS](https://github.com/E-Bor/thyron-feedback/releases/latest/download/thyron.dmg)
- [Документация](https://thyron.ru/documentation.html#macos)

1. Скачивание образа диска: Скачайте файл .dmg и откройте его в Finder.
2. Установка в «Программы»: Перетащите Thyron в папку «Программы» и запустите приложение из этой папки.
3. Добавление папки: В разделе «Хранилище» нажмите «Добавить папку хранилища» и выберите локальную папку с аудиофайлами. При запросе разрешите доступ к файлам.

После установки запускайте Thyron из папки «Программы». Образ диска .dmg можно извлечь.

### Linux

- [Скачать Linux](https://github.com/E-Bor/thyron-feedback/releases/latest/download/thyron.deb)
- [Документация](https://thyron.ru/documentation.html#linux)

1. Скачивание пакета: Скачайте пакет thyron.deb. Установщик предназначен для дистрибутивов с поддержкой пакетов Debian.
2. Установка пакета: Откройте терминал в папке со скачанным файлом и выполните команду ниже.
3. Первый запуск: Откройте Thyron из меню приложений. В разделе «Хранилище» добавьте папку с аудиофайлами.

Команда рассчитана на файл с именем thyron.deb в текущей папке терминала. Если имя файла отличается, измените его в команде.

### Android

- [Скачать Android](https://github.com/E-Bor/thyron-feedback/releases/latest/download/thyron.apk)
- [Документация](https://thyron.ru/documentation.html#android)

1. Скачивание APK: Скачайте файл .apk на устройство и откройте его.
2. Установка приложения: Если Android запросит разрешение, разрешите установку для браузера или файлового менеджера, из которого открыт APK. Затем завершите установку.
3. Добавление папки: Откройте «Хранилище» → «Добавить папку хранилища». Предоставьте доступ к файлам и выберите папку во внутренней памяти устройства.

Выберите папку во внутренней памяти, а не виртуальное хранилище Documents. После установки разрешение на установку приложений из этого источника можно отозвать.

### iOS

- [Скачать iOS](https://apps.apple.com/app/thyron/id6796647188)
- [Документация](https://thyron.ru/documentation.html#ios)

1. Страница в App Store: Откройте ссылку App Store ниже на iPhone или iPad.
2. Установка приложения: Нажмите «Загрузить» или значок скачивания, дождитесь установки и откройте Thyron.
3. Импорт аудиофайлов: В разделе «Хранилище» нажмите «Импорт аудиофайлов». Выберите файлы в системном окне. Thyron скопирует их в хранилище приложения.

Перед импортом загрузите файлы из iCloud или другого источника на устройство.

## Добавление аудиофайлов

Библиотека формируется из файлов выбранного хранилища. Можно подключить несколько папок и переключаться между ними в разделе «Хранилище». У каждого хранилища отдельные списки треков и плейлистов.

На компьютере и Android откройте «Хранилище» → «Добавить папку хранилища». Выберите папку с аудиофайлами. Приложение просканирует поддерживаемые файлы и прочитает названия, исполнителей и обложки из их метаданных.
На iOS откройте «Хранилище» → «Импорт аудиофайлов» и выберите файлы в системном окне. Они копируются во внутреннее хранилище приложения.
После сканирования треки появятся в библиотеке. На компьютере списки треков и плейлистов расположены рядом. На телефоне переключайтесь между ними горизонтальным свайпом.

На компьютере и Android исходная папка должна оставаться доступной. Если она перемещена или отключена, выберите её заново. Для восстановления коллекции при потере устройства требуется отдельная резервная копия файлов.

## Поиск треков и плейлистов

Поиск работает в текущем хранилище и учитывает названия треков, исполнителей и плейлистов. Результаты обновляются при вводе запроса.

Введите часть названия или имени исполнителя в строку поиска над библиотекой.
Для уточнения запроса используйте несколько слов, например часть названия и имя исполнителя. Поиск не учитывает регистр и диакритические знаки.
Нечёткий поиск допускает небольшие опечатки. Если результатов нет, сократите запрос или проверьте название и исполнителя в метаданных файла.

В примере запрос «sneky» находит трек «Sneaky Snitch» Kevin MacLeod. Аудиофайлы из примеров не входят в приложение.

## Создание и изменение плейлистов

Плейлист содержит выбранные треки из текущего хранилища. Треки можно добавить в существующий плейлист или создать новый при добавлении.

Удерживайте трек, чтобы включить режим выделения. Нажмите на другие треки или проведите мышью либо пальцем вниз, не отпуская нажатие. Затем нажмите «Добавить в плейлист».
Выберите существующий плейлист. Для создания нового нажмите «Добавить плейлист», введите название и подтвердите действие кнопкой «OK».
Нажатие на название плейлиста запускает воспроизведение его треков. Кнопка с тремя точками открывает содержимое: здесь можно включить отдельный трек или удалить его из плейлиста.

Удаление из плейлиста сохраняет исходный файл. Удаление трека из библиотеки удаляет файл и исключает трек из всех плейлистов. Перед подтверждением проверьте, какое действие выбрано.

## Управление воспроизведением

Панель воспроизведения находится в нижней части окна. Она показывает текущий трек и позицию воспроизведения, позволяет переключать треки, включать паузу, перемешивание и повтор.

Нажмите на трек или плейлист для начала воспроизведения. Используйте центральную кнопку для паузы и продолжения, а соседние кнопки — для перехода к предыдущему или следующему треку.
Для перехода к другой позиции переместите ползунок на шкале прогресса. Перемешивание меняет порядок треков, повтор включает повторное воспроизведение.
На компьютере наведите курсор на значок динамика, чтобы изменить громкость. После закрытия основного окна управление доступно в мини-плеере в трее. Кнопка «Открыть Thyron» возвращает основное окно.

Воспроизведение работает без интернета, пока аудиофайл доступен приложению на устройстве.

## Синхронизация по локальной сети

Передача запускается вручную между двумя устройствами в одной локальной сети. Ведущее устройство отправляет недостающие треки принимающему устройству; плейлисты объединяются.

Подключите оба устройства к одной локальной сети. Откройте Thyron и выберите хранилище на каждом устройстве.
На принимающем устройстве откройте «Настройки» → «Синхронизация по локальной сети» → «Принимать». Дождитесь статуса «Готово к приёму» и оставьте окно открытым.
На ведущем устройстве откройте «Настройки» → «Синхронизация по локальной сети» → «Синхронизировать». Нажмите «Найти устройства», затем «Синхронизировать» рядом с нужным устройством. Держите оба приложения открытыми до завершения передачи.

Существующие треки на принимающем устройстве не удаляются. Если устройство не найдено, проверьте разрешение на доступ к локальной сети, настройки брандмауэра и изоляцию устройств в гостевой Wi-Fi сети.

## Язык и масштаб интерфейса

Панель «Настройки» открывается значком меню слева от строки поиска. В ней находятся настройки языка и масштаба, синхронизация по локальной сети и раздел «О приложении».

В поле «Язык» выберите английский, русский, испанский, китайский или хинди. Язык приложения настраивается отдельно от языка сайта.
В поле «Масштаб интерфейса» выберите размер текста и элементов управления.
Откройте «О приложении» для просмотра сведений о Thyron, политики конфиденциальности и способов связи с поддержкой.

Настройки и данные библиотеки хранятся на устройстве. Аналитика сайта работает отдельно от приложения и включается только после согласия на cookie.

## Управление с клавиатуры (VIM-мод)

VIM-мод позволяет перемещать фокус между треками и плейлистами с клавиатуры. Перемещение фокуса само по себе не меняет воспроизводимый трек.
В настольных версиях используется Cmd на macOS и Ctrl на Windows и Linux.
Ввод текста направляется в строку поиска. Если курсор находится в строке поиска, клавиша Space вводит пробел вместо переключения паузы.

## Поддерживаемые аудиоформаты

Библиотека сканирует файлы MP3, M4A, AAC, ALAC, FLAC, OGG, WAV и AIFF.
OGG поддерживается на Windows, Linux и Android. На Apple-платформах OGG исключён из воспроизведения. Поддержка также зависит от кодека внутри файла.

## Частые вопросы

### Можно перенести плейлисты из Spotify или Яндекс Музыки?

Прямого импорта из стримингов пока нет. Для Thyron нужны отдельные аудиофайлы, а плейлисты создаются в самом приложении. Список названий треков не заменяет музыкальные файлы.

### Можно удалить исходные файлы после добавления в Thyron?

На компьютере и Android Thyron читает музыку из выбранной папки — исходные файлы должны оставаться доступными. Если папка переехала, подключи её заново. На iOS выбранные при импорте файлы копируются в хранилище приложения; прежде чем удалять оригиналы, проверь, что импорт завершён и треки воспроизводятся.

### Почему устройства не находят друг друга?

Оставь окно «Принимать» открытым на втором устройстве и проверь, что оба подключены к одной локальной сети. На iPhone разреши Thyron доступ к локальной сети. Гостевая Wi-Fi сеть, изоляция устройств на роутере или VPN могут мешать обнаружению — попробуй обычную домашнюю сеть и повтори поиск.

### Можно восстановить музыку, если устройство потеряно?

У Thyron нет облачного восстановления коллекции. Для такого случая нужна отдельная резервная копия музыкальных файлов. Передача по локальной сети помогает перенести музыку между доступными устройствами, но не заменяет резервное копирование.

## Поддержка

- [Thyron Feedback](https://github.com/E-Bor/thyron-feedback)
- [qwert.zxcqe.iop@mail.ru](mailto:qwert.zxcqe.iop@mail.ru)