Skip to content

shibe2/sklt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sway Keyboard Layout and Time

A status program for swaybar. It requires Sway 1.2 for keyboard layout change notifications.

Use it in Sway configuration like this:

bar {
    status_command sklt
}

Sway has per-device layouts. This program outputs only the last layout that changed. When a new device is connected, its initial layout is shown.

Command Line Options

SKLT accepts command line options that control its output. For the list of options, run:

sklt -h

-t interval

Time update interval. Valid values for interval are (case-insensitive):

  • s or second
  • m or minute
  • h or hour
  • d or day

Default update interval is 1 minute. Maximum interval is 1 hour, but "day" selects date-only format.

-f format

Time format as understood by Go time package. That is, how the time "Mon Jan 2 15:04:05 -0700 MST 2006" should be formatted.

The default format when updating every second is 2006-01-02 15:04:05 (year-month-day hour:minute:second). For longer update intervals, smaller units are excluded.

An example of a different time format: Mon, Jan 2 3:04 PM (weekday, month day hour:minute ampm).

To use a format that contains spaces in the Sway configuration file, either enclose it in escaped quotes (\" or \') or escape the spaces (add a backslash before each space):

status_command sklt -f \"2006-01-02 15:04\"
status_command sklt -f \'2006-01-02 15:04\'
status_command sklt -f 2006-01-02\ 15:04

-x translation

Translate layout names according to the table from the file translation. The file must be in TSV format (tab-separated values) with 2 columns:

  1. original layout name
  2. displayed (translated) name

The option can be specified multiple times, in which case all files are read.

An example table "layouts.tsv" is included, which translates from full layout names to layout codes (short names) in uppercase.

About

Status program for swaybar

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages