slideshow-vault 1.3.0__tar.gz

slideshow_vault-1.3.0/.gitignore

@@ -0,0 +1,65 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Nuitka build artifacts
+*.build/
+*.dist/
+*.onefile-build/
+nuitka-crash-report.xml
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Editor / IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing & Cache
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Logs & Reports
+*.log
+*.xml
+
+# Local user data & favorites
+*.xlsx
+*.xlsx.tmp

slideshow_vault-1.3.0/500px - Slideshow.py

@@ -0,0 +1,16 @@
+"""Wrapper de compatibilidade para o antigo 500px - Slideshow.py.
+Executa a nova engine modular do Slideshow Pro.
+"""
+
+import sys
+from pathlib import Path
+
+# Garante inclusão de src no caminho de busca
+src_path = str(Path(__file__).resolve().parent / "src")
+if src_path not in sys.path:
+    sys.path.insert(0, src_path)
+
+from slideshow.cli import main
+
+if __name__ == "__main__":
+    main()

slideshow_vault-1.3.0/COMO_COMPILAR.md

@@ -0,0 +1,60 @@
+# Guia de Compilação de Executáveis (.exe)
+
+O **Slideshow Pro** oferece suporte completo e automatizado para geração de executáveis para Windows tanto pelo **Nuitka** (método preferencial, gera código C nativo otimizado e mais rápido) quanto pelo **PyInstaller** (método tradicional).
+
+---
+
+## 🛠️ Por que o Nuitka falhava anteriormente?
+
+Ao compilar aplicações Tkinter e Pillow no Windows, o Nuitka requer flags específicas que frequentemente causam erros se omitidas:
+1. **Falta do plugin Tkinter** (`--enable-plugin=tk-inter`): Sem este plugin, o Nuitka não empacota os arquivos de suporte `init.tcl`, bibliotecas Tcl/Tk e DLLs, resultando em erro `TclError: Can't find a usable init.tcl` ao abrir o executável.
+2. **Empacotamento de pacotes dinâmicos** (`--include-package=PIL`, `--include-package=openpyxl`, `--include-package=slideshow`): Pillow e openpyxl carregam submódulos dinamicamente que precisam ser incluídos explicitamente.
+3. **Ausência de compilador C no Windows**: O Nuitka compila Python para C e precisa de um compilador (MSVC ou MinGW64). Com a flag `--assume-yes-for-downloads`, o Nuitka baixa e configura automaticamente o MinGW64 oficial sem requerer nenhuma intervenção manual.
+4. **Modo sem console para GUI**: `--windows-console-mode=disable` oculta a janela preta de terminal do DOS.
+
+Todos esses parâmetros já foram integrados e automatizados no [`build.py`](build.py).
+
+---
+
+## 🚀 Como Compilar
+
+### Opção 1: Via Scripts `.bat` (Um Clique)
+
+- Para compilar com **Nuitka** (Preferencial):
+  Basta dar um duplo-clique no arquivo:
+  `build_nuitka.bat`
+
+- Para compilar com **PyInstaller**:
+  Basta dar um duplo-clique no arquivo:
+  `build_pyinstaller.bat`
+
+---
+
+### Opção 2: Via Terminal com `uv`
+
+Com o `uv` instalado, execute no terminal:
+
+```bash
+# Compilação preferencial com Nuitka (usando ambiente isolado)
+uv run --isolated --python 3.12 --with nuitka --with zstandard python build.py --nuitka
+
+# Compilação com PyInstaller
+uv run --isolated --python 3.12 --with pyinstaller python build.py --pyinstaller
+
+# Compilar ambos
+uv run --isolated --python 3.12 --with nuitka --with pyinstaller --with zstandard python build.py --all
+
+# Limpar artefatos temporários de compilação
+uv run python build.py --clean
+```
+
+---
+
+## 📂 Onde encontrar os executáveis gerados?
+
+Após a compilação, os artefatos estarão disponíveis na pasta:
+- `dist/Slideshow/Slideshow.exe` (Pasta portátil com inicialização ultrarrápida)
+- `dist/Slideshow-Portatil.zip` (Arquivo compactado pronto para envio a outras pessoas)
+- `dist/Slideshow-PyInstaller.exe` (Executável alternativo via PyInstaller)
+
+O aplicativo portátil pode ser transportado ou compartilhado para qualquer computador com Windows sem necessidade de ter o Python ou o `uv` instalados. Basta descompactar o `.zip` e executar `Slideshow.exe`.

