docs » MenubarFlag

Boolean to specify whether the indicators should be shown on all monitors or just the current one. Defaults to true

Table that contains the configuration of indicator colors

• The table below indicates the colors to use for a given keyboard layout.
• The index is the name of the layout as it appears in the input source menu.
• The value of each indicator is a table made of an arbitrary number of segments, which will be distributed evenly across the width of the screen.
• Each segment must be a valid hs.drawing.color specification (most commonly, you should just use the named colors from within the tables). If a layout is not found, then the indicators are removed when that layout is active.
• Indicator specs can be static flag-like:

  Spanish = {col.green, col.white, col.red},
  German = {col.black, col.red, col.yellow},

or complex, programmatically-generated:

["U.S."] = (
   function() res={}
      for i = 0,10,1 do
         table.insert(res, col.blue)
         table.insert(res, col.white)
         table.insert(res, col.red)
      end
      return res
   end)()

or solid colors:

  Spanish = {col.red},
  German = {col.yellow},

• Contributions of indicator specs are welcome!

Number to specify the indicator transparency (0.0 - invisible; 1.0 - fully opaque). Defaults to 0.3

Number to specify the height of the indicator. Specify 0.0-1.0 to specify a percentage of the height of the menu bar, larger values indicate a fixed height in pixels. Defaults to 1.0

Boolean to specify whether the indicator should be shown in all spaces (this includes full-screen mode). Defaults to true

Number to indicate how frequently (in seconds) should the menubar indicator be updated. Defaults to 1.0.

• Sometimes Hammerspoon misses the callback when the keyboard layout changes. As a workaround, MenuBarFlag can automatically update the indicator at a fixed frequency.
• The timer can be disabled by setting this parameter to 0.

Draw the indicators corresponding to the given layout name

• src - name of the layout to draw. If the given element exists in MenubarFlag.colors, it will be drawn. If it does not exist, then the indicators will be removed from the screen.

• The MenubarFlag object

Draw indicators for the current keyboard method or layout

• None

• The MenubarFlag object

Start the keyboard layout watcher to draw the menubar indicators.

• None

Remove indicators and stop the keyboard layout watcher

• None