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-themes 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-themes Update a calendar parameter for all user themes at onceadd-event Add or delete eventconfigure Clone or open configuration files- 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’