Documentazione

Permessi

Nelle ultime versioni di macOS, Apple ha aumentato la trasparenza in materia di sicurezza richiedendo l'autorizzazione dell'utente per molte API prima accessibili a tutte le applicazioni. Di conseguenza, uBar richiede ora che alcune di queste siano abilitate per funzionare, mentre altre restano facoltative.

Accessibilità

L'API di Accessibilità viene usata per controllare finestre e applicazioni:

• Uscire dalle applicazioni
• Chiudere le finestre
• Ingrandire le finestre
• Contrarre le finestre

Registrazione schermo

A partire da macOS 10.15 Catalina, diverse API richiedono il permesso di registrazione dello schermo. Queste API vengono usate per:

• Leggere i titoli delle finestre
• Rilevare l'apertura di nuove finestre
• Catturare il contenuto delle finestre per le anteprime

Nota che in nessun momento lo schermo viene realmente registrato.

Accesso completo al disco

A partire da macOS 10.14 Mojave, diverse API legate al Cestino richiedono il permesso di accesso completo al disco. Queste API vengono usate per:

• Aprire il Cestino
• Vuotare il Cestino

Pur essendo consigliato, questo permesso è facoltativo, poiché riguarda solo le funzioni legate al Cestino.

Varie

Stati delle app

I seguenti stati delle app sono indicati da motivi di linee diagonali colorate:

• In avvio (bianco): L'app è in fase di avvio da parte del sistema.
• Ripristinabile (blu): L'app potrebbe essersi chiusa in modo inatteso e può essere ripristinata dal sistema.
• Non risponde (rosso): L'app attualmente non risponde.

Righe

Per aumentare o diminuire il numero di righe, trascina il bordo estremo di uBar verso l'alto o verso il basso. Il numero massimo di righe è cinque.

Preferiti

Per aggiungere un'applicazione aperta all'area dei Preferiti, fai clic su di essa tenendo premuto Ctrl o con il tasto destro e scegli "Aggiungi ai Preferiti". Per aggiungere qualsiasi file, cartella o applicazione, fai clic con Ctrl o con il tasto destro nel Finder e scegli "Servizi", quindi "Aggiungi ai Preferiti di uBar". Per abilitare questo servizio, attivalo in Preferenze di Sistema > Tastiera > Abbreviazioni > Servizi.

Modalità attività

Tieni premuto un tasto modificatore personalizzabile (di default il Ctrl destro) per attivare la modalità attività. Le applicazioni mostreranno la % di utilizzo della CPU e l'uso della memoria.

Abbreviazioni speciali

Oltre alle abbreviazioni disponibili nel pannello Abbreviazioni delle Preferenze, sono disponibili le seguenti abbreviazioni:

Comportamento dei riquadri

Quando fai clic su un riquadro in uBar, il comportamento dipende da quante finestre sono associate al riquadro:

• 0 finestre: È un riquadro applicazione. Il clic mostra o nasconde l'applicazione.
• 1+ finestre: È un riquadro pila di finestre. Il clic mostra un menu con l'elenco delle finestre e dell'applicazione.

Ordinare le app manualmente

Per ordinare manualmente le tue applicazioni, imposta l'ordine delle applicazioni su Manuale nella finestra Preferenze, sezione Generali. Passa quindi al pannello Applicazioni della finestra Preferenze, dove potrai riordinare l'elenco delle applicazioni incluse.

Calendario di default

Quando fai clic sull'area dell'orologio, si apre la tua app Calendario di default. Puoi impostarla in Calendario > Preferenze > Generali > App calendario di default.

Formato dell'orologio

Il formato dell'area dell'orologio è determinato dalle impostazioni di formato in Preferenze di Sistema > Lingua e Zona. Nota che le impostazioni in Data e Ora > Orologio si applicano solo alla barra dei menu di macOS e non a uBar.

Preferenze

Dimensione

L'impostazione della dimensione nella finestra Preferenze offre cinque opzioni: Automatica, Piccola, Media, Grande ed Enorme. Il vantaggio di Automatica è che uBar si adatta automaticamente alla dimensione dello schermo. Uno schermo principale con una larghezza di 1600 pixel o più produce un uBar grande, mentre uno più piccolo produce un uBar piccolo. È particolarmente utile con i laptop.

Schermo

L'impostazione dello schermo nella finestra Preferenze consente di mostrare uBar sullo schermo attivo (quello con la barra dei menu attiva), sullo schermo principale o su uno schermo secondario.

Raggruppamento delle finestre

La funzione di raggruppamento delle finestre nella finestra Preferenze determina se uBar raggruppa le finestre appartenenti alla stessa applicazione. Ci sono tre impostazioni: Sempre, Mai e Automatico. Automatico significa che le finestre restano separate a meno che non ci sia abbastanza spazio: in tal caso si raggruppano automaticamente.

