Documentatie

Machtigingen

Apple heeft de beveiligingstransparantie van macOS in de afgelopen versies steeds verder vergroot door voor veel API's die eerder voor alle programma's toegankelijk waren, toestemming van de gebruiker te vereisen. Daarom moeten enkele van deze machtigingen voor uBar zijn ingeschakeld om te kunnen werken, terwijl andere optioneel blijven.

Toegankelijkheid

De Toegankelijkheid-API wordt gebruikt om vensters en programma's te besturen:

• Programma's stoppen
• Vensters sluiten
• Vensters maximaliseren
• Vensters minimaliseren

Schermopname

Vanaf macOS 10.15 Catalina vereisen diverse API's de machtiging Schermopname. Deze API's worden gebruikt om:

• Venstertitels te lezen
• Nieuw geopende vensters te detecteren
• Vensterinhoud vast te leggen voor venstervoorvertoningen

Let op: je scherm wordt op geen enkel moment daadwerkelijk opgenomen.

Volledige schijftoegang

Vanaf macOS 10.14 Mojave vereisen diverse prullenmand-API's de machtiging Volledige schijftoegang. Deze API's worden gebruikt om:

• De prullenmand te openen
• De prullenmand te legen

Hoewel aanbevolen, is deze machtiging optioneel, omdat ze beperkt is tot prullenmandfuncties.

Diversen

App-statussen

De volgende app-statussen worden aangegeven met gekleurde diagonale lijnpatronen:

• Wordt gestart (wit): De app wordt door het systeem gestart.
• Herstelbaar (blauw): De app is mogelijk eerder onverwacht gestopt en kan door het systeem worden hersteld.
• Reageert niet (rood): De app reageert momenteel niet.

Rijen

Om het aantal rijen te vergroten of te verkleinen, sleep je de uiterste rand van uBar omhoog of omlaag. Het maximale aantal rijen is vijf.

Favorieten

Om een geopend programma aan het favorietengebied toe te voegen, klik je erop met Control of met de rechtermuisknop en kies je "Zet in favorieten". Om een willekeurig bestand, willekeurige map of willekeurig programma toe te voegen, klik je er in de Finder op met Control of met de rechtermuisknop en kies je "Voorzieningen" en vervolgens "Zet in uBar-favorieten". Om deze voorziening in te schakelen, vink je deze aan via Systeemvoorkeuren > Toetsenbord > Toetscombinaties > Voorzieningen.

Activiteitsmodus

Houd een instelbare speciale toets (standaard de rechter Control-toets) ingedrukt om de activiteitsmodus te activeren. Programma's tonen dan het CPU-gebruik in % en het geheugengebruik.

Speciale toetscombinaties

Naast de toetscombinaties in het paneel Toetscombinaties onder Voorkeuren zijn de volgende toetscombinaties beschikbaar:

Tegelgedrag

Wanneer je op een tegel in uBar klikt, hangt het gedrag af van het aantal vensters dat aan de tegel is gekoppeld:

• 0 vensters: Dit is een programmategel. Klikken toont of verbergt het programma.
• 1+ vensters: Dit is een vensterstapeltegel. Klikken toont een menu met de vensters en het programma.

Apps handmatig ordenen

Om je programma's handmatig te ordenen, zet je de programmavolgorde op Handmatig in het venster Voorkeuren onder Algemeen. Ga daarna naar het paneel Programma's in het venster Voorkeuren, waar je de lijst met opgenomen programma's opnieuw kunt ordenen.

Standaardagenda

Wanneer je op het klokgedeelte klikt, wordt je standaard Agenda-app geopend. Deze stel je in via Agenda > Voorkeuren > Algemeen > Standaardagenda-app.

Klokformaat

Het formaat van het klokgedeelte wordt bepaald door de opmaakinstellingen in Systeemvoorkeuren > Taal en regio. Let op: de instellingen onder Datum en tijd > Klok gelden alleen voor de macOS-menubalk en niet voor uBar.

Voorkeuren

Grootte

De grootte-instelling in het venster Voorkeuren biedt vijf opties: Automatisch, Klein, Normaal, Groot en Enorm. Het voordeel van Automatisch is dat uBar zich automatisch aanpast aan je schermgrootte. Een hoofdscherm met een breedte van 1600 pixels of meer levert een grote uBar op, alles daaronder een kleine uBar. Dit is vooral handig bij laptops.

Scherm

Met de scherminstelling in het venster Voorkeuren kun je uBar weergeven op het actieve scherm (dat met de actieve menubalk), op het hoofdscherm of op een secundair scherm.

Venstergroepering

Met de venstergroeperingsfunctie in het venster Voorkeuren bepaal je of uBar vensters van hetzelfde programma groepeert. Er zijn drie instellingen: Altijd, Nooit en Automatisch. Automatisch betekent dat vensters niet worden gegroepeerd, tenzij er niet genoeg ruimte is — in dat geval worden ze automatisch gegroepeerd.

