Usage

Basic

Simply execute the script, then, Use mouse or keyboard to interact with the calendar:

  • Hit arrows to cycle through months or years

  • Hit a day to create a linked event. (day change color as it has a linked event)

  • Hit menu button to switch theme, switch event type, show month events

Shortcuts

Shortcuts have to be entered in the rofi command prompt. Those are default shortcuts, it can vary along themes and can be modified in <theme>.cfg files. Sym is the symbol displayed, you can type either Sym or Keys to execute an action

Sym

Keys

Action

◀◀

<<

pp

go to previous year

<

p

-

go to previous month

>

n

+

go to next month

▶▶

>>

nn

++

go to next year

event

ee

display events of the month (first line)

switch

ss

switch event type (open another folder)

help

hh

display this help

theme

tt

display theme selector

menu

mm

display menu

Events

Events are simply files (usally text files) created by the calendar when you interact with a day (click/return key) On interaction, your default editor will open the event file. (see Customize/Events section for formatting advices) On editor closing, calendar will reopen and the day with a linked note will appear colored.

A script in avaible in calendar menu to show event from online calendar - using caldav -, that’s a very light support, you can only show events on calendar (day, time, description, location), but you won’t be able to sync or push new event to it. (see scripts/caldav2file.py file for details)

Options

Some command line options are avaible and can be useful if you want to integrate the naivecalendar in a script or temporarily override parameters. Subcommands update could be useful to update all theme config at once instead of doing it manually (use completion).

usage: naivecalendar [-h] [-V] [-v] [-p] [-x] [-f FORMAT] [-e EDITOR] [-l LOCALE] [-c] [-t THEME] [-d DATE]

A simple popup calendar

subcommands:

update Update a calendar parameter for all user themes at once add-event Add or delete event

optional arguments:
-h, --help

show this help message and exit

-V, --version

show program’s version number and exit

-v, --verbose

direct rofi command errors to stdout

-p, --print

print date to stdout instead of opening a event

-x, --clipboard

copy date to clipboard

-f FORMAT, --format FORMAT

option ‘-p’ or ‘-x’ output format (datetime.strftime format, defaut=’%Y-%m-%d’)

-e EDITOR, --editor EDITOR

editor command to open events

-l LOCALE, --locale LOCALE

force system locale, for example ‘-l es_ES.utf8’

-c, --read-cache

force calendar to read old date from cache

-t THEME, --theme THEME

set calendar theme, default=classic_dark (theme file name without extention)

-d DATE, --date DATE

display calendar at the given month, format=’%m-%Y’