Errant Launcher — Guia do usuário

1. Sobre este guia

O que é o Errant Launcher. É um aplicativo portátil para Windows que reúne em uma única janela cartões para executar e abrir objetos de uso frequente: programas, scripts, pastas, arquivos, comandos, links e instaladores MSI. Os cartões podem ser organizados em seções e categorias. O aplicativo não precisa ser instalado; sua pasta pode ser transportada, por exemplo, em um pen drive.

Como usar este guia. Você pode ler em sequência — a partir de «Primeiros passos» — ou abrir a seção necessária conforme a necessidade. Em todo lugar há links para seções relacionadas.

Conteúdo

Convenções do texto:

  • nomes de botões, campos e itens de menu aparecem entre aspas, por exemplo «Executar», «Editor», «Salvar»;
  • Importante — aviso sobre possível perda de dados ou ação irreversível;
  • Dica — sugestão para usar o aplicativo de forma mais prática.

2. Primeiros passos

2.1. Primeira execução

Execute o arquivo ErrantLauncher-x64.exe. Não é preciso instalar: o aplicativo é portátil. Ao lado do arquivo ele criará sua pasta de dados — ali ficarão as configurações, os cartões e os ícones (veja detalhes na seção «Armazenamento de dados»).

Se você executar o aplicativo novamente enquanto ele já está rodando, uma segunda janela não é criada. A janela existente é trazida para a frente (ou restaurada da bandeja do sistema).

2.2. O que você vê ao abrir

A janela principal consiste em várias áreas:

  • no topo — a barra de título com os botões «minimizar», «maximizar/restaurar», «fechar»;
  • à esquerda — um painel lateral com o item «Favoritos» e a lista de seções;
  • abaixo do título — as «pílulas» redondas de categorias da seção selecionada;
  • no canto superior direito — o campo «Buscar…», os botões «Editor», de ordenação e de configurações;
  • no centro — a grade de cartões;
  • no canto inferior esquerdo — o botão de status que abre o painel informativo.

No canto inferior direito podem aparecer etiquetas indicadoras: «Modo administrador» (o aplicativo está rodando como administrador), «Somente leitura» e «Sem mídia» (problemas com a pasta de dados — veja a seção «Solução de problemas»).

2.3. Como os dados são organizados — em palavras simples

  • Cartão — um botão na grade que executa ou abre uma única coisa: um programa, uma pasta, um link etc.
  • Categoria — um subgrupo dentro de uma seção (as pílulas acima da grade).
  • Seção — o nível superior de agrupamento (a lista à esquerda).
  • Favoritos — uma visão separada que reúne os cartões marcados de todas as seções.

2.4. Primeiras ações

  1. Abra «Editor» → aba «Estrutura» → «Adicionar seção» e «Adicionar categoria» — crie a estrutura para as suas tarefas.
  2. Volte à janela principal, escolha uma seção e uma categoria.
  3. Adicione seu primeiro cartão — por qualquer um dos métodos da seção 6.
  4. Ajuste a aparência pelo botão de configurações (tema, cor de destaque).

2.5. Como criar seu primeiro cartão

A forma mais rápida — arrastar o arquivo de um programa (.exe) diretamente para a janela do Errant Launcher: o cartão aparecerá na seção e categoria atuais. Segunda forma: «Editor» → «Adicionar cartão» → escolher o tipo → preencher os campos → «Salvar». Detalhes na seção 6.

3. Interface e navegação

3.1. Janela principal

A janela pode ser arrastada por uma área livre da barra superior. Os botões no canto superior direito minimizam, maximizam e fecham a janela. Se a minimização para a bandeja estiver ativada (veja a seção «Configurações»), o botão «Fechar» esconde a janela na bandeja do sistema em vez de encerrar o aplicativo.

3.2. Painel lateral

A lista à esquerda mostra «Favoritos» e todas as seções visíveis. Um clique numa seção a seleciona e mostra suas categorias e cartões. Um clique numa área vazia do painel o expande/recolhe; um clique no fundo da janela com o painel expandido o recolhe de volta. Seções ocultas não aparecem aqui (veja a seção 4).

Um clique direito numa seção abre um menu: «Renomear», «Ocultar seção», «Excluir seção». Numa pílula de categoria: «Renomear», «Ocultar».

3.3. Cartões e seus indicadores

Um cartão mostra um ícone, um nome e pode ter etiquetas:

  • «Erro» — o alvo do cartão está indisponível (arquivo excluído, caminho errado);
  • «Admin» — o cartão está configurado para executar como administrador;
  • «Verificando» — uma verificação de disponibilidade está em andamento;
  • etiquetas de arquitetura nos programas: x86, x64, ARM64, Any;
  • nos grupos — a marca de grupo (veja a seção 8).

