https://github.com/shibe2/sklt

Status program for swaybar
https://github.com/shibe2/sklt

wayland

Last synced: 20 days ago
JSON representation

Status program for swaybar

• Host: GitHub
• URL: https://github.com/shibe2/sklt
• Owner: shibe2
• License: mit
• Created: 2019-08-25T12:07:03.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2020-01-20T08:35:32.000Z (almost 5 years ago)
• Last Synced: 2024-07-30T21:01:54.556Z (4 months ago)
• Topics: wayland
• Language: Go
• Size: 10.7 KB
• Stars: 11
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Sway Keyboard Layout and Time

A status program for [swaybar](https://swaywm.org/).

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](https://golang.org/pkg/time/).

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.