slideshow_vault-1.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Slideshow Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

slideshow_vault-1.3.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.5
+Name: slideshow-vault
+Version: 1.3.0
+Summary: Apresentador de slides moderno, resiliente a OneDrive Personal Vault, com transições suaves, favoritos em SQLite (com exportação/importação Excel) e controle avançado.
+Author: Slideshow Developer
+License: MIT
+License-File: LICENSE
+Keywords: ken-burns,onedrive,personal-vault,photo-viewer,slideshow,tkinter
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics :: Viewers
+Requires-Python: >=3.9
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: pillow>=10.0.0
+Provides-Extra: build
+Requires-Dist: nuitka>=2.0.0; extra == 'build'
+Requires-Dist: pyinstaller>=6.0.0; extra == 'build'
+Requires-Dist: zstandard; extra == 'build'
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Slideshow Pro
+
+Um apresentador de slides moderno, resiliente, modular e extensível para Windows e Linux, com suporte aprofundado ao **Cofre Pessoal (Personal Vault) do OneDrive**, transições audiovisuais cinematográficas e sistema de favoritos em SQLite com exportação/importação para Excel.
+
+---
+
+## 🌟 Principais Recursos
+
+- **Módulo Python Reutilizável**: Instale via `pip`/`uv` ou importe diretamente em outros programas (`from slideshow import run_slideshow`).
+- **Resiliência ao Cofre Pessoal do OneDrive**:
+  - Detecção inteligente do estado do cofre (montado vs. bloqueado/desmontado).
+  - Identificação de arquivos em nuvem (*Files On-Demand* desidratados).
+  - **Buffer em RAM condicional com teto de 1 GB**: lê fotos para a memória na inicialização se estiverem no cofre, evitando que o fechamento por inatividade (20 min) do BitLocker interrompa a reprodução.
+  - Se for uma pasta comum, lê sob demanda do disco com consumo mínimo de memória.
+- **Transições Suaves**:
+  - **Crossfade**: Dissolvência suave entre imagens via interpolação de canais.
+  - **Dura**: Corte seco tradicional.
+  - **Fade to Black**: Esmaecimento para o preto.
+- **Modos de Enquadramento**:
+  - **Ajustar (Fit)**: Imagem inteira visível sem distorção.
+  - **Zoom / Preencher (Fill)**: Cobre 100% da janela centralizada.
+  - **Panorâmico (Ken Burns Pan & Scan)**: A foto preenche a janela e se move suavemente de uma borda a outra durante o slide.
+- **Histórico Infinito no Modo Aleatório**:
+  - O botão de voltar (Seta Esquerda) funciona retroativamente por toda a trilha de fotos exibidas, sem limite.
+- **Sistema de Likes, Unlikes e Favoritos em SQLite**:
+  - Registrado automaticamente no banco `~/slideshow_favoritos.db` (gravação transacional, sem risco de corromper o arquivo).
+  - **Exportar (`Ctrl+E`)**: gera uma planilha `.xlsx` (abas `Favoritos`, `Unlikes`, `Configuracoes`).
+  - **Importar (`Ctrl+I`)**: lê um `.xlsx` e **substitui tudo** (favoritos, unlikes e configurações) após confirmação. Planilha inválida não altera nada.
+  - Via linha de comando: `--export-favorites ARQ.xlsx` e `--import-favorites ARQ.xlsx`.
+  - **Like (`L`)**: adiciona aos favoritos. Se a foto possuir Unlike, o primeiro toque cancela o unlike.
+  - **Unlike (`U`)**: marca como unlike. Se a foto possuir Like, o primeiro toque desfaz o like.
+  - **Ícones de Status Visuais**: exibe ❤️ (Like) ou ❌ (Unlike) no canto superior direito (alternável via tecla **`I`**).
+  - **Filtro Trilateral (`F`)**: alterna entre *Todas as Fotos*, *Apenas Favoritas* e *Apenas Unlikes*.
+  - **Exclusão em Lote (`Shift+Delete`)**: quando no modo de filtro *Apenas Unlikes*, permite listar e apagar permanentemente todas as fotos com unlike do disco após confirmação segura.
+- **Persistência Automática de Preferências**:
+  - Salva automaticamente as últimas configurações (velocidade, enquadramento, transição, ordem, legenda, tela cheia, fixação no topo e melhoria de baixa resolução) no banco do usuário.
+  - Ao abrir o Slideshow novamente, suas preferências são restauradas instantaneamente.
+- **Otimização Inteligente de Fotos em Baixa Resolução (`E`)**:
+  - Reescalonamento Lanczos de alta precisão, filtro Unsharp Mask adaptativo, granulação analógica suave (Film Grain) e desfoque de fundo ambiente.
+- **Janela de Ajuda Interativa (`F1`) e Controle com `Esc`**:
+  - A tecla **`F1`** abre e fecha a documentação de atalhos (*Toggle*).
+  - A tecla **`Esc`** fecha prioritariamente a janela de ajuda sem sair da tela cheia ou encerrar o slideshow.
+- **Compilável com Nuitka e PyInstaller**: Scripts prontos para gerar executável standalone para Windows.
+
+---
+
+## 🚀 Instalação e Execução
+
+### Usando o `uv` (Recomendado)
+```bash
+# Execução direta informando a pasta de imagens
+uv run python -m slideshow -p "C:\Fotos"
+
+# A partir de qualquer diretório no sistema
+uv run --project "C:\caminho\para\slideshow" python -m slideshow -p "C:\Fotos"
+
+# Com opções de enquadramento panorâmico, transição suave e tela cheia
+uv run python -m slideshow -p "C:\Fotos" -d 4.0 --fullscreen -m panoramic -t crossfade
+
+# Ao executar sem argumentos, o seletor gráfico de pastas abrirá automaticamente
+uv run python -m slideshow
+```
+
+### Como Módulo em Outros Projetos
+```python
+from slideshow import run_slideshow
+
+# Chamada simples
+run_slideshow(folder=r"C:\MinhasFotos", delay=4.0, fullscreen=True)
+
+# Chamada com opções avançadas e suporte a Cofre Pessoal
+run_slideshow(
+    folder=r"C:\MinhasFotos",
+    delay=5.0,
+    framing="panoramic",
+    transition="crossfade",
+    order="random",
+    ram_limit_mb=1024
+)
+```
+
+---
+
+## ⌨️ Atalhos de Teclado
+
+| Tecla | Ação |
+| :--- | :--- |
+| **`F1`** | Abre / fecha a janela de ajuda flutuante (**Toggle**) |
+| **`F11`** | Alterna o modo de Tela Cheia |
+| **`Espaço`** | Pausar / Retomar apresentação |
+| **`Seta Esquerda`** | Foto anterior (**Histórico Infinito**) |
+| **`Seta Direita`** | Próxima foto |
+| **`Seta Cima / Baixo`** | Acelerar / desacelerar intervalo |
+| **`D`** | Digitar intervalo de tempo personalizado em segundos |
+| **`O`** | Alternar ordem (Aleatória / Data / Alfabética) |
+| **`L`** | Like ❤️ (Se possuir Unlike, o 1º aperto desfaz o unlike) |
+| **`U`** | Unlike ❌ (Se possuir Like, o 1º aperto desfaz o like) |
+| **`F`** | Alternar filtro: **Todas as Fotos** ➔ **Apenas Favoritas** ➔ **Apenas Unlikes** |
+| **`I`** | Alternar exibição dos Ícones de Status (**❤️** / **❌**) no canto superior direito |
+| **`Shift+Delete`** | Apagar permanentemente do disco todas as fotos com Unlike (ativo no filtro Unlikes) |
+| **`E`** | Alternar Otimização de Baixa Resolução (Nitidez, Grão e Fundo Suave) |
+| **`C`** | Alternar legenda (Oculta / Compacta / Detalhada) |
+| **`M`** | Alternar modo de enquadramento (Ajustar / Zoom / Panorâmico) |
+| **`X`** | Alternar estilo de transição (Suave Crossfade / Dura / Fade) |
+| **`T` / `P`** | Alternar janela sempre no topo (Sempre Visível) |
+| **`Esc`** | Fecha janela de ajuda (se aberta) / sai da tela cheia / encerra |
+
+---
+
+## 🔍 Ferramenta de Diagnóstico do Cofre OneDrive
+
+Para testar e inspecionar o status de acesso e atributos dos arquivos de qualquer diretório:
+
+```bash
+uv run slideshow --check-vault -p "C:\caminho\para\pasta"
+```
+
+---
+
+## 📦 Construção de Executáveis (.exe)
+
+Consulte o arquivo [`COMO_COMPILAR.md`](COMO_COMPILAR.md) para instruções completas sobre compilação com **Nuitka** (preferencial) e **PyInstaller**.
+
+---
+
+## 📄 Licença
+Distribuído sob a licença MIT. Veja `LICENSE` para mais detalhes.