Lampeggio delle app

L'opzione "Fai lampeggiare le app che richiedono attenzione" consente di scegliere se le applicazioni che richiedono l'attenzione dell'utente debbano lampeggiare in uBar. È l'equivalente dei rimbalzi del Dock. Esistono due tipi di richieste di attenzione: informative e critiche. Con una richiesta informativa, l'app lampeggia per un secondo. Con una richiesta critica, l'app lampeggia finché non passi ad essa rendendola l'app attiva. Nel Dock, l'equivalente è un singolo rimbalzo contro rimbalzi ripetuti. Nota che Skype è un'applicazione popolare che di default usa molto spesso le richieste di attenzione. Se Skype lampeggia in continuazione, devi disattivare l'opzione di rimbalzo del Dock per eventi multipli in Preferenze di Skype > Notifiche > Dettagli.

Valori di default del dock

Verranno applicate le seguenti impostazioni:

• Righe: 1
• Ancoraggio: nessuno
• Mostra i titoli delle app: no
• Raggruppamento delle finestre: sempre
• Clic sinistro per mostrare l'elenco delle finestre raggruppate: no
• Preferiti — Mostra separatori: sì
• Orologio — Mostra orologio: no
• Il clic sull'app attiva la nasconde: no

Valori di default della barra delle applicazioni

Verranno applicate le seguenti impostazioni:

• Ancoraggio: sinistra e destra
• Mostra i titoli delle app: sì
• Raggruppamento delle finestre: automatico
• Clic sinistro per mostrare l'elenco delle finestre raggruppate: sì
• Preferiti — Mostra separatori: no
• Orologio — Mostra orologio: sì
• Il clic sull'app attiva la nasconde: sì

Tema

• Sistema: Con OS X 10.10 Yosemite e versioni successive, uBar usa la modalità chiara o scura a seconda che la modalità scura sia attivata in Preferenze di Sistema > Generali. Con OS X 10.9 Mavericks, uBar usa la modalità chiara se l'aspetto è impostato su Aqua e quella scura se è impostato su Grafite (Preferenze di Sistema > Generali).
• Chiaro: uBar ricorda lo stile di default della barra dei menu.
• Scuro: uBar ricorda lo stile scuro della barra dei menu introdotto con OS X 10.10 Yosemite.
• Platinum Neue: uBar ricorda lo stile di finestra "unificato" di OS X.
• In riproduzione: uBar adotta uno stile basato sulla copertina dell'album dell'audio o del video attualmente in riproduzione in iTunes. Se non è disponibile, questa impostazione si comporta come "Sistema".
• Personalizzato: uBar adotta uno stile basato sul colore di sfondo, sul colore di primo piano, sul colore di evidenziazione e sull'opacità che scegli.

Rinominare le app

Per modificare il nome visualizzato di un'app, fai doppio clic sulla sua voce negli elenchi di Preferenze > App, cambia il nome e premi Invio. Per ripristinare il nome di default, ripeti l'operazione eliminando l'intero nome.

Modalità sviluppatore

Puoi attivare la modalità sviluppatore nella finestra Preferenze. La modalità sviluppatore mostra l'ID di processo (PID) delle applicazioni e l'ID di finestra (WID) delle finestre.

Personalizzazione tramite Application Support

Sostituzione delle icone

Le icone di uBar possono essere sostituite da file PNG nella cartella ~/Library/Application Support/uBar/Icons.

Per sostituire l'icona di un'applicazione, il nome del file deve essere il bundle identifier dell'app, seguito dall'estensione .png. Ad esempio: com.apple.AddressBook.png

Per le icone speciali si possono usare i seguenti nomi:

• Cartella: Folder.png
• Cartella Applicazioni: FolderApplications.png
• Cartella Scrivania: FolderDesktop.png
• Cartella Documenti: FolderDocuments.png
• Cartella Filmati: FolderMovies.png
• Cartella Musica: FolderMusic.png
• Cartella Immagini: FolderPictures.png
• Cartella Pubblica: FolderPublic.png
• Cestino vuoto: TrashEmpty.png
• Cestino pieno: TrashFull.png

Orologi personalizzati

Oltre agli orologi integrati, è possibile aggiungere orologi personalizzati a uBar in ~/Library/Application Support/uBar/Timepieces.

Ogni orologio deve trovarsi in una propria cartella e contenere un file Timepiece.plist e i relativi file PNG. Puoi scaricare il seguente esempio: Brawer_A300-1.zip.

Terminale

Comandi del Terminale

I seguenti comandi del Terminale consentono di modificare alcuni comportamenti non impostabili tramite l'interfaccia grafica. Richiedono il riavvio di uBar per avere effetto.