Um clique esquerdo executa/abre o cartão, um clique direito abre seu menu. Se o texto não couber, passe o cursor — aparecerá uma dica com o texto completo.

3.4. Busca

Digite texto no campo «Buscar…» — a grade é filtrada com um pequeno atraso. A busca procura pelo nome do cartão, nome do arquivo de destino e descrição; todas as palavras da consulta devem corresponder. Esc no campo de busca o limpa, mantendo o foco nele. O botão de limpar faz o mesmo.

Dica

Enquanto uma busca está ativa, o botão «Editor» fica indisponível — limpe a busca primeiro.

3.5. Ordenação

O botão de ordenação na barra de ferramentas abre uma lista de opções: «Sem ordenação», «Por nome», «Por tipo», «Por frequência de uso». A ordenação por frequência usa o contador de execuções de cada cartão — quanto mais você o executa, mais alto ele sobe.

3.6. Painel informativo de status

O botão de status no canto inferior esquerdo abre um painel com contadores e indicadores (modo administrador, modo de armazenamento etc.). Pressioná-lo de novo ou Esc o fecha. O painel e a janela de configurações não podem estar abertos ao mesmo tempo — um fecha o outro.

3.7. Bandeja do sistema

Se a minimização para a bandeja estiver ativada nas configurações:

  • o botão «fechar» esconde a janela na bandeja junto com todas as janelas filhas abertas (elas voltam aos seus lugares ao restaurar);
  • um clique no ícone da bandeja mostra/esconde a janela;
  • o menu do ícone: «Abrir» e «Sair»;
  • «Sair» pedirá confirmação a todas as janelas com alterações não salvas — por exemplo, um editor com formulário incompleto oferecerá salvar ou descartar as edições.

Se você desativar a minimização para a bandeja enquanto a janela estiver oculta, ela volta imediatamente para a tela.

4. Seções e categorias

Para quê. Seções são grandes grupos temáticos («Trabalho», «Multimídia», «Ferramentas»), categorias são subgrupos dentro delas («Navegadores», «Editores»). Cada cartão vive em uma categoria de uma seção.

Gerenciamento — no editor, aba «Estrutura»:

Ação Como fazer
Criar seção «Adicionar seção» → inserir um nome
Criar categoria selecionar a seção → «Adicionar categoria» → inserir um nome
Renomear o botão de renomear na linha, ou o menu da seção no painel lateral
Reordenar os botões «para cima»/«para baixo» na linha da seção
Ocultar/mostrar o botão de visibilidade na linha da seção ou categoria
Trocar ícone da seção o botão de ícone na linha da seção → janela de seleção de ícone (seção 11)
Excluir o botão de excluir na linha → confirmação

Regras: o nome não pode ficar vazio; os nomes das seções e das categorias dentro de uma seção devem ser únicos — em caso de coincidência o programa informa «já existe».

Ocultar. Uma seção oculta desaparece do painel lateral junto com todas as suas categorias; uma categoria oculta desaparece das pílulas. Nenhum dado é excluído: tudo permanece no editor de estrutura e volta pelo interruptor de visibilidade.

Atenção

Importante — exclusão:

  • excluir uma seção remove irreversivelmente todas as suas categorias e cartões — o programa avisará sobre isso no diálogo de confirmação;
  • excluir uma categoria remove todos os seus cartões — também com aviso.

A ordem e a visibilidade são salvas automaticamente. Se a gravação falhar (por exemplo, o armazenamento é somente leitura), o programa mostrará um erro e relerá a estrutura — verifique a seção «Solução de problemas».

5. Cartões: princípios básicos

Um cartão é um objeto executável na grade. Nove tipos são suportados: programa, script, pasta, arquivo, atalho do Windows, comando, URL/URI, pacote MSI e grupo de cartões.

Campos comuns (em quase todos os tipos):

  • Nome — obrigatório; exibido no cartão e na busca;
  • Descrição — opcional; também participa da busca;
  • Seção e categoria — onde colocar o cartão;
  • Ícone — pode ser escolhido pela janela de seleção de ícone (seção 11);
  • «Executar como administrador» — onde isso faz sentido (programas, scripts, comandos, MSI).

Os nomes podem se repetir. Se na categoria escolhida já existir um cartão com esse nome, aparecerá uma dica — não é erro e não bloqueia a gravação.

Caminhos. Podem ser indicados caminhos relativos (a partir da pasta do programa — melhor para portabilidade) e absolutos (C:\…). Caminhos absolutos são aceitos, mas podem parar de funcionar após o transporte para outro computador — veja a seção «Armazenamento de dados e portabilidade».