slideshow_vault-1.3.0/README.md

@@ -0,0 +1,127 @@
+# Slideshow Pro
+
+Um apresentador de slides moderno, resiliente, modular e extensível para Windows e Linux, com suporte aprofundado ao **Cofre Pessoal (Personal Vault) do OneDrive**, transições audiovisuais cinematográficas e sistema de favoritos em SQLite com exportação/importação para Excel.
+
+---
+
+## 🌟 Principais Recursos
+
+- **Módulo Python Reutilizável**: Instale via `pip`/`uv` ou importe diretamente em outros programas (`from slideshow import run_slideshow`).
+- **Resiliência ao Cofre Pessoal do OneDrive**:
+  - Detecção inteligente do estado do cofre (montado vs. bloqueado/desmontado).
+  - Identificação de arquivos em nuvem (*Files On-Demand* desidratados).
+  - **Buffer em RAM condicional com teto de 1 GB**: lê fotos para a memória na inicialização se estiverem no cofre, evitando que o fechamento por inatividade (20 min) do BitLocker interrompa a reprodução.
+  - Se for uma pasta comum, lê sob demanda do disco com consumo mínimo de memória.
+- **Transições Suaves**:
+  - **Crossfade**: Dissolvência suave entre imagens via interpolação de canais.
+  - **Dura**: Corte seco tradicional.
+  - **Fade to Black**: Esmaecimento para o preto.
+- **Modos de Enquadramento**:
+  - **Ajustar (Fit)**: Imagem inteira visível sem distorção.
+  - **Zoom / Preencher (Fill)**: Cobre 100% da janela centralizada.
+  - **Panorâmico (Ken Burns Pan & Scan)**: A foto preenche a janela e se move suavemente de uma borda a outra durante o slide.
+- **Histórico Infinito no Modo Aleatório**:
+  - O botão de voltar (Seta Esquerda) funciona retroativamente por toda a trilha de fotos exibidas, sem limite.
+- **Sistema de Likes, Unlikes e Favoritos em SQLite**:
+  - Registrado automaticamente no banco `~/slideshow_favoritos.db` (gravação transacional, sem risco de corromper o arquivo).
+  - **Exportar (`Ctrl+E`)**: gera uma planilha `.xlsx` (abas `Favoritos`, `Unlikes`, `Configuracoes`).
+  - **Importar (`Ctrl+I`)**: lê um `.xlsx` e **substitui tudo** (favoritos, unlikes e configurações) após confirmação. Planilha inválida não altera nada.
+  - Via linha de comando: `--export-favorites ARQ.xlsx` e `--import-favorites ARQ.xlsx`.
+  - **Like (`L`)**: adiciona aos favoritos. Se a foto possuir Unlike, o primeiro toque cancela o unlike.
+  - **Unlike (`U`)**: marca como unlike. Se a foto possuir Like, o primeiro toque desfaz o like.
+  - **Ícones de Status Visuais**: exibe ❤️ (Like) ou ❌ (Unlike) no canto superior direito (alternável via tecla **`I`**).
+  - **Filtro Trilateral (`F`)**: alterna entre *Todas as Fotos*, *Apenas Favoritas* e *Apenas Unlikes*.
+  - **Exclusão em Lote (`Shift+Delete`)**: quando no modo de filtro *Apenas Unlikes*, permite listar e apagar permanentemente todas as fotos com unlike do disco após confirmação segura.
+- **Persistência Automática de Preferências**:
+  - Salva automaticamente as últimas configurações (velocidade, enquadramento, transição, ordem, legenda, tela cheia, fixação no topo e melhoria de baixa resolução) no banco do usuário.
+  - Ao abrir o Slideshow novamente, suas preferências são restauradas instantaneamente.
+- **Otimização Inteligente de Fotos em Baixa Resolução (`E`)**:
+  - Reescalonamento Lanczos de alta precisão, filtro Unsharp Mask adaptativo, granulação analógica suave (Film Grain) e desfoque de fundo ambiente.
+- **Janela de Ajuda Interativa (`F1`) e Controle com `Esc`**:
+  - A tecla **`F1`** abre e fecha a documentação de atalhos (*Toggle*).
+  - A tecla **`Esc`** fecha prioritariamente a janela de ajuda sem sair da tela cheia ou encerrar o slideshow.
+- **Compilável com Nuitka e PyInstaller**: Scripts prontos para gerar executável standalone para Windows.
+
+---
+
+## 🚀 Instalação e Execução
+
+### Usando o `uv` (Recomendado)
+```bash
+# Execução direta informando a pasta de imagens
+uv run python -m slideshow -p "C:\Fotos"
+
+# A partir de qualquer diretório no sistema
+uv run --project "C:\caminho\para\slideshow" python -m slideshow -p "C:\Fotos"
+
+# Com opções de enquadramento panorâmico, transição suave e tela cheia
+uv run python -m slideshow -p "C:\Fotos" -d 4.0 --fullscreen -m panoramic -t crossfade
+
+# Ao executar sem argumentos, o seletor gráfico de pastas abrirá automaticamente
+uv run python -m slideshow
+```
+
+### Como Módulo em Outros Projetos
+```python
+from slideshow import run_slideshow
+
+# Chamada simples
+run_slideshow(folder=r"C:\MinhasFotos", delay=4.0, fullscreen=True)
+
+# Chamada com opções avançadas e suporte a Cofre Pessoal
+run_slideshow(
+    folder=r"C:\MinhasFotos",
+    delay=5.0,
+    framing="panoramic",
+    transition="crossfade",
+    order="random",
+    ram_limit_mb=1024
+)
+```
+
+---
+
+## ⌨️ Atalhos de Teclado
+
+| Tecla | Ação |
+| :--- | :--- |
+| **`F1`** | Abre / fecha a janela de ajuda flutuante (**Toggle**) |
+| **`F11`** | Alterna o modo de Tela Cheia |
+| **`Espaço`** | Pausar / Retomar apresentação |
+| **`Seta Esquerda`** | Foto anterior (**Histórico Infinito**) |
+| **`Seta Direita`** | Próxima foto |
+| **`Seta Cima / Baixo`** | Acelerar / desacelerar intervalo |
+| **`D`** | Digitar intervalo de tempo personalizado em segundos |
+| **`O`** | Alternar ordem (Aleatória / Data / Alfabética) |
+| **`L`** | Like ❤️ (Se possuir Unlike, o 1º aperto desfaz o unlike) |
+| **`U`** | Unlike ❌ (Se possuir Like, o 1º aperto desfaz o like) |
+| **`F`** | Alternar filtro: **Todas as Fotos** ➔ **Apenas Favoritas** ➔ **Apenas Unlikes** |
+| **`I`** | Alternar exibição dos Ícones de Status (**❤️** / **❌**) no canto superior direito |
+| **`Shift+Delete`** | Apagar permanentemente do disco todas as fotos com Unlike (ativo no filtro Unlikes) |
+| **`E`** | Alternar Otimização de Baixa Resolução (Nitidez, Grão e Fundo Suave) |
+| **`C`** | Alternar legenda (Oculta / Compacta / Detalhada) |
+| **`M`** | Alternar modo de enquadramento (Ajustar / Zoom / Panorâmico) |
+| **`X`** | Alternar estilo de transição (Suave Crossfade / Dura / Fade) |
+| **`T` / `P`** | Alternar janela sempre no topo (Sempre Visível) |
+| **`Esc`** | Fecha janela de ajuda (se aberta) / sai da tela cheia / encerra |
+
+---
+
+## 🔍 Ferramenta de Diagnóstico do Cofre OneDrive
+
+Para testar e inspecionar o status de acesso e atributos dos arquivos de qualquer diretório:
+
+```bash
+uv run slideshow --check-vault -p "C:\caminho\para\pasta"
+```
+
+---
+
+## 📦 Construção de Executáveis (.exe)
+
+Consulte o arquivo [`COMO_COMPILAR.md`](COMO_COMPILAR.md) para instruções completas sobre compilação com **Nuitka** (preferencial) e **PyInstaller**.
+
+---
+
+## 📄 Licença
+Distribuído sob a licença MIT. Veja `LICENSE` para mais detalhes.

slideshow_vault-1.3.0/build.py

@@ -0,0 +1,154 @@
+"""Script de automação de compilação do executável com Nuitka e PyInstaller."""
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT_DIR = Path(__file__).resolve().parent
+ENTRY_POINT = ROOT_DIR / "run.py"
+DIST_DIR = ROOT_DIR / "dist"
+
+
+def run_command(cmd, desc):
+    print(f"\n==================================================")
+    print(f"[{desc}] Executando: {' '.join(cmd)}")
+    print(f"==================================================\n")
+    res = subprocess.run(cmd, cwd=str(ROOT_DIR))
+    if res.returncode != 0:
+        print(f"\n[ERRO] Falha ao executar: {desc} (Código {res.returncode})")
+        sys.exit(res.returncode)
+    print(f"\n[SUCESSO] {desc} concluído com sucesso!")
+
+
+def clean_artifacts():
+    print("[Limpeza] Removendo pastas de compilação temporárias...")
+    dirs_to_clean = [
+        ROOT_DIR / "build",
+        ROOT_DIR / "run.build",
+        ROOT_DIR / "run.dist",
+        ROOT_DIR / "run.onefile-build",
+        ROOT_DIR / "Slideshow.build",
+        ROOT_DIR / "Slideshow.dist",
+        ROOT_DIR / "Slideshow.onefile-build",
+    ]
+    for d in dirs_to_clean:
+        if d.exists() and d.is_dir():
+            shutil.rmtree(d, ignore_errors=True)
+            print(f" - Removido: {d.name}")
+
+
+def build_nuitka():
+    clean_artifacts()
+    DIST_DIR.mkdir(exist_ok=True)
+    icon_path = ROOT_DIR / "src" / "slideshow" / "assets" / "icon.ico"
+
+    # Remove pasta dist/Slideshow anterior se existir, deixando apenas o executável único
+    old_folder = DIST_DIR / "Slideshow"
+    if old_folder.exists() and old_folder.is_dir():
+        shutil.rmtree(old_folder, ignore_errors=True)
+        print(" - Removida pasta dist/Slideshow anterior.")
+
+    old_zip = DIST_DIR / "Slideshow-Portatil.zip"
+    if old_zip.exists():
+        old_zip.unlink(missing_ok=True)
+
+    # Parâmetros otimizados do Nuitka para modo onefile (executável único) no Windows
+    cmd = [
+        sys.executable,
+        "-m", "nuitka",
+        "--onefile",
+        "--windows-console-mode=disable",
+        "--enable-plugin=tk-inter",
+        "--include-package=slideshow",
+        "--include-package-data=slideshow",
+        "--include-package=PIL",
+        "--include-package=openpyxl",
+        "--assume-yes-for-downloads",
+        f"--output-dir={DIST_DIR}",
+        "--output-filename=Slideshow.exe",
+    ]
+    # Localiza pastas Tcl/Tk para garantir empacotamento completo do Tkinter no Windows
+    prefix = Path(sys.base_prefix)
+    tcl_cand = prefix / "tcl"
+    tcl_dir = None
+    tk_dir = None
+    if tcl_cand.exists():
+        for sub in tcl_cand.iterdir():
+            if sub.is_dir():
+                if (sub / "init.tcl").exists() and not tcl_dir:
+                    tcl_dir = str(sub)
+                elif sub.name.lower().startswith("tk") and not tk_dir:
+                    tk_dir = str(sub)
+
+    if tcl_dir:
+        cmd.append(f"--tcl-library-dir={tcl_dir}")
+    if tk_dir:
+        cmd.append(f"--tk-library-dir={tk_dir}")
+
+    if icon_path.exists():
+        cmd.append(f"--windows-icon-from-ico={icon_path}")
+
+    cmd.append(str(ENTRY_POINT))
+    run_command(cmd, "Compilação com Nuitka")
+
+    exe_target = DIST_DIR / "Slideshow.exe"
+    print(f"\n[SUCESSO] Executável único gerado com sucesso em: {exe_target}")
+
+
+def build_pyinstaller():
+    clean_artifacts()
+    DIST_DIR.mkdir(exist_ok=True)
+    icon_path = ROOT_DIR / "src" / "slideshow" / "assets" / "icon.ico"
+
+    cmd = [
+        sys.executable,
+        "-m", "PyInstaller",
+        "--onefile",
+        "--noconsole",
+        "--clean",
+        "--name", "Slideshow-PyInstaller",
+        f"--distpath={DIST_DIR}",
+        f"--paths={ROOT_DIR / 'src'}",
+        "--collect-all", "slideshow",
+        "--collect-all", "PIL",
+        "--collect-all", "openpyxl",
+    ]
+    if icon_path.exists():
+        cmd.append(f"--icon={icon_path}")
+
+    cmd.append(str(ENTRY_POINT))
+    run_command(cmd, "Compilação com PyInstaller")
+    print(f"\nExecutável gerado em: {DIST_DIR / 'Slideshow-PyInstaller.exe'}")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Automação de compilação do Slideshow Pro")
+    parser.add_argument("--nuitka", action="store_true", help="Compilar executável usando Nuitka (Preferencial)")
+    parser.add_argument("--pyinstaller", action="store_true", help="Compilar executável usando PyInstaller")
+    parser.add_argument("--all", action="store_true", help="Compilar ambas as versões (Nuitka e PyInstaller)")
+    parser.add_argument("--clean", action="store_true", help="Apenas limpar arquivos e pastas temporárias de build")
+
+    args = parser.parse_args()
+
+    if args.clean:
+        clean_artifacts()
+        return
+
+    if args.all:
+        build_nuitka()
+        build_pyinstaller()
+    elif args.nuitka:
+        build_nuitka()
+    elif args.pyinstaller:
+        build_pyinstaller()
+    else:
+        # Padrão: compilar preferencialmente com Nuitka
+        print("Nenhuma opção especificada. Utilizando Nuitka por padrão.")
+        build_nuitka()
+
+
+if __name__ == "__main__":
+    main()

