uBar 4
Overview      Documentation      Release Notes      
Buy Now

Documentation

Miscellaneous

Rows

To increase or decrease the number of rows, drag the very edge of uBar up or down. The maximum number of rows is five.

Favorites

To an open application to the Favorites Area, control or right-click it and select "Add to Favorites". To add any file, folder, or application, you can control or right-click it in the Finder and select "Services" and then "Add to uBar Favorites". To enable this service, check it via "System Preferences>Keyboard>Shortcuts>Services".

Activity mode

Hold a custom modifier key (default is right-control) on your Keyboard to activate Activity Mode. Applications will show % CPU utilization and Memory Usage.

Special shortcuts

In addition the the shortcuts available in the Shortcuts pane under Preferences, the following shortcuts are available:

Shortcut Description
Control-Option-1, 2, 3 ... 0 Toggle app or window in the specified position.
Command key while clicking an app or window Show the app in the Finder.
Option key while clicking an app or window Show or hide the app or window.
Option-Command while clicking an app or window Show the app only. All other apps are hidden.
Shift key while clicking an app or window Quit the app.
Shift-Command while clicking an app or window Force relaunch the app.
Middle-click an app or window Quit the app or close the window.
Middle-click the bar Toggle auto-hide.
Shift-click a window preview Close the window.

Tile behaviour

When clicking on a tile in uBar, the resulting behaviour depends on how many windows are associated with the tile:

  • 0 windows: This is an application tile. Clicking toggles the visibility of the application.
  • 1+ windows: This a window stack tile. Clicking it displays a menu listing the windows and the application.

Manually ordering apps

To manually order your applications, set Application Order to Manual in the Preferences window under General. Then Switch to the Application pane in the Preferences window, and you can re-order the Included Applications list.


Preferences

Size

The size setting in the Preferences window allows you to select three options: Automatic, Small, Medium, Large, and Huge. The advantage of Automatic is that uBar will automatically adapt itself to your screen size. A primary screen with a width of 1600 or more pixels will result in a Large uBar, while anything smaller will result in a Small uBar. This is especially useful with laptops.

Screen

The screen setting in the Preferences window allows you to display uBar on the Main screen (the one with the active menubar), the Primary screen, or a secondary screen.

Window grouping

The Window Grouping feature in the Preferences window allows you to determine whether uBar will group windows belonging to the same application together. There are three settings: Always, Never, and Automatic. Automatic means the windows are ungrouped unless there is not enough room, in which case windows will automatically group together.

App flashes

The "Flash apps that want attention" option allows you to toggle whether or not you want applications that are seeking user attention to flash in uBar. This is the equivalent of Dock bounces. There are two types of attention requests - informational and critical. When an app issues an informational attention request, the app with flash for a second. With a critical request, the app will flash until it you switch to it and make it the active app. For the Dock, the equivalent is a single bounce versus repeated bounces. Please note that Skype is a popular application which makes very frequent use of attention requests by default. If Skype is constantly flashing, you must disable the Dock bounce option for multiple events in Skype Preferences > Notifications > Details.

Dock defaults

The following settings will be set:

  • Rows: 1
  • Pinning: None
  • Show app titles: No
  • Window grouping: Always
  • Left-click to display grouped window list: No
  • Favorites - Show seperators: Yes
  • Clock - Show clock: No
  • Clicking the active app hides it: No

Taskbar defaults

The following settings will be set:

  • Pinning: Left and Right
  • Show app titles: Yes
  • Window grouping: Automatic
  • Left-click to display grouped window list: Yes
  • Favorites - Show seperators: No
  • Clock - Show clock: Yes
  • Clicking the active app hides it: Yes

Theme

  • System: Under OS X 10.10 Yosemite and above, uBar will use Light or Dark mode depending on whether Dark mode in enabled in System Preferences under General. Under OS X 10.9 Mavericks, uBar will use Light mode if Appearance is set to Aqua and Dark mode if it is set to Graphite in System Preferences under General.
  • Light: uBar will resemble the default menu bar style.
  • Dark: uBar will resemble the dark menu bar style introduced in OS X 10.0 Yosemite.
  • Platinum Neue: uBar will resemble the "unified" OS X window style.
  • Now Playing: uBar will be styled based on the Album Artwork of the currently playing audio or video in iTunes. If none is available, this setting behaves the same as the "System" setting.
  • Custom: uBar will be styled based the background color, foreground color, highlight color, and opacity that you select.

Developer mode

You can enable developer mode in the Preferences window. Developer mode shows the Process ID (PID) for Applications, and the Window ID (WID) for Windows.


Application Support Customization

Icon Overrides

Icons in uBar can be overriden by PNG files in the ~/Library/Application Support/uBar/Icons folder.

To override an application icon, the filename must be the bundle identifier of the app, followed by the .png extension. For example: com.apple.AddressBook.png

The following names may be used for special icons:

  • Folder: Folder.png
  • Applications Folder: FolderApplications.png
  • Desktop Folder: FolderDesktop.png
  • Documents Folder: FolderDocuments.png
  • Movies Folder: FolderMovies.png
  • Music Folder: FolderMusic.png
  • Pictures Folder: FolderPictures.png
  • Public Folder: FolderPublic.png
  • Trash Empty: TrashEmpty.png
  • Trash Full: TrashFull.png

Custom Timepieces

In addition to the built-in timepieces, custom timepieces may be added to uBar in the ~/Library/Application Support/uBar/Timepieces

Each timepiece must be in it's own folder, and contain a Timepiece.plist and relevant PNG files. You may download the following example: Brawer_A300-1.zip.


Terminal

Terminal commands

The following terminal commands allow you to change certain behaviours that cannot be set via GUI. They require a relaunch of uBar to take effect.

Commands
defaults write ca.brawer.uBar singleWindowUsesTitle -bool YES

Makes apps that have a single window open use the title of that window. Use NO instead of YES to use the app name.

defaults write ca.brawer.uBar showWindowCount -bool YES

Show the window count in grouped app tiles. Use NO instead of YES to hide the count.

defaults write ca.brawer.uBar useAppIconForWindows -bool YES

Use the app icon for windows. Use NO instead of YES to use the document icon when possible.

defaults write com.apple.dock autohide-delay -float 1000 && killall Dock

Practically hide the Apple Dock by making it's auto-hide delay 1000 seconds.

defaults delete com.apple.dock autohide-delay && killall Dock

Restore the default auto-hide delay for the Apple Dock.