Salvar e cancelar. O botão «Salvar» grava o cartão; fica inativo até que os campos obrigatórios sejam preenchidos. Ao fechar o editor com edições não salvas, aparece a pergunta «Descartar alterações não salvas?» — «Não salvar» descarta as edições.

6. Criando cartões de diferentes tipos

Dois métodos universais:

  1. Arrastar e soltar — arraste um arquivo ou pasta para a janela principal. O tipo é detectado automaticamente (.exe → programa, .lnk → atalho, .msi → MSI, scripts → script, pasta → pasta, o resto → arquivo). Para programas e atalhos o ícone é extraído automaticamente. Os cartões vão para a seção/categoria atuais; se ainda não houver seções, uma seção de serviço para itens recebidos é criada. Você também pode arrastar o texto de um link http:// ou https:// — será criado um cartão URL.
  2. Pelo editor — «Editor» → «Adicionar cartão» → escolher o tipo → preencher o formulário → «Salvar». Se ainda não houver seções/categorias, aparecerá um painel de dica com botões para criá-las.

Após salvar, a janela principal rola até o novo cartão e o destaca.

6.1. Programa

  • Finalidade: executar .exe.
  • Campos: nome, seção/categoria, variantes de execução, argumentos, pasta de trabalho, ícone, «como administrador».
  • Variantes de execução: um cartão pode guardar vários .exe para diferentes arquiteturas do Windows — x86, x64, ARM64. O botão «Procurar…» adiciona um arquivo: o programa detecta a arquitetura e rotula a linha. Escolher de novo a mesma arquitetura substitui o caminho; cada linha pode ser excluída ou corrigida manualmente.
  • Verificações: pelo menos uma variante é obrigatória; o arquivo deve ser .exe e existir; a pasta de trabalho deve ser um diretório existente.
  • Na execução é escolhida a variante adequada ao seu sistema (por exemplo, no Windows 64 bits primeiro x64, depois x86). Os itens «Executar x64» etc. no menu do cartão executam uma variante específica.
Dica

Não é preciso definir o ícone do cartão manualmente — extraia-o do .exe escolhido pela janela de seleção de ícone.

6.2. Script

  • Finalidade: executar arquivos de script (bat, ps1, reg, vbs e outros formatos suportados).
  • Campos: nome, arquivo de script, seção/categoria, pasta de trabalho, ícone, «como administrador»; o tipo de script é detectado pela extensão automaticamente.
  • Verificações: o arquivo é obrigatório, deve existir e ter um tipo suportado.
  • Na execução uma confirmação é sempre solicitada — antes de executar são mostrados o nome e a descrição do script. Para .reg — um aviso à parte de que o arquivo de registro altera configurações do sistema.

6.3. Pasta

  • Finalidade: abrir um diretório no Explorador.
  • Campos: nome, caminho da pasta, seção/categoria, ícone.
  • Verificações: o caminho deve existir e apontar para uma pasta (se no caminho houver um arquivo — erro).

6.4. Arquivo

  • Finalidade: abrir um documento/mídia com o aplicativo associado.
  • Campos: nome, caminho do arquivo, seção/categoria, ícone.
  • Verificações: o arquivo deve existir; extensões que têm seus próprios tipos de cartão (.exe, .lnk, .msi, scripts) são reservadas — para elas escolha o tipo correspondente.

6.5. Atalho do Windows

  • Finalidade: executar um .lnk existente.
  • Campos: nome, caminho do .lnk, seção/categoria, ícone, «como administrador».
  • Verificações: o caminho deve terminar em .lnk e existir.

6.6. Comando

  • Finalidade: executar um comando de texto (como na linha de comando).
  • Campos: nome, texto do comando, seção/categoria, «como administrador».
  • Verificações: o comando não pode estar vazio.
  • Na execução um diálogo de confirmação é exibido. O item de menu «Copiar comando» copia o texto para a área de transferência sem executar.

6.7. URL / URI

  • Finalidade: abrir um link no navegador ou no aplicativo manipulador.
  • Campos: nome, endereço, seção/categoria, ícone.
  • Verificações: apenas esquemas seguros são aceitos — os sabidamente perigosos serão rejeitados ao salvar. O item de menu «Copiar link» copia o endereço para a área de transferência.

6.8. Pacote MSI

  • Finalidade: executar um instalador .msi.
  • Campos: nome, caminho do .msi (botão de procurar com filtro «Pacote MSI»), argumentos do instalador, ícone, «como administrador».
  • Verificações: o arquivo deve ser .msi e existir. Na execução os argumentos são analisados: uma cadeia quebrada (aspas não fechadas), uma chave sem valor ou um argumento apontando para outro pacote produzirão uma mensagem de erro — nesse caso verifique o campo «Argumentos».

6.9. Grupo de cartões