slideshow_vault-1.3.0/build_nuitka.bat

@@ -0,0 +1,8 @@
+@echo off
+chcp 65001 > nul
+echo ========================================================
+echo   Compilando Slideshow com Nuitka (via uv)
+echo ========================================================
+uv run --isolated --python 3.12 --with nuitka --with zstandard python build.py --nuitka
+echo.
+pause

slideshow_vault-1.3.0/build_pyinstaller.bat

@@ -0,0 +1,8 @@
+@echo off
+chcp 65001 > nul
+echo ========================================================
+echo   Compilando Slideshow com PyInstaller (via uv)
+echo ========================================================
+uv run --isolated --python 3.12 --with pyinstaller python build.py --pyinstaller
+echo.
+pause

slideshow_vault-1.3.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "slideshow-vault"
+version = "1.3.0"
+description = "Apresentador de slides moderno, resiliente a OneDrive Personal Vault, com transições suaves, favoritos em SQLite (com exportação/importação Excel) e controle avançado."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "Slideshow Developer" }
+]
+keywords = ["slideshow", "onedrive", "personal-vault", "photo-viewer", "tkinter", "ken-burns"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: Microsoft :: Windows",
+    "Topic :: Multimedia :: Graphics :: Viewers",
+]
+dependencies = [
+    "pillow>=10.0.0",
+    "openpyxl>=3.1.0",
+]
+
+[project.optional-dependencies]
+build = [
+    "nuitka>=2.0.0",
+    "pyinstaller>=6.0.0",
+    "zstandard",
+]
+dev = [
+    "pytest>=7.0.0",
+]
+
+[project.scripts]
+slideshow = "slideshow.cli:main"
+slideshow-diag = "slideshow.vault:main_diag"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/slideshow"]

slideshow_vault-1.3.0/run.py

@@ -0,0 +1,14 @@
+"""Script de inicialização direta para execução e compilação do executável."""
+
+import sys
+from pathlib import Path
+
+# Adiciona o diretório 'src' ao sys.path para garantir importação em qualquer ambiente
+src_path = str(Path(__file__).resolve().parent / "src")
+if src_path not in sys.path:
+    sys.path.insert(0, src_path)
+
+from slideshow.cli import main
+
+if __name__ == "__main__":
+    main()