MiniPlayer for Browser Music

Mini player para Windows 11 que mostra e controla a música tocando no navegador (YouTube, Spotify Web, SoundCloud, Deezer, ...). Sem extensão: lê os controles de mídia do Windows (SMTC), onde Chrome/Edge/Firefox/Brave/Opera publicam a Media Session.

Recursos

• Título, artista e navegador de origem

• Play/Pause, anterior, próxima, aleatório, repetir (lista → faixa → off)

• Barra de progresso clicável (seek)

• Fixar no topo (📌)

• Redimensionar o player flutuante pelas bordas/cantos; o layout se adapta: achatado vira uma linha só (mini), alto e estreito vira cartão com capa grande, estreito esconde itens secundários (tudo segue no clique direito). Zoom: Ctrl + roda do mouse ou clique direito → Zoom (70%–200%)

• Modo barra de tarefas: player compacto sobre a taskbar, ao lado da bandeja

  • arraste o texto para mover na horizontal; clique direito → menu
  • clique duplo (fora dos botões) → volta ao modo normal
  • várias telas: escolha a barra em clique direito → "Mover para a tela" ou na bandeja → "Barra de tarefas da tela" (requer "Mostrar barra de tarefas em todas as telas" no Windows)
  • some sozinho em tela cheia e com taskbar auto-ocultável escondida
  • cor do texto segue tema claro/escuro do Windows

• Ícone na bandeja: mostrar player, alternar modo, fixar no topo, iniciar com Windows, sair

• Prioriza sessão de navegador tocando; troca automaticamente ao tocar em outra aba

• Escolher aba/app: clique no artista (▾) ou clique direito → "Tocando em"; "Automático" volta ao padrão

• Volume: roda do mouse sobre o player muda o volume só do app que toca (Mixer de Volume); clique do meio = mudo

• Ocultar quando nada toca (modo barra): some após 3 s sem mídia ou 30 s pausado

• Letras sincronizadas (botão 🎤 / "Mostrar letra na barra"): via LRCLIB. Desligado por padrão; quando ligado envia título/artista ao lrclib.net

• Configurações (⚙ no player): janela com abas Geral, Aparência (temas com prévia), Atalhos e controles, Barra de tarefas, Atualizações

• Visualizador: barras de áudio sobre a capa e mini equalizador na barra de tarefas

• Atalhos globais configuráveis (padrão: Ctrl+Alt+Home play/pause, Ctrl+Alt+←/→ faixa, Ctrl+Alt+↑/↓ volume, Ctrl+Alt+M mudo, Ctrl+Alt+P mostrar/ocultar)

• Timer para dormir: minutos ou fim da música, com volume diminuindo aos poucos

• Gestos: roda do mouse = volume ou trocar música; clique do meio = mudo ou play/pause

• Automação: pausa a música em ligações (microfone em uso) e abaixa quando outro app toca som

• Histórico e estatísticas: músicas ouvidas por dia (busca, copiar, buscar no YouTube/Spotify/Deezer) e mais ouvidos por período

• Transmissão (OBS): arquivos "tocando agora" (texto, capa e overlay.html) atualizados a cada troca

• Idiomas: English e Português (Brasil), troca ao vivo em Configurações → Geral (padrão: idioma do Windows)

Temas

5 temas embutidos: Escuro, Claro, Vidro (capa) (capa desfocada no fundo), Neon e Terminal. Escolha em: bandeja → Temas, ou clique direito no player.

Criar um tema

Temas são arquivos .json em %APPDATA%\MiniPlayer\themes (ou numa pasta themes ao lado do exe). A pasta já vem com exemplo-oceano.json comentado. Copie, mude name e as cores — salvar recarrega na hora.

Campo	Exemplo	Descrição
name, author	"Oceano"	Nome no menu e autor
background	"#F21F1F1F"	Cor do fundo (#AARRGGBB aceita transparência)
backgroundGradient	["#082032", "#137C8B"]	Degradê diagonal (substitui background)
border, borderThickness, cornerRadius	"#33FFFFFF", 1, 10	Borda e cantos
foreground, secondaryForeground	"#FFFFFF"	Texto principal e secundário
accent, track, hover	"#60CDFF"	Destaques, trilho do progresso, hover dos botões
coverRadius	6	Cantos da capa
fontFamily	"Cascadia Mono"	Fonte (precisa estar instalada)
shadowOpacity	0.45	Sombra (0 = sem)
backdrop	"none" / "cover" / "image"	Fundo: nada, capa desfocada, ou imagem
backgroundImage	"fundo.png"	Imagem na mesma pasta do tema (com backdrop: "image")
overlay	"#99000000"	Película sobre capa/imagem p/ legibilidade

Temas são só dados (JSON, não XAML), então um tema de terceiros não executa código. Arquivos inválidos aparecem com ⚠ no menu de temas.

Instalação

Baixe MiniPlayer-win-Setup.exe no último release e execute. Instala na pasta do usuário (sem administrador), cria atalhos no Iniciar e na Área de Trabalho e aparece em "Aplicativos instalados" para desinstalar. Não precisa de .NET instalado.

Prefere sem instalar? Use MiniPlayer-win-Portable.zip (sem atualização automática).

Atualizações

O app instalado verifica novas versões ao abrir e a cada 6 h. Quando há uma, mostra uma notificação do Windows com Atualizar agora / Depois — ela fica na central de notificações mesmo com o app fechado, e o botão abre o MiniPlayer e atualiza. Também há o item ⬆ Atualizar para vX na bandeja.

Manter atualizado (bandeja): ao abrir, instala a nova versão sozinho; com o app aberto, só baixa em segundo plano (sem reiniciar no meio da música) e instala na próxima abertura.

Microsoft Store

A versão da Store é gerada pelo mesmo código com -p:StoreBuild=true e empacotada em MSIX (store/build-store.ps1). A Store assina e atualiza o app. Política de privacidade: PRIVACY.md.

Build

Requer .NET 10 SDK e, para empacotar, vpk (dotnet tool install -g vpk).

dotnet build

./release.ps1 -Version 1.2.0                          # gera instalador em ./releases
./release.ps1 -Version 1.2.0 -Notes notas.md -Upload  # publica release v1.2.0 no GitHub

Testar atualização sem publicar: gere duas versões numa pasta e rode o app instalado com MINIPLAYER_UPDATE_SOURCE=<pasta>.

Configurações: %APPDATA%\MiniPlayer\settings.json.

Limitações

• Uma aba por navegador: Chrome/Edge/Firefox publicam só uma aba de mídia por vez. Se a aba publicada for pausada enquanto outra aba do mesmo navegador toca, o player avisa — dê pause/play na outra aba para ela assumir.
• Aleatório/Repetir: navegadores geralmente não expõem esses controles ao Windows, então os botões ficam desabilitados (cinza) para YouTube/Spotify Web etc. Funcionam com apps que suportam (ex.: Spotify desktop).
• Barra de progresso só aparece quando o site informa duração (Media Session setPositionState).
• Windows 11 não permite embutir janelas dentro da taskbar; o modo barra de tarefas é uma janela sempre-no-topo posicionada sobre ela (reafirma posição a cada 0,5 s). Taskbar vertical não é suportada nesse modo.