Um grupo executa vários cartões em sequência. Instruções detalhadas estão na seção «Grupos de cartões».

7. Executando e abrindo objetos

A forma principal de executar é clicar com o botão esquerdo num cartão. Ações adicionais estão no menu de contexto (clique direito). Dependendo do tipo do cartão pode haver itens «Executar», executar uma variante de arquitetura específica, executar com direitos elevados ou normais, e ações para abrir pasta, arquivo, atalho ou link. O conteúdo do menu depende do tipo do cartão.

Ações de serviço no menu do cartão:

  • «Abrir localização» — Explorador com o arquivo de destino selecionado;
  • «Copiar caminho», «Copiar comando», «Copiar link» — para a área de transferência;
  • favoritos e edição — seções «Editando e organizando cartões» e «Favoritos».

Argumentos e pasta de trabalho (programas, scripts, MSI) são definidos no formulário do cartão. Se a pasta de trabalho estiver vazia — usa-se a pasta do próprio alvo.

Confirmações. Antes de scripts, comandos e grupos que os contenham, o programa pede confirmação — é uma proteção contra execução acidental. Para .reg — um aviso especial. Se a execução exigir direitos de administrador, o Windows mostrará a solicitação padrão do UAC: recusá-la simplesmente cancela a execução com uma mensagem de erro.

Dica

Se o próprio Errant Launcher estiver rodando como administrador (etiqueta «Modo administrador»), os processos executados a partir dele também receberão direitos elevados.

Erros típicos de execução estão descritos na seção «Solução de problemas».

8. Grupos de cartões

Finalidade: um cartão-grupo executa vários cartões de uma vez em sequência — por exemplo, «ambiente de trabalho»: e-mail, navegador, editor.

Criação: «Editor» → «Adicionar cartão» → «Grupo» → o botão de seleção de membros abre um diálogo com a lista de todos os cartões. Nele há busca e filtros por seção e tipo; as marcas são mantidas enquanto você filtra a lista. «OK»/Enter confirma a seleção, Esc/«Cancelar» desiste. O grupo deve conter pelo menos um membro; grupos aninhados não são permitidos. Os membros podem ter atrasos individuais antes de executar o próximo.

Ordem: os membros são executados na ordem original da lista de cartões.

Execução e progresso. Se o grupo contém scripts ou comandos, primeiro aparece um aviso. Depois abre o diálogo «Executar grupo»:

  • um contador «N de M» e o nome do membro atual;
  • antes do próximo — uma contagem regressiva «Próximo: … — em X s»;
  • conforme avança, são adicionadas linhas «Cartão "…" — executado / cancelado / não executado»;
  • o botão «Cancelar os restantes», Esc ou fechar a janela param a fila — o que já foi executado não é revertido.

Resultado: a mensagem final «Executados: X · Erros: Y · Ignorados: Z» com uma linha por cartão; ao cancelar — «Execução cancelada»; com erros — um diálogo do tipo «erro».

Erros: um membro cujo alvo sumiu é marcado «não executado» com a razão — isso não derruba o restante da fila. Cartões excluídos desaparecem automaticamente dos grupos.

9. Editando e organizando cartões

Editar um cartão: menu do cartão → «Editar» → o mesmo formulário da criação, com os campos preenchidos → «Salvar».

A tabela de cartões — «Editor» → «Editar cartões»:

  • busca na tabela e filtros «por tipo» e «por seção»;
  • ordenação — clique no cabeçalho da coluna;
  • caixas de seleção nas linhas para multisseleção; os botões «selecionar tudo» / «limpar seleção» atuam sobre a lista filtrada atual;
  • «Editar» — apenas com uma linha selecionada;
  • «Excluir», «Mover», «Duplicar» — com uma ou várias linhas selecionadas.

Excluir: um cartão pergunta «Excluir cartão?», vários — «Excluir cartões?» com um contador. A exclusão é irreversível: o cartão some da seção, dos favoritos e de todos os grupos.

Mover: um diálogo de seleção de seção e categoria — os cartões selecionados se mudam para lá.

Duplicar: uma cópia na mesma categoria.

10. Favoritos

Adicionar/remover: clique direito num cartão → «Adicionar aos favoritos» / «Remover dos favoritos».

Visualização: o item «Favoritos» no painel lateral. Em vez das pílulas de categorias, aqui aparecem abas de tipos: «Todos», «Programas», «Scripts», «Pastas», «Arquivos», «Atalhos», «Comandos», «URL / URI», «Pacotes MSI», «Grupos» — os favoritos podem ser vistos por tipo. A busca também funciona aqui (entre favoritos).

Na importação/exportação as marcas de favorito viajam junto com os cartões (na importação — se o item correspondente estiver marcado, veja a seção «Importação, exportação e backups»).

