Repository navigation
Releases: starzynhobr/stzlyrics-python
Releases · starzynhobr/stzlyrics-python
Release list
STZ Lyrics Overlay 1.3.0
Novidades
- Nova tela de boas-vindas com visual escuro, prévia animada e escolha entre Mínimo, Detalhado e Contexto (2+2).
- Orientações para começar a ouvir música e encontrar o aplicativo na bandeja do Windows.
- Apresentação nos sete idiomas do aplicativo, com acesso às configurações e opção de reabrir as boas-vindas pela bandeja.
- A apresentação deixa de aparecer automaticamente após clicar em “Começar a usar”, preservando as preferências existentes.
start.batpara iniciar o projeto com a.venvlocal.
Verificação
- 18 testes automatizados passaram.
- Executável empacotado verificado com APPDATA temporário: criação da apresentação inicial e carregamento do estado de conclusão na abertura seguinte.
- Instalador gerado com PyInstaller e Inno Setup 7; versão interna 1.3.0.
- SHA-256 do Setup:
9AB8E438E0E8B20D9A0A843B7BDF815BC3E13B0E927C56EEE5B0D7CEFBBF7E9F.
STZ Lyrics Overlay 1.2.0
Novidades
- Presets Mínimo, Detalhado e Contexto (2+2) acessíveis pelo ícone na bandeja, com posição e monitor lembrados por preset.
- Tela de configurações renovada, com abas, barra de título escura, dicas de uso e confirmação visual ao salvar.
- Ícone STZ Labs no aplicativo, na bandeja e no instalador.
- Proteção contra abertura simultânea de duas instâncias.
- Instalador por usuário gerado com Inno Setup 7 e versão 1.2.0.
Verificação
- 12 testes automatizados passaram.
- O executável empacotado abriu com uma configuração nova isolada e carregou letra sincronizada.
- SHA-256 do Setup:
BFA2C8210AC34FB0871ED6D36C7EFA59053B677424F949A1C5FB862AA729B3D7.
STZ Lyrics Overlay-Setup-1.1.0
This release improves cache handling and day-to-day usability in STZLyrics Overlay. It adds a local cache clear action in Settings with confirmation, a new tray action to reload the current track lyrics, and increases the local lyrics cache size to reduce unnecessary API requests. The default lyrics offset was also updated to 0.10 for a better out-of-the-box sync experience.
STZLyrics Overlay v1.0.0
First public release of STZLyrics Overlay for Windows.
Highlights
- Synced lyrics overlay for Windows 10/11 (GSMTC + LRCLib)
- Transparent overlay with click-through and taskbar snap options
- GUI settings window with localization
- Context preset (
2+2) with configurable transition animation - Per-preset preferences (position, lyric color, always-on-top)
- Optional Start with Windows (current user / HKCU Run)
- Local lyrics cache and tray controls
Requirements
- Windows 10/11
- A media player compatible with Windows Media Session / GSMTC (Spotify usually works well)
Installation
- Download
STZLyricsOverlay-Setup-1.0.0.exe - Run the installer
- Launch the app from Start Menu (or Desktop shortcut)
- Configure overlay behavior in the Settings window
Notes
- Lyric sync quality depends on synced lyric (LRC) availability for the current track.
- Some players (especially Spotify in some situations) may report timeline jitter; the app includes smoothing, but source behavior can still affect precision.
Known limitations
- Not every track has lyrics available.
- Not every available lyric is synced (LRC).
Licensing
This project is dual-licensed (GPLv3 + commercial licensing). See the repository README and LICENSE for details.