Documentação

Permissões

Nas últimas versões do macOS, a Apple tem aumentado a transparência em matéria de segurança, exigindo a autorização do utilizador para muitas API que antes eram acessíveis a todas as aplicações. Assim, o uBar requer agora que algumas delas estejam ativadas para funcionar, enquanto outras permanecem opcionais.

Acessibilidade

A API de Acessibilidade é usada para controlar janelas e aplicações:

• Sair de aplicações
• Fechar janelas
• Maximizar janelas
• Minimizar janelas

Gravação do ecrã

A partir do macOS 10.15 Catalina, várias API requerem a permissão de gravação do ecrã. Estas API são usadas para:

• Ler os títulos das janelas
• Detetar a abertura de novas janelas
• Capturar o conteúdo das janelas para as pré-visualizações

Tenha em atenção que em nenhum momento o seu ecrã é realmente gravado.

Acesso total ao disco

A partir do macOS 10.14 Mojave, várias API relacionadas com o lixo requerem a permissão de acesso total ao disco. Estas API são usadas para:

• Abrir o lixo
• Esvaziar o lixo

Embora recomendada, esta permissão é opcional, pois limita-se às funcionalidades relacionadas com o lixo.

Diversos

Estados das aplicações

Os seguintes estados das aplicações são indicados por padrões de linhas diagonais coloridas:

• A iniciar (branco): A aplicação está a ser iniciada pelo sistema.
• Restaurável (azul): A aplicação pode ter encerrado inesperadamente e pode ser restaurada pelo sistema.
• Sem resposta (vermelho): A aplicação não está a responder de momento.

Filas

Para aumentar ou diminuir o número de filas, arraste a extremidade do uBar para cima ou para baixo. O número máximo de filas é cinco.

Favoritos

Para adicionar uma aplicação aberta à área de favoritos, clique nela com a tecla Controlo premida ou com o botão direito e selecione "Adicionar aos favoritos". Para adicionar qualquer ficheiro, pasta ou aplicação, clique com Controlo ou com o botão direito no Finder e selecione "Serviços" e depois "Adicionar aos favoritos do uBar". Para ativar este serviço, assinale-o em Preferências do Sistema > Teclado > Atalhos > Serviços.

Modo de atividade

Mantenha premida uma tecla modificadora personalizável (por predefinição, a tecla Controlo direita) para ativar o modo de atividade. As aplicações mostrarão a % de utilização do CPU e o consumo de memória.

Atalhos especiais

Além dos atalhos disponíveis no painel Atalhos das Preferências, estão disponíveis os seguintes atalhos:

Comportamento dos mosaicos

Ao clicar num mosaico do uBar, o comportamento depende de quantas janelas estão associadas ao mosaico:

• 0 janelas: É um mosaico de aplicação. Clicar mostra ou oculta a aplicação.
• 1+ janelas: É um mosaico de pilha de janelas. Clicar apresenta um menu com as janelas e a aplicação.

Ordenar aplicações manualmente

Para ordenar manualmente as suas aplicações, defina a ordem das aplicações como Manual na janela Preferências, secção Geral. Depois, mude para o painel Aplicações da janela Preferências, onde pode reordenar a lista de aplicações incluídas.

Calendário predefinido

Ao clicar na área do relógio, a sua aplicação Calendário predefinida é aberta. Pode defini-la em Calendário > Preferências > Geral > Aplicação de calendário predefinida.

Formato do relógio

O formato da área do relógio é determinado pelas definições de formato em Preferências do Sistema > Idioma e região. Tenha em atenção que as definições em Data e hora > Relógio aplicam-se apenas à barra de menus do macOS e não ao uBar.

Preferências

Tamanho

A definição de tamanho na janela Preferências oferece cinco opções: Automático, Pequeno, Médio, Grande e Enorme. A vantagem do Automático é que o uBar se adapta automaticamente ao tamanho do seu ecrã. Um ecrã principal com uma largura de 1600 píxeis ou mais resulta num uBar grande, enquanto qualquer coisa menor resulta num uBar pequeno. É especialmente útil em portáteis.

Ecrã

A definição de ecrã na janela Preferências permite mostrar o uBar no ecrã ativo (o que tem a barra de menus ativa), no ecrã principal ou num ecrã secundário.

Agrupamento de janelas

A funcionalidade de agrupamento de janelas na janela Preferências determina se o uBar agrupa as janelas pertencentes à mesma aplicação. Há três definições: Sempre, Nunca e Automático. Automático significa que as janelas ficam desagrupadas, a menos que não haja espaço suficiente — nesse caso, agrupam-se automaticamente.