11. Ícones e aparência

11.1. Ícones de cartões e seções

No formulário do cartão e no editor de estrutura há um botão de seleção de ícone. A janela de seleção oferece:

  • o ícone embutido do tipo;
  • um ícone do conjunto embutido — uma grade para escolher (dentro da grade funcionam as setas, Enter/Space);
  • seu próprio arquivo PNG;
  • extração do ícone de um .exe ou .lnk — o botão «Extrair»;
  • «Restaurar» — voltar ao padrão.

«Salvar» aplica a escolha, «Cancelar»/Esc não. Se a extração falhar ou o arquivo não for PNG — aparecerá uma mensagem de erro, o ícone anterior não será afetado.

11.2. Aparência do aplicativo

Nas configurações (seção 14): idioma, tema, cor de destaque (que também recolore o ícone da bandeja), estilo dos ícones dos cartões («Cores do tema» / «Cor de destaque» / «Coloridos») e estilo das etiquetas. As alterações se aplicam imediatamente.

12. Importação em massa

Para quê. Quando é preciso adicionar não um cartão, mas uma pasta inteira de programas — o assistente encontra sozinho .exe, scripts, .msi, .lnk, arquivos e subpastas, mostra a lista e deixa você escolher o que adicionar.

Onde: «Editor» → aba «Importação em massa». O assistente guia por etapas: «Escolher pasta» → «Escaneamento» → «Resultados» → «Onde adicionar» → resumo.

12.1. Etapa «Escolher pasta» e filtros

  • Pasta para verificar — escolha por «Procurar pastas…» ou digite manualmente. Uma pasta inexistente será destacada com a mensagem «A pasta não existe.»
  • Profundidade de varredura — «Sem limites» ou 1–3 níveis; «Varredura recursiva de subpastas»; «Máximo de candidatos» — ao atingir o limite a verificação para (restrinja os filtros ou aumente o valor).
  • Pílulas de tipos — quais tipos procurar. Alguns tipos têm suas próprias configurações:
  • Programas — quais arquiteturas incluir (incluindo «Any» para as não reconhecidas);
  • Scripts — quais tipos de scripts;
  • Arquivos — lista de extensões separadas por «;» no modo «Excluir as listadas» ou «Procurar apenas as listadas»;
  • MSI e Atalhos — sem filtros extras.
  • Configurações de varredura: pular ocultos, do sistema, pontos de junção e links simbólicos; «Verificar caminhos de rede (UNC)»; lista de nomes de pastas excluídas.
  • Pasta de configuração — indique-a se quiser que o programa verifique a portabilidade dos caminhos dos candidatos.

12.2. Etapa «Escaneamento»

Mostra «Objetos verificados», «Candidatos», «Avisos» e a pasta atual. O botão «Parar» interrompe o escaneamento — a parte encontrada fica guardada com a marca «escaneamento interrompido». Em caso de erro — mensagem e botões «Repetir»/«Voltar». Se o escaneamento parou no limite, aparecerá uma marca — restrinja os filtros.

12.3. Etapa «Resultados»

Uma tabela de candidatos encontrados com status: «pronto», «verificar», «sumiu», «erro», mais as etiquetas «já existe», «não pode adicionar». Nas linhas problemáticas é indicada a razão — por exemplo, «arquivo indisponível para leitura», «duplicado: o cartão já existe», «nome já usado na seção de destino», «caminho de rede desativado pelo filtro».

Recursos:

  • busca por nome/caminho, filtros por tipo e status, ordenação de colunas;
  • «Limpar seleção» / «Excluir selecionados» — para a lista filtrada atual;
  • «Nova verificação» — reverifica os arquivos selecionados no disco sem nova varredura: um arquivo que voltou pode ser restaurado;
  • uma linha expandida permite editar nome, argumentos, descrição, pasta de trabalho, tipo de script, ícone e «como administrador»;
  • o menu da linha — «Copiar caminho» e «Mostrar localização na pasta».

Candidatos com erros e duplicados são excluídos da seleção automaticamente, mas podem ser incluídos manualmente.

Atenção

Se depois do escaneamento você mudar a pasta ou os filtros, os resultados ficam «desatualizados» — o assistente proporá escanear de novo e avisará que as edições serão aplicadas aos mesmos arquivos se forem encontrados novamente.

12.4. Etapa «Onde adicionar»

  • Seção de destino — uma existente ou «Nova seção…»;
  • Categoria — uma existente, «Nova categoria…», «Sem categoria» ou «Pelo nome da pasta pai» (os candidatos são distribuídos por categorias automaticamente);
  • o botão «Verificar» — análise: «Serão adicionados / Serão ignorados / Precisam de atenção», listas de duplicados por caminho, conflitos de nomes e candidatos quebrados; nota sobre caminhos com letra de unidade (podem não abrir em outro computador).

