Nesta página

Personalizar Botões da Barra de Controle

Visão Geral

A Barra de Controle é dividida em duas partes:

  • Esquerda (nível de arquivo): Integração com aplicativos externos e ações rápidas (por exemplo, "Abrir com...", "Mostrar no Explorador de Arquivos"). São configuráveis em Configurações - Controles.
  • Direita (nível de visualização): Controles da área de visualização (por exemplo, girar, mudo, zoom).

Este guia tem como foco a personalização da seção Esquerda.

Adicionar Controles

Em Configurações - Controles, você pode gerenciar botões integrados, criar ações personalizadas ou instalar plugins de controle.

1. Ações Personalizadas

  1. Clique em + abaixo da lista de ações e selecione o programa ou script a ser executado.
  2. Configure os detalhes da ação no painel direito:
    • Nome: Nome de exibição mostrado nas dicas de ferramenta.
    • Executável: Caminho para o executável de destino (.exe).
    • Argumentos: Argumentos de linha de comando. Use marcadores como "${input_file}" para passar os caminhos de arquivos.
    • Formatos de Arquivo: Extensões de arquivo de destino (por exemplo, png, zip) ou Tokens Especiais (por exemplo, ${type_folder}).
    • Fechar janela após iniciar com sucesso: Fecha a janela de pré-visualização assim que o programa externo iniciar com êxito. O Seer não aguarda a finalização do programa.

2. Plugins de Controle

Plugins de controle fornecem ações empacotadas prontas. Eles são separados das ações personalizadas, que utilizam um programa ou script que você já possui.

Plugins de controle oficiais

Os pacotes oficiais de plugins de controle estão reunidos na central de downloads. Acesse Downloads de plugins - Controles para baixar os arquivos .zip. Eles podem ser importados diretamente sem descompactar.

Instalar o Arquivo Baixado

  1. Em Configurações > Controles, clique em + abaixo da lista.
  2. Selecione o .zip baixado diretamente ou selecione plugin.json de um pacote extraído completo.
  3. Revise os formatos suportados e o comportamento da ação importada no painel de detalhes.
  4. Clique em OK para salvar e usar. Clicar em Cancelar descarta a importação.

Se um pacote fornecer um recurso diferente, o Seer direcionará você para a página de configurações correspondente.

Gerenciar Ações

  • Reordenar: Arraste e solte itens na lista para reorganizar a ordem dos botões na Barra de Controle.
  • Ativar/Desativar: Selecione uma ação e alterne a opção Ativado em seus detalhes, salvando as alterações em seguida.
  • Personalizar Regras: Para plugins instalados, você pode alterar os formatos de arquivo vinculados e os argumentos CLI, ou restaurar os valores padrão a qualquer momento.
  • Botões Integrados: Ações nativas (Abrir com Aplicativo Padrão, Revelar no Explorador de Arquivos, Navegação no Mesmo Tipo) podem ser ativadas ou desativadas individualmente.

Marcadores de Posição e Tokens Especiais

1. Marcadores de Linha de Comando

O Seer disponibiliza tokens internos que são resolvidos dinamicamente ao iniciar ferramentas externas:

Marcador Descrição Exemplo
${input_file} Caminho absoluto do arquivo ou pasta pré-visualizado. C:\Users\Username\Documents\file.zip
${7z} Caminho absoluto para o 7z.exe integrado. Também aceito no campo Executável. C:\Program Files\Seer\plugins\7z.exe
${seer_exe} Caminho absoluto para Seer.exe. C:\Program Files\Seer\Seer.exe
${seerviewer_exe} Caminho absoluto para SeerViewer.exe. C:\Program Files\Seer\SeerViewer.exe
${seer_dir} Diretório contendo Seer.exe. C:\Program Files\Seer
${screenshot} Caminho absoluto para uma captura de tela PNG temporária da visualização atual. C:\Users\Username\AppData\Local\Temp\Seer\screenshot\view_1.png

Se um caminho puder conter espaços, coloque o marcador entre aspas duplas: "${input_file}".

Desenvolvendo seu próprio plugin de controle? Consulte Desenvolvimento e Implementação de Plugins para obter a matriz completa de marcadores de posição e tokens de correspondência, incluindo quais marcadores são suportados por cada capacidade de plugin.

2. Tokens Especiais de Formato de Arquivo

Use estes tokens no campo Formatos de Arquivo para corresponder a tipos de arquivo ou pastas não convencionais:

Token Descrição
${type_folder} Corresponde a diretórios e pastas.
${type_file} Corresponde a todos os arquivos (incluindo arquivos sem extensão).
${type_all} Corresponde a tudo (tanto arquivos quanto pastas).
${type_pdf} Corresponde a documentos PDF.
${type_image} Corresponde a arquivos de imagem, classificados como o visualizador de imagens integrado.
${type_media} Corresponde a arquivos de áudio/vídeo, classificados como o visualizador de mídia integrado.
${type_web} Corresponde a páginas da web (HTML e Markdown), classificadas como o visualizador HTML integrado.
${type_text} Corresponde a arquivos de texto/código, classificados como o visualizador de texto integrado.
${type_none} Corresponde a arquivos que não pertencem a nenhuma das categorias acima (ex.: compactados, executáveis).

Observação: Os tokens não diferenciam maiúsculas de minúsculas e podem ser combinados com extensões de arquivos usando espaços ou vírgulas (por exemplo, png jpg ${type_folder}).

Os tokens de categoria ${type_*} classificam arquivos pela extensão usando as mesmas tabelas dos visualizadores integrados; eles correspondem apenas a arquivos — combine com ${type_folder} se também precisar de pastas.

3. Exemplo de Configuração: Extrair Arquivo com o 7-Zip

Para adicionar um botão que descompacta arquivos usando o 7-Zip integrado:

  1. Executável: ${7z} (ou localize o seu próprio 7z.exe).
  2. Argumentos: x "${input_file}" -r -y -o"C:\Output\Path\"
  3. Formatos de Arquivo: zip rar 7z tar gz

Detalhamento dos Parâmetros: * x: Extrair com caminhos completos. * "${input_file}": Arquivo de arquivo comprimido de destino. * -r: Percorrer subdiretórios recursivamente. * -y: Assumir resposta Sim para todas as perguntas (sobrescrever). * -o"...": Diretório de saída.