Name

pickdate - Rofi date picker.

Synopsis

pickdate [options]

Description

Picks a date with rofi. The following keybindings are available.

  • Go to previous or next month: p, n

  • Go to previous or next year: P, N, <, >

  • Jump to current month: .

  • Vim-like movement keys (default movement bindings also work): h, j, k, l

Options

-r command     (default: $PICKDATE_CMD or 'echo "$REPLY"')

Run command once a date is selected. $REPLY is set to the selected date.

-f format     (default: $PICKDATE_FMT or %F)

The date(1) compatible format to output.

-m position

Position rofi with respect to the mouse instead of using rofi’s theme to determine positioning.

Valid values for position are center, north, south, east, west, northeast, northwest, southeast, and southwest.

-w position

Position rofi with respect to the focused window. By default, the position is determined by rofi’s theme. See the -m option, above, for valid positions.

-h, --help

Print a help message and exit.

Environment Variables

PICKDATE_CMD=command     (default: 'echo "$REPLY"')

The default command for the -r option.

PICKDATE_FMT=format     (default: %F)

The default format for the -f option.

PICKDATE_CAL=command     (default: cal)

The cal command to use. Commands whose output deviate too much from cal(1) are not supported, but you might set this to cal -m to get weeks that start with Monday, for example.

PICKDATE_BUTTONS=btn1:btn2:btn3:btn4:btn5     (default: ' <:<<: .:>>: >')

Colon-delimited list of the "previous month", "previous year", "current month", "next year", and "next month" buttons shown on the bottom.

PICKDATE_SPANATTRS=attributes     (default: 'weight="bold"')

Pango <span> attributes used on the weekday header. See https://docs.gtk.org/Pango/pango_markup.html#the-span-attributes for the available attributes.

PICKDATE_THEMESTR=themestring     (default: '')

Theme string used to override config.rasi . This environment variable can be used to override the following theme properties that pickdate sets:

  • { font: "mono 16"; } configuration { kb-custom-1: "p"; kb-custom-2: "n"; kb-custom-3: "P,less"; kb-custom-4: "N,greater"; kb-custom-5: "period"; kb-move-char-back: "h,Left,Control+b"; kb-move-char-forward: "l,Right,Control+f"; kb-row-up: "k,Up,Control+p,ISO_Left_Tab"; kb-row-down: "j,Down,Control+n"; }

    The following properties are always set and can’t be overridden.

    window { width: <width>ch; }
listview {
    columns: 7;
    lines: <lines>;
    scrollbar: false;
}
inputbar { children: [prompt]; }
TMPDIR=directory     (default: /tmp)

The directory to use for temporary files.

See Also

rofi(1), rofi-keys(5), rofi-theme(5), cal(1), ncal(1), i3blocks-pickdate(1)

Authors

pickdate was written by DMBuce.

Distribution

The latest version of pickdate can be downloaded from the i3b project.