A importação fica bloqueada se o armazenamento não aceitar gravação (mensagem «Configuração indisponível para gravação»), nenhum destino for escolhido, nenhum candidato estiver marcado ou todos os selecionados tiverem erros.

12.5. Importação e resumo

«Importar N cartões» inicia a gravação em segundo plano. Antes de gravar, um backup dos dados é criado. A página final mostra «Adicionados», «Ignorados na importação», «Não selecionados» e detalhes — por exemplo, quantos cartões foram adicionados sem ícone próprio.

Atenção

Em caso de gravação parcial ou falha, o programa informará com mensagens separadas e indicará o caminho do backup para reversão manual; enquanto o estado não for confirmado, a repetição da importação fica pausada — reabra a etapa «Onde adicionar» para reverificar ou reinicie o programa.

Cancelamento: na etapa de escaneamento «Cancelar» para o escaneamento; nas outras etapas, sair do assistente com trabalho inacabado perguntará «Edições e seleção serão perdidas — sair?». Fechar o editor com uma importação inacabada também pedirá confirmação — as tarefas em segundo plano serão encerradas corretamente.

13. Importação, exportação e backups

Onde: botão de configurações → «Importar» / «Exportar» / «Redefinir todos os dados».

13.1. Tipos de exportação

  1. Backup completo — tudo de uma vez: seções, cartões, favoritos, configurações, temas, ícones e estado do aplicativo. Não há janelas de seleção de conteúdo — vai direto para «Salvar como» com o nome ErrantLauncher-Backup.zip. Use para backups e transporte entre computadores.
  2. Compartilhar coleção — seleção de conteúdo: caixas «Ícones», «Temas» e a lista de seções (com «Selecionar tudo»). Configurações e estado não entram aqui; os favoritos viajam com os cartões. O nome do arquivo é ErrantLauncher-Collection.zip.
Atenção

Se as seções marcadas contêm grupos que referenciam cartões de seções não marcadas, aparecerá um aviso — você pode continuar ou cancelar e ajustar as marcas.

Ao finalizar é mostrado exatamente o que foi exportado, com um botão para abrir a pasta do arquivo.

13.2. Importação

  1. «Importar» → escolha um .zip.
  2. Um aviso de que a importação vai alterar os dados — «Continuar»/«Cancelar».
  3. Uma janela de seleção: caixas «Configurações», «Favoritos», «Ícones», «Temas» (apenas o que existe no arquivo) e a lista de seções do arquivo.
  4. Se os nomes das seções coincidirem com os existentes — uma janela de conflitos: para cada seção «Substituir / Renomear / Ignorar», a decisão pode ser aplicada a todas.
  5. Um diálogo de resultado.

Antes de gravar é feito um retrato de segurança — em caso de erro os dados são revertidos. Um backup completo com «Configurações» marcada também restaura o estado do aplicativo.

Erros: arquivo que não é zip ou está corrompido — «arquivo de importação inválido»; arquivo mais novo que a versão do programa — «formato mais novo»; cancelar em qualquer etapa não importa nada; arquivos de temas inválidos são ignorados e listados no resumo.

Dica

Antes do transporte: faça um backup completo no local antigo e verifique se o arquivo abre como um arquivo zip.

14. Configurações

Abertas pelo botão de configurações no canto superior direito da janela principal — um painel aparece por cima. Esc o fecha (se estiver aberto um dropdown de um campo — primeiro fecha a lista, depois o painel).

Configuração O que faz
Idioma Idioma da interface — 6 opções
Seção inicial Qual seção abre na inicialização
Tema Tema de cores da janela
Cor de destaque Destaque da interface e do ícone da bandeja
Estilo dos ícones «Cores do tema» / «Cor de destaque» / «Coloridos»
Estilo das etiquetas Aparência dos indicadores nos cartões
Minimizar para a bandeja Caixa — fechar esconde a janela na bandeja (seção 3.7)

Os campos seletores abrem uma lista dropdown: Enter/Space aplicam e fecham, Esc só fecha. As alterações se aplicam na hora e são salvas automaticamente.

Dica

No modo «Somente leitura» as configurações mostram uma notificação: as alterações valerão até o fechamento do programa, mas não serão salvas.

Aqui também estão os botões «Importar», «Exportar», «Redefinir todos os dados» e «Sobre» (seções 13, 18, 19).

15. Armazenamento de dados e portabilidade

