Navi Overlay

Navi Overlay is a floating Android music popup designed for navigation apps, car head units, tablets, and phones.
It shows the current track in a compact overlay window and can also work without navigation as a standalone now-playing popup with quick media controls.

🇬🇧 English | 🇷🇺 Русский

---

English

✨ Overview

Navi Overlay displays the current song in a floating overlay window above:

• navigation apps;
• selected apps;
• or even without navigation in floating mode.

It is built for people who want music info and controls visible without constantly switching between the player and the map.

🚗 Perfect For

• Android car head units
• dashboard tablets
• phones used with navigation
• drivers who want quick track visibility with minimal distraction

🔥 Key Features

• 🎵 floating track popup above selected apps
• 🧭 navigation-aware display mode
• 🌐 floating mode without navigation
• ⏮ ⏯ ⏭ media control buttons inside the overlay
• ❤️ Yandex Music like/dislike buttons with position, size, spacing, offset, and color settings
• 👈 👉 swipe left/right to switch tracks
• 🖼 album art support
• 📐 fixed-width mode with two-finger resize
• 🧩 compatibility modes for Standard Android, Topway, and Xiaomi / MIUI
• 📝 text outline, text output format, and marquee speed / delay controls
• 🎨 deep customization for text, colors, borders, fonts, presets, and reaction icon styling
• 🌙 auto-hide timer or always-visible mode
• 🔉 optional volume-dim effect
• 🚘 reverse-camera behavior modes and optional radar dimming
• 📋 built-in diagnostics, system-window recording, and feature descriptions
• 🌍 English and Russian UI

🧩 Main Use Cases

1. Navigation + Music

Show the current track only above selected navigation apps.

2. Floating Music Popup

Use Navi Overlay without navigation as a lightweight always-available now-playing popup.

3. Fixed Overlay Layout

Lock the popup width and resize it with two fingers like zooming an image.

⚙️ Settings Overview

Section	What You Can Configure
Status	Engine summary, current compatibility mode, current app state, and detailed status view
Apps	Navigation apps, audio apps, priority-window apps, and apps that should not hide the overlay
Text settings	Text size, font, bold text, shadow, outline, output format, marquee delay, and marquee speed
Window settings	Transparency, corner radius, border width, offsets, display time, position, design preset, pause behavior, reverse behavior, and fixed window
Color settings	Window, border, text, outline, seek bar, controls, and reaction icon colors
Extra features	Media buttons, swipe tracks, snap, volume dim, radar dim, floating mode, album art, hide with navigation, fixed window, always show, and Yandex Music reactions
Permissions	Overlay, notifications, accessibility, and usage access entry points
Diagnostics	System-window recording, reports, recent tracks, feature descriptions, and setup guide

🎨 Customization Highlights

You can tune:

• text size
• font style
• bold text
• text shadow
• text outline and outline color
• text output format
• marquee delay and marquee speed
• window transparency
• corner radius
• border thickness
• horizontal and vertical offsets
• display duration
• position preset
• design preset
• compatibility mode
• artist/title colors separately
• control border colors

🔐 Permissions

Depending on your setup, Navi Overlay may use:

• Draw over other apps — to display the floating window
• Notification access — to read track data from media notifications
• Accessibility — to detect the active navigation app more accurately
• Usage access — fallback active-app detection on some devices

📥 Installation

1. Download the latest APK from the release page.
2. Install it on your Android device.
3. Grant the required permissions.
4. Select your navigation apps and music players.
5. Customize the overlay and start using it.

📦 Download

➡️ Download Latest APK

🛠 Contributing

Bug reports, pull requests, compatibility notes, and UI/UX suggestions are welcome.
See CONTRIBUTING.md.

🔒 Security

If you found a security-sensitive issue, see SECURITY.md.

---

Русский

✨ Описание

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

🚗 Для кого подходит

• для Android-магнитол;
• для планшетов в машине;
• для телефонов, где одновременно используются музыка и навигация;
• для любого сценария, где хочется быстро видеть текущий трек без лишних переключений.

🔥 Основные возможности

• 🎵 плавающее окно с текущим треком
• 🧭 показ поверх выбранных навигаторов
• 🌐 работа без навигатора в floating-режиме
• ⏮ ⏯ ⏭ кнопки управления музыкой в overlay
• ❤️ кнопки лайка и дизлайка Яндекс Музыки с настройкой положения, размера, цвета и отступов
• 👈 👉 свайп для переключения треков
• 🖼 отображение обложки
• 📐 режим фиксированного размера окна
• 🧩 режимы совместимости для обычного Android, Topway и Xiaomi / MIUI
• 📝 контур текста, формат вывода и отдельные настройки бегущей строки
• 🎨 гибкая настройка текста, цветов, рамки, пресетов и стиля reaction-значков
• 🌙 таймер скрытия или постоянный показ
• 🔉 приглушение окна во время изменения громкости
• 🚘 отдельные режимы поведения окна при заднем ходе и приглушение при антирадаре
• 📋 встроенная диагностика, запись системных окон и описания функций
• 🌍 интерфейс на русском и английском

🧩 Типовые сценарии

1. Музыка поверх навигатора

Окно отображается только поверх выбранных навигационных приложений.

2. Работа без навигатора

Приложение можно использовать как обычное плавающее now-playing окно.

3. Фиксированное окно

Ширину окна можно зафиксировать и менять двумя пальцами, как при увеличении или уменьшении изображения.

⚙️ Краткая карта настроек

Раздел	Что настраивается
Состояние	Сводка по движку, текущий режим совместимости, состояние приложения и подробный статус
Приложения	Навигаторы, музыкальные плееры, приложения с приоритетным окном и приложения, при которых overlay не скрывается
Настройки текста	Размер текста, шрифт, жирный шрифт, тень, контур, формат вывода и настройки бегущей строки
Настройки окна	Прозрачность, скругление, толщина рамки, отступы, время показа, положение, пресет дизайна, поведение при паузе, заднем ходе и фиксированное окно
Настройки цвета	Цвет окна, рамки, текста, контура, seek bar, кнопок и значков лайка/дизлайка
Дополнительные функции	Кнопки, свайп, магнит, приглушение, антирадар, floating, обложка, сворачивание с навигацией, постоянный показ и лайк/дизлайк Я.Музыка
Разрешения	Быстрые переходы к настройкам разрешений
Диагностика	Запись системных окон, отчёты, история треков, описание функций и инструкция по настройке

🎨 Что можно настроить

• размер текста;
• шрифт;
• жирный шрифт;
• тень текста;
• контур текста и его цвет;
• формат вывода текста;
• паузу и скорость бегущей строки;
• прозрачность окна;
• скругление углов;
• толщину рамки;
• горизонтальный и вертикальный отступ;
• время показа;
• положение окна;
• пресет дизайна;
• режим совместимости;
• цвет окна;
• цвет рамки;
• цвет рамок кнопок;
• цвет исполнителя;
• цвет названия песни.

🔐 Разрешения

В зависимости от режима работы приложение может использовать:

• Поверх других приложений
• Доступ к уведомлениям
• Специальные возможности
• Историю использования

📥 Установка

1. Скачай последний APK со страницы релизов.
2. Установи его на устройство Android.
3. Выдай нужные разрешения.
4. Выбери навигаторы и музыкальные приложения.
5. Настрой внешний вид окна и начни пользоваться.

📦 Скачать APK

➡️ Скачать последнюю версию

🛠 Участие в проекте

Если хочешь помочь с улучшением приложения, смотри CONTRIBUTING.md.

🔒 Безопасность

Если найдёшь потенциально чувствительную проблему, смотри SECURITY.md.