FileSlider v1.0

FileSlider é uma ferramenta de slideshow offline/online que lê automaticamente suas imagens e arquivos de música de pastas e fornece uma apresentação de slides no navegador. Ele escala as imagens em várias resoluções (incluindo 4K e FullHD) e gera miniaturas, bem como playlists para música.

---

Download:

Baixar FileSlider v1.0

Instalação & Uso

1. Baixar o projeto

Baixe o projeto completo e descompacte-o em qualquer pasta.
Nota: Se você também quiser usá-lo para a web, é recomendável um nome de pasta em minúsculas e sem espaços.

2. Adicionar Imagens & Música

• Coloque suas imagens originais (JPG, PNG) na pasta images/.
• Coloque seus arquivos de música (MP3, WAV) na pasta music/.

3. Criar Slideshow

• Windows: Dê um duplo clique em start.bat.
• macOS/Linux: Torne start.sh executável (chmod +x start.sh), depois dê um duplo clique ou inicie no terminal:

./start.sh

• macOS (FileSlider.app): Se disponível, basta um duplo clique em
  FileSlider.app. Você pode precisar permitir a execução uma única vez nas configurações de segurança.

4. Processar Imagens & Música

• Um terminal será aberto, onde as imagens serão automaticamente redimensionadas (240px/1920px/3840px).
• Além disso, uma imageList.js será gerada em public/ a partir de todas as imagens; para a música, uma musicList.js.
• Assim que o script terminar, o index.html será aberto no navegador padrão.
• A apresentação de slides também pode ser iniciada manualmente a qualquer momento, abrindo o index.html.

5. Desfrutar do Slideshow

• A apresentação de slides mostra todas as imagens no navegador sem som.
• Um clique na página inicia a música (se houver) e, ao mesmo tempo, alterna para o modo de tela cheia. Por razões de segurança, a maioria dos navegadores exige uma ação para reproduzir música.
• As imagens são ordenadas alfabeticamente. Com nomes apropriados (por exemplo, „001_, 002_...“), você pode controlar a ordem.

---

Como Funciona

• Offline:
  A apresentação de slides funciona completamente offline (nenhum servidor é necessário). As listas geradas (imageList.js, musicList.js) são lidas diretamente pelo navegador.
• Online:
  Se a ferramenta detectar que a página está sendo carregada via HTTP/HTTPS, as imagens de 1920px serão usadas automaticamente para reduzir os tempos de carregamento. A próxima imagem é carregada no cache, garantindo um fluxo suave mesmo com conexão fraca.
• Galeria de Imagens:
  Em slide_show.html, há uma galeria de visão geral compacta (240px). Ao clicar em uma imagem, você inicia a apresentação de slides exatamente naquele ponto. Devido às imagens pequenas, apresentações muito grandes com mais de 1000 imagens são possíveis.
• Novo Conteúdo:
  Se você adicionar novas imagens ou músicas, basta repetir o Passo 3 (executar o script de início). As miniaturas e listas existentes serão atualizadas. Se você quiser remover imagens antigas, exclua-as de images/ e exclua as pastas images-240, images-1920, images-3840 (se necessário). Em seguida, inicie o script novamente.

---

Estrutura de Pastas (Exemplo)

FileSlider/
├─ start.bat             (Script de início para Windows)
├─ start.sh              (Script de início para macOS/Linux)
├─ FileSlider.app        (macOS: Opcional, para iniciar facilmente)
├─ index.html            (Slideshow Principal)
├─ slide_show.html       (Galeria de Visão Geral)
├─ generateImageList.js  (Script Node.js para lista de imagens/músicas)
├─ nodejs/               (Node.js portátil, para que nenhuma instalação seja necessária)
├─ node_modules/         (Contém dependências como 'sharp')
├─ images/               (Imagens originais)
├─ images-240/           (Miniaturas 240px)
├─ images-1920/          (Miniaturas 1920px)
├─ images-3840/          (Miniaturas 3840px)
├─ music/                (Arquivos de música)
└─ public/
   ├─ imageList.js       (Lista de todas as imagens)
   └─ musicList.js       (Lista de todos os arquivos de música)

---

Notas & Dicas

• Textos de Nomes de Arquivo:
  A apresentação de slides exibe automaticamente o nome do arquivo (sem extensão) como título/legenda.
• Múltiplas Resoluções:
  Versões de 240px/1920px/3840px são criadas automaticamente para diferentes dispositivos.
• Janela do Terminal:
  Dependendo do sistema, o terminal permanece aberto para mostrar as saídas de log. Pressione qualquer tecla ou digite exit para fechá-lo.
• Alterações em Tempo, CSS e Função:
  Toda a apresentação pode ser alterada no index.html. Lá você encontrará o CSS, mas também os tempos de exibição por imagem. Em slide_show.html, você encontrará todas as entradas da página de visão geral. Aqui você pode adicionar seus próprios links, imagens, etc., para, por exemplo, comunicar uma dica ou link aos visitantes.

---

Problemas Conhecidos

• Arquivos não encontrados:
  Preste atenção à capitalização (especialmente no Linux).
• Configurações de Segurança do macOS:
  Ao executar FileSlider.app ou start.sh pela primeira vez, um aviso de segurança pode ser exibido. Permita manualmente a execução em „Preferências do Sistema → Segurança e Privacidade“.
• Celulares só entram no modo de tela cheia com relutância, razão pela qual a ferramenta é usada principalmente para shows de fotos em telas e projetores.
• og:image e og:url não são tecnicamente possíveis em um arquivo HTML puro, mas podem ser mantidos por projeto. A integração exigiria a conversão para PHP, o que teria desvantagens significativas, pois só funcionaria com um servidor web.

---

Licença & Créditos

• Software & Scripts FileSlider: © Johann Dirschl / DIRSCHL.com GmbH, 2025.
• Imagens na Demonstração: São propriedade da DIRSCHL.com GmbH e podem ser licenciadas.
• Música via nuonu.com:
  Quem precisa de música livre de royalties também a encontra em nosso site e nuonu.com. Lá há
  muitos curtas e também peças instrumentais criadas com a ajuda de IA. Mas qualquer arquivo de música funciona. Na web, você deve manter os arquivos pequenos (MP3). Offline, você também pode usar arquivos WAV.
• Custos:
  Para nossos clientes, o uso é gratuito. Outros podem baixar e testar músicas, plugins e aplicativos gratuitamente. Se você quiser usá-los comercialmente, pode adquirir uma licença anual (sem expiração) por 49 EUR em nuonu.com → Connect . Teremos prazer em expandir os produtos conforme a necessidade.
• Node.js: © Joyent Inc. / OpenJS Foundation (Node.js portátil é fornecido).
• Dependências: (por exemplo, Sharp) sob suas respectivas licenças de código aberto.

Divirta-se com o FileSlider!