Onde ficam os dados. O programa é portátil: sua pasta de dados fica ao lado do executável. Dentro — arquivos de configurações, arquivos de seções com cartões (sections/*.json), pasta de ícones personalizados (custom-icons/), backups (.backup/, .rollback/) e o registro logs/app.log.

Caminhos dos cartões. O programa procura guardar caminhos relativos — assim o conjunto sobrevive ao transporte para outro disco/computador junto com a pasta de dados e os arquivos de destino. Caminhos absolutos (C:\…) são aceitos, mas funcionam apenas onde são válidos.

Transporte. Copie a pasta inteira do programa — exe, dados e de preferência os arquivos de destino. Antes do transporte faça um backup completo (seção «Importação, exportação e backups»).

Unidade removível — cenário normal. Se o pen drive for removido durante o funcionamento, o programa passa ao modo «Sem mídia»: os dados na tela permanecem, mas a gravação fica impossível. Quando a mídia volta, a gravação é restaurada automaticamente na próxima tentativa de salvamento — o programa verifica se voltou exatamente a sua raiz de dados.

Modos de armazenamento:

Indicador O que significa Consequências
(nenhum) tudo normal leitura e gravação
«Somente leitura» dados são lidos, gravação impossível editor e alterações fechados; configurações valem até reiniciar
«Sem mídia» raiz de dados indisponível gravações são rejeitadas com mensagem de erro

Edição manual de arquivos. Os arquivos sections/*.json podem ser editados num editor de texto com o programa fechado; com o programa rodando, edições externas só são captadas após reiniciar. Um arquivo corrompido não derruba o programa — na inicialização aparece um diálogo «Manter/Excluir» para cada arquivo danificado (a exclusão faz um backup). Se dois arquivos declaram a mesma seção, seu conteúdo é mesclado — uma notificação informa sobre isso.

16. Teclado e atalhos

Combinação Onde Ação
Esc campo de busca limpar a busca
Esc janela principal fechar dropdown do campo → painel de configurações → painel informativo
Esc editor fechar a janela (com edições não salvas pede confirmação)
Esc diálogos e janelas de seleção cancelar sem salvar
Esc diálogo «Executar grupo» parar as execuções restantes
Enter diálogos de nome, janelas de seleção confirmar («Salvar»/«OK»)
Enter / Space cartão na grade executar
Enter / Space ícone na grade de seleção escolher o ícone
Enter / Space dropdown do campo aplicar a seleção e fechar
← → ↑ ↓ grade de cartões mover o foco entre cartões
← → listas de categorias/abas mover entre itens
↑ na primeira seção painel lateral ir para «Favoritos»
↑ ↓ lista de membros do grupo entre as caixas das linhas
Apps / Shift+F10 / RightCtrl janela principal menu de contexto do item em foco

Nenhuma outra combinação de teclas especial é indicada no guia; as demais ações estão disponíveis pela interface com o mouse.

17. Solução de problemas

Um cartão não executa, etiqueta «Erro». O alvo está indisponível: arquivo/pasta excluído ou caminho errado. Menu → Se o alvo existe, o item «Abrir localização» ajuda a chegar até ele. Se o caminho está errado ou o objeto foi excluído, abra o menu do cartão → «Editar», corrija o caminho e salve as alterações ou crie o cartão novamente.

Erro ao executar pedindo direitos. Recusar a janela do UAC cancela a execução — repita e confirme, ou remova «como administrador» no cartão.

Os dados não são salvos, indicador «Somente leitura». O armazenamento está aberto somente para leitura: verifique se a pasta do programa e os arquivos de dados não têm o atributo «somente leitura», se há permissões de gravação e espaço livre. O editor e as alterações ficarão indisponíveis até que a gravação seja restaurada.

Indicador «Sem mídia». A pasta de dados sumiu (pen drive removido, pasta renomeada, caminho de rede indisponível). Traga a mídia/pasta de volta — a gravação será restaurada na próxima tentativa de salvamento. Uma pasta vazia renomeada não se «recoloca»: o programa aceita apenas sua raiz de dados verdadeira.

Diálogo «Manter/Excluir» na inicialização. Um arquivo de configuração está corrompido. «Manter» — o arquivo não é tocado (pode ser reparado manualmente, o diálogo se repete na próxima inicialização); «Excluir» — o arquivo é excluído com um backup. No modo «Somente leitura» não há o botão «Excluir».

Aviso «dados criados por versão mais nova». Os arquivos foram gravados por uma versão mais nova do Errant Launcher; a versão antiga não os sobrescreverá. Atualize o programa para essa versão ou uma mais nova.

Não é possível obter o ícone. A extração de .exe/.lnk falhou ou o arquivo não é PNG — escolha outra fonte ou um ícone embutido.

A importação terminou com erro ou parcialmente. Leia o texto do resultado: ele indicará o que foi gravado, quais arquivos foram alterados e onde está o backup para reversão. Com a mensagem sobre reimportação pausada, reabra a etapa «Onde adicionar» ou reinicie o programa.

Um comando ou link não abre. Para um comando verifique seu texto («Copiar comando» → cole na linha de comando e teste manualmente). Para um link — que o esquema seja permitido e haja um manipulador no sistema; verifique a internet.

O programa não me deixa entrar no editor / configurações não são salvas. Veja os itens sobre «Somente leitura» e «Sem mídia».

18. Redefinir e restaurar dados

Atenção

A redefinição é irreversível. «Redefinir todos os dados» exclui todas as seções, categorias, cartões, favoritos, configurações e estado — o programa reiniciará limpo.

Como fazer: configurações → «Redefinir todos os dados» → passe por dois diálogos consecutivos de confirmação. Cancelar em qualquer etapa aborta a redefinição; um erro produz uma mensagem sem reinício.

Preparação: antes de redefinir, faça um «Backup completo» (seção «Importação, exportação e backups») — é a única forma padrão de recuperar tudo depois.

Restauração: «Importar» → escolha o arquivo de backup → marque «Configurações» e os tipos necessários → resolva os conflitos de nomes → resultado. Após restaurar, verifique: apareceram as seções e os cartões, os caminhos funcionam (etiquetas «Erro»), voltaram os favoritos e as configurações?

19. Sobre e informações legais

O botão «Sobre» nas configurações abre uma janela com o nome, a versão, o copyright e estatísticas de cartões por tipo. Nela:

  • «Contrato de licença» e «Licenças de terceiros» — janelas separadas com o texto e um botão «Copiar»;
  • «Apoiar o projeto»;
  • links «Site oficial», «Lançamentos no GitHub», «Documentação», «Reportar um erro» — abrem no navegador.

20. Materiais de referência

20.1. Tipos de cartões

Tipo O que faz Obrigatório
Programa executa .exe (com variantes de arquitetura) ≥1 variante .exe
Script executa bat/ps1/reg/vbs etc. com confirmação arquivo de script
Pasta abre um diretório pasta existente
Arquivo abre um arquivo com o aplicativo associado arquivo existente
Atalho executa um .lnk arquivo .lnk
Comando executa um comando de texto com confirmação texto do comando
URL / URI abre um link endereço com esquema permitido
Pacote MSI executa um instalador .msi arquivo .msi
Grupo executa seus membros em sequência com progresso ≥1 membro

20.2. Indicadores e estados

Etiqueta/indicador Significado
«Erro» num cartão o alvo está indisponível
«Admin» num cartão executa como administrador
«Verificando» num cartão verificação em andamento
x86 / x64 / ARM64 / Any arquitetura da variante do programa
«Modo administrador» o próprio launcher roda elevado
«Somente leitura» o armazenamento não aceita gravação
«Sem mídia» a pasta de dados está indisponível

20.3. Campos e parâmetros

  • Nome — obrigatório, duplicados permitidos (dica de aviso).
  • Descrição — texto livre, participa da busca e da confirmação de execução de scripts.
  • Pasta de trabalho — o diretório de onde o processo inicia; vazio = pasta do alvo.
  • Argumentos — parâmetros de execução (programas, MSI); no MSI são analisados pelas regras do msiexec.
  • Como administrador — execução elevada via UAC.
  • Atraso de membro de grupo — pausa antes de executar o próximo.

20.4. Atalhos de teclado

A tabela completa está na seção 16.

20.5. Glossário

  • Cartão — elemento executável da grade.
  • Seção / categoria — níveis de agrupamento de cartões.
  • Favoritos — visão com os cartões marcados de todas as seções.
  • Variante de execução — um .exe de arquitetura específica num programa.
  • Candidato — um objeto encontrado pelo assistente de importação em massa.
  • Backup / coleção — os dois tipos de exportação (tudo / selecionado sem configurações).
  • Somente leitura / Sem mídia — modos de armazenamento degradados.

20.6. Perguntas frequentes

  • Por que não consigo abrir o editor? O armazenamento está em modo «Somente leitura»/«Sem mídia» ou uma busca está ativa — limpe o campo de busca ou restaure a gravação.
  • Por que a janela não fecha, mas se esconde na bandeja? «Minimizar para a bandeja» está ativado — saia pelo menu do ícone «Sair» ou desative a configuração.
  • Uma seção desapareceu. Ela está oculta — reative-a no editor de estrutura.
  • Quantos cartões posso importar de uma vez? Quantos o escaneamento encontrar dentro do limite «Máximo de candidatos».
  • Posso manter o programa num pen drive? Sim — é para isso que ele é portátil; ao remover em andamento, «Sem mídia» será ativado.