Documentation

Autorisations

Au fil des dernières versions de macOS, Apple a renforcé la transparence en matière de sécurité en exigeant l'autorisation de l'utilisateur pour de nombreuses API auparavant accessibles à toutes les applications. uBar nécessite donc désormais l'activation de certaines d'entre elles pour fonctionner, tandis que d'autres restent facultatives.

Accessibilité

L'API d'accessibilité est utilisée pour contrôler les fenêtres et les applications :

• Quitter des applications
• Fermer des fenêtres
• Agrandir des fenêtres
• Réduire des fenêtres

Enregistrement de l'écran

Depuis macOS 10.15 Catalina, diverses API nécessitent l'autorisation Enregistrement de l'écran. Ces API servent à :

• Lire les titres des fenêtres
• Détecter l'ouverture de nouvelles fenêtres
• Capturer le contenu des fenêtres pour les aperçus

Notez qu'à aucun moment votre écran n'est réellement enregistré.

Accès complet au disque

Depuis macOS 10.14 Mojave, diverses API liées à la corbeille nécessitent l'autorisation Accès complet au disque. Ces API servent à :

• Ouvrir la corbeille
• Vider la corbeille

Bien que recommandée, cette autorisation est facultative, car elle se limite aux fonctions liées à la corbeille.

Divers

États des apps

Les états d'app suivants sont signalés par des motifs de lignes diagonales colorées :

• Lancement (blanc) : L'app est en cours de lancement par le système.
• Restaurable (bleu) : L'app a peut-être quitté inopinément et peut être restaurée par le système.
• Ne répond pas (rouge) : L'app ne répond pas actuellement.

Rangées

Pour augmenter ou diminuer le nombre de rangées, faites glisser le bord extrême de uBar vers le haut ou vers le bas. Le nombre maximal de rangées est de cinq.

Favoris

Pour ajouter une application ouverte à la zone des favoris, cliquez dessus avec la touche Contrôle ou le bouton droit et choisissez « Ajouter aux favoris ». Pour ajouter n'importe quel fichier, dossier ou application, cliquez dessus dans le Finder avec la touche Contrôle ou le bouton droit, puis choisissez « Services » et « Ajouter aux favoris uBar ». Pour activer ce service, cochez-le dans Préférences Système > Clavier > Raccourcis > Services.

Mode activité

Maintenez une touche de modification personnalisable (par défaut, la touche Contrôle droite) pour activer le mode activité. Les applications afficheront leur utilisation du processeur en % et leur consommation de mémoire.

Raccourcis spéciaux

En plus des raccourcis proposés dans la sous-fenêtre Raccourcis des Préférences, les raccourcis suivants sont disponibles :

Comportement des vignettes

Lorsque vous cliquez sur une vignette dans uBar, le comportement dépend du nombre de fenêtres associées à la vignette :

• 0 fenêtre : Il s'agit d'une vignette d'application. Un clic affiche ou masque l'application.
• 1 fenêtre ou plus : Il s'agit d'une vignette de pile de fenêtres. Un clic affiche un menu listant les fenêtres et l'application.

Ordonner les apps manuellement

Pour ordonner vos applications manuellement, réglez l'ordre des applications sur « Manuel » dans la fenêtre Préférences, section Général. Passez ensuite à la sous-fenêtre Applications de la fenêtre Préférences : vous pourrez y réorganiser la liste des applications incluses.

Calendrier par défaut

Lorsque vous cliquez sur la zone de l'horloge, votre app Calendrier par défaut se lance. Elle se définit dans Calendrier > Préférences > Général > App de calendrier par défaut.

Format de l'horloge

Le format de la zone de l'horloge est déterminé par les réglages de format de Préférences Système > Langue et région. Notez que les réglages de Date et heure > Horloge s'appliquent uniquement à la barre des menus de macOS, pas à uBar.

Préférences

Taille

Le réglage de taille de la fenêtre Préférences propose cinq options : Automatique, Petite, Moyenne, Grande et Très grande. L'avantage d'Automatique est que uBar s'adapte automatiquement à la taille de votre écran. Un écran principal d'une largeur de 1600 pixels ou plus donnera un uBar grand format, tandis qu'un écran plus petit donnera un uBar petit format. C'est particulièrement utile sur les ordinateurs portables.

Écran

Le réglage d'écran de la fenêtre Préférences permet d'afficher uBar sur l'écran actif (celui qui possède la barre des menus active), sur l'écran principal ou sur un écran secondaire.

Regroupement des fenêtres

La fonction de regroupement des fenêtres de la fenêtre Préférences détermine si uBar regroupe les fenêtres appartenant à la même application. Trois réglages existent : Toujours, Jamais et Automatique. Automatique signifie que les fenêtres restent dissociées, sauf si la place manque : elles se regroupent alors automatiquement.