Aplicações a piscar

A opção "Fazer piscar as aplicações que pedem atenção" permite escolher se as aplicações que procuram a atenção do utilizador devem piscar no uBar. É o equivalente aos saltos do Dock. Existem dois tipos de pedidos de atenção — informativos e críticos. Com um pedido informativo, a aplicação pisca durante um segundo. Com um pedido crítico, a aplicação pisca até que mude para ela e a torne a aplicação ativa. No Dock, o equivalente é um único salto contra saltos repetidos. Tenha em atenção que o Skype é uma aplicação popular que, por predefinição, usa pedidos de atenção com muita frequência. Se o Skype estiver constantemente a piscar, deve desativar a opção de salto do Dock para eventos múltiplos em Preferências do Skype > Notificações > Detalhes.

Predefinições de dock

Serão aplicadas as seguintes definições:

• Filas: 1
• Fixação: nenhuma
• Mostrar títulos das aplicações: não
• Agrupamento de janelas: sempre
• Clique esquerdo para mostrar a lista de janelas agrupadas: não
• Favoritos — Mostrar separadores: sim
• Relógio — Mostrar relógio: não
• Clicar na aplicação ativa oculta-a: não

Predefinições de barra de tarefas

Serão aplicadas as seguintes definições:

• Fixação: esquerda e direita
• Mostrar títulos das aplicações: sim
• Agrupamento de janelas: automático
• Clique esquerdo para mostrar a lista de janelas agrupadas: sim
• Favoritos — Mostrar separadores: não
• Relógio — Mostrar relógio: sim
• Clicar na aplicação ativa oculta-a: sim

Tema

• Sistema: No OS X 10.10 Yosemite e posterior, o uBar usa o modo claro ou escuro consoante o modo escuro esteja ativado nas Preferências do Sistema, em Geral. No OS X 10.9 Mavericks, o uBar usa o modo claro se a aparência estiver definida como Aqua e o modo escuro se estiver definida como Grafite (Preferências do Sistema > Geral).
• Claro: O uBar assemelha-se ao estilo predefinido da barra de menus.
• Escuro: O uBar assemelha-se ao estilo escuro da barra de menus introduzido no OS X 10.10 Yosemite.
• Platinum Neue: O uBar assemelha-se ao estilo de janela "unificado" do OS X.
• A reproduzir: O uBar adota um estilo baseado na capa do álbum do áudio ou vídeo em reprodução no iTunes. Se não houver nenhuma disponível, esta definição comporta-se como "Sistema".
• Personalizado: O uBar adota um estilo baseado na cor de fundo, na cor de primeiro plano, na cor de realce e na opacidade que escolher.

Mudar o nome das aplicações

Para editar o nome apresentado de uma aplicação, faça duplo clique na sua entrada nas listas de Preferências > Aplicações, altere o nome e prima Enter. Para repor o nome predefinido, repita o processo apagando o nome completo.

Modo de programador

Pode ativar o modo de programador na janela Preferências. O modo de programador mostra o ID de processo (PID) das aplicações e o ID de janela (WID) das janelas.

Personalização via Application Support

Substituição de ícones

Os ícones do uBar podem ser substituídos por ficheiros PNG na pasta ~/Library/Application Support/uBar/Icons.

Para substituir o ícone de uma aplicação, o nome do ficheiro deve ser o identificador de pacote (bundle identifier) da aplicação, seguido da extensão .png. Por exemplo: com.apple.AddressBook.png

Podem ser usados os seguintes nomes para os ícones especiais:

• Pasta: Folder.png
• Pasta Aplicações: FolderApplications.png
• Pasta Secretária: FolderDesktop.png
• Pasta Documentos: FolderDocuments.png
• Pasta Filmes: FolderMovies.png
• Pasta Música: FolderMusic.png
• Pasta Imagens: FolderPictures.png
• Pasta Público: FolderPublic.png
• Lixo vazio: TrashEmpty.png
• Lixo cheio: TrashFull.png

Relógios personalizados

Além dos relógios integrados, podem ser adicionados relógios personalizados ao uBar em ~/Library/Application Support/uBar/Timepieces.

Cada relógio deve estar na sua própria pasta e conter um ficheiro Timepiece.plist e os ficheiros PNG correspondentes. Pode descarregar o seguinte exemplo: Brawer_A300-1.zip.

Terminal

Comandos do Terminal

Os seguintes comandos do Terminal permitem alterar determinados comportamentos que não podem ser definidos através da interface gráfica. Requerem o reinício do uBar para terem efeito.