Knipperende apps

Met de optie "Laat apps knipperen die aandacht vragen" bepaal je of programma's die om aandacht van de gebruiker vragen in uBar moeten knipperen. Dit is het equivalent van het stuiteren in het Dock. Er zijn twee soorten aandachtsverzoeken — informatief en kritiek. Bij een informatief verzoek knippert de app één seconde. Bij een kritiek verzoek knippert de app totdat je ernaartoe schakelt en er de actieve app van maakt. In het Dock is het equivalent één stuiter tegenover herhaald stuiteren. Let op: Skype is een populair programma dat standaard zeer vaak aandachtsverzoeken gebruikt. Als Skype voortdurend knippert, moet je de Dock-stuiteroptie voor meerdere gebeurtenissen uitschakelen in Skype-voorkeuren > Meldingen > Details.

Dock-standaardwaarden

De volgende instellingen worden toegepast:

• Rijen: 1
• Vastzetten: geen
• Toon app-titels: nee
• Venstergroepering: altijd
• Linksklikken toont gegroepeerde vensterlijst: nee
• Favorieten — Toon scheidingslijnen: ja
• Klok — Toon klok: nee
• Klikken op de actieve app verbergt deze: nee

Taakbalk-standaardwaarden

De volgende instellingen worden toegepast:

• Vastzetten: links en rechts
• Toon app-titels: ja
• Venstergroepering: automatisch
• Linksklikken toont gegroepeerde vensterlijst: ja
• Favorieten — Toon scheidingslijnen: nee
• Klok — Toon klok: ja
• Klikken op de actieve app verbergt deze: ja

Thema

• Systeem: Onder OS X 10.10 Yosemite en hoger gebruikt uBar de lichte of donkere modus, afhankelijk van of de donkere modus is ingeschakeld in Systeemvoorkeuren onder Algemeen. Onder OS X 10.9 Mavericks gebruikt uBar de lichte modus als de vormgeving is ingesteld op Aqua en de donkere modus bij Grafiet (Systeemvoorkeuren > Algemeen).
• Licht: uBar lijkt op de standaardstijl van de menubalk.
• Donker: uBar lijkt op de donkere menubalkstijl die met OS X 10.10 Yosemite is geïntroduceerd.
• Platinum Neue: uBar lijkt op de "geïntegreerde" vensterstijl van OS X.
• Huidig nummer: uBar krijgt een stijl op basis van de albumillustratie van de audio of video die momenteel in iTunes wordt afgespeeld. Als er geen beschikbaar is, gedraagt deze instelling zich hetzelfde als "Systeem".
• Aangepast: uBar krijgt een stijl op basis van de achtergrondkleur, voorgrondkleur, markeringskleur en dekking die je kiest.

Apps hernoemen

Om de weergavenaam van een app te wijzigen, dubbelklik je op het item in de lijsten onder Voorkeuren > Apps, wijzig je de naam en druk je op Return. Om de standaardnaam te herstellen, herhaal je het proces en verwijder je daarbij de volledige naam.

Ontwikkelaarsmodus

Je kunt de ontwikkelaarsmodus inschakelen in het venster Voorkeuren. De ontwikkelaarsmodus toont de proces-ID (PID) van programma's en de venster-ID (WID) van vensters.

Aanpassing via Application Support

Symbolen vervangen

Symbolen in uBar kunnen worden vervangen door PNG-bestanden in de map ~/Library/Application Support/uBar/Icons.

Om een programmasymbool te vervangen, moet de bestandsnaam de bundle-identifier van de app zijn, gevolgd door de extensie .png. Bijvoorbeeld: com.apple.AddressBook.png

De volgende namen kunnen worden gebruikt voor speciale symbolen:

• Map: Folder.png
• Map Programma's: FolderApplications.png
• Map Bureaublad: FolderDesktop.png
• Map Documenten: FolderDocuments.png
• Map Films: FolderMovies.png
• Map Muziek: FolderMusic.png
• Map Afbeeldingen: FolderPictures.png
• Map Publiek: FolderPublic.png
• Prullenmand leeg: TrashEmpty.png
• Prullenmand vol: TrashFull.png

Eigen klokken

Naast de ingebouwde klokken kunnen eigen klokken aan uBar worden toegevoegd in ~/Library/Application Support/uBar/Timepieces.

Elke klok moet in een eigen map staan en een Timepiece.plist en de bijbehorende PNG-bestanden bevatten. Je kunt het volgende voorbeeld downloaden: Brawer_A300-1.zip.

Terminal

Terminal-commando's

Met de volgende Terminal-commando's kun je bepaald gedrag wijzigen dat niet via de grafische interface kan worden ingesteld. uBar moet opnieuw worden gestart om ze van kracht te laten worden.