Clignotement des apps

L'option « Faire clignoter les apps qui demandent votre attention » permet de choisir si les applications qui sollicitent l'utilisateur doivent clignoter dans uBar. C'est l'équivalent des rebonds du Dock. Il existe deux types de demandes d'attention : informatives et critiques. Lors d'une demande informative, l'app clignote une seconde. Lors d'une demande critique, l'app clignote jusqu'à ce que vous basculiez vers elle et en fassiez l'app active. Pour le Dock, cela correspond à un rebond unique contre des rebonds répétés. Notez que Skype est une application populaire qui, par défaut, utilise très fréquemment les demandes d'attention. Si Skype clignote en permanence, désactivez l'option de rebond du Dock pour les événements multiples dans Préférences de Skype > Notifications > Détails.

Réglages par défaut du dock

Les réglages suivants seront appliqués :

• Rangées : 1
• Ancrage : aucun
• Afficher les titres des apps : non
• Regroupement des fenêtres : toujours
• Clic gauche pour afficher la liste des fenêtres groupées : non
• Favoris — Afficher les séparateurs : oui
• Horloge — Afficher l'horloge : non
• Cliquer sur l'app active la masque : non

Réglages par défaut de la barre des tâches

Les réglages suivants seront appliqués :

• Ancrage : gauche et droite
• Afficher les titres des apps : oui
• Regroupement des fenêtres : automatique
• Clic gauche pour afficher la liste des fenêtres groupées : oui
• Favoris — Afficher les séparateurs : non
• Horloge — Afficher l'horloge : oui
• Cliquer sur l'app active la masque : oui

Thème

• Système : Sous OS X 10.10 Yosemite et ultérieur, uBar utilise le mode clair ou sombre selon que le mode sombre est activé dans Préférences Système > Général. Sous OS X 10.9 Mavericks, uBar utilise le mode clair si l'apparence est réglée sur Aqua et le mode sombre si elle est réglée sur Graphite (Préférences Système > Général).
• Clair : uBar ressemble au style par défaut de la barre des menus.
• Sombre : uBar ressemble au style sombre de la barre des menus introduit avec OS X 10.10 Yosemite.
• Platinum Neue : uBar ressemble au style de fenêtre « unifié » d'OS X.
• Lecture en cours : uBar adopte un style basé sur la pochette d'album du contenu audio ou vidéo en cours de lecture dans iTunes. Si aucune pochette n'est disponible, ce réglage se comporte comme le réglage « Système ».
• Personnalisé : uBar adopte un style basé sur la couleur d'arrière-plan, la couleur de premier plan, la couleur de surbrillance et l'opacité que vous choisissez.

Renommer des apps

Pour modifier le nom affiché d'une app, double-cliquez sur son entrée dans les listes de Préférences > Apps, changez le nom, puis appuyez sur Retour. Pour rétablir le nom par défaut, répétez l'opération en supprimant le nom en entier.

Mode développeur

Vous pouvez activer le mode développeur dans la fenêtre Préférences. Il affiche l'identifiant de processus (PID) des applications et l'identifiant de fenêtre (WID) des fenêtres.

Personnalisation via Application Support

Remplacement d'icônes

Les icônes de uBar peuvent être remplacées par des fichiers PNG placés dans le dossier ~/Library/Application Support/uBar/Icons.

Pour remplacer l'icône d'une application, le nom du fichier doit être l'identifiant de bundle de l'app, suivi de l'extension .png. Par exemple : com.apple.AddressBook.png

Les noms suivants peuvent être utilisés pour les icônes spéciales :

• Dossier: Folder.png
• Dossier Applications: FolderApplications.png
• Dossier Bureau: FolderDesktop.png
• Dossier Documents: FolderDocuments.png
• Dossier Vidéos: FolderMovies.png
• Dossier Musique: FolderMusic.png
• Dossier Images: FolderPictures.png
• Dossier Public: FolderPublic.png
• Corbeille vide: TrashEmpty.png
• Corbeille pleine: TrashFull.png

Horloges personnalisées

En plus des horloges intégrées, des horloges personnalisées peuvent être ajoutées à uBar dans ~/Library/Application Support/uBar/Timepieces.

Chaque horloge doit se trouver dans son propre dossier et contenir un fichier Timepiece.plist ainsi que les fichiers PNG associés. Vous pouvez télécharger l'exemple suivant : Brawer_A300-1.zip.

Terminal

Commandes Terminal

Les commandes Terminal suivantes permettent de modifier certains comportements impossibles à régler via l'interface graphique. Elles nécessitent un redémarrage de uBar pour prendre effet.