CALCURSE(1) CALCURSE(1) (NAME) calcurse - (SYNOPSIS) calcurse [-D datadir] [-C confdir] [-c calendar-file] calcurse -Q [--from date] [--to date | --days number] calcurse -a | -d date | -d number | -n | -r[number] | -s[date] | -t[number] calcurse -G [filter options] [format options] | -P [filter options] [format options] calcurse -h | --status | -g | -i file | -x[file] | --daemon calcurse . ( ). . . calcurse . . OPTIONS . (DESCRIPTION) calcurse ( ) . calcurse calcurse . . . . . ncurses . . . . . . . (Input and Output Date Format) date date line ( ) . date date lines ( FILES ). "General Options" . . --input-datefmt --output-datefmt . date month year . day 1-31 month 1-12 . year 1902-2037 1902-? . : today tomorrow yesterday now mon ... sun. date ( Filter Options ) ( ) . hh:mm ( : "2018-12-1 20:30" ISO ). . (Filter, format and day range options) . : calcurse . calcurse ( -Q ) . (-Q ) grep (-G) purge (-P) export (-x) . grep --dump-imported . . (OPTIONS) . "(also interactively)" . -a, --appointment . -Q --filter-type cal. -c file, --calendar file (also interactively) . /apts ( FILES ). file . -D . -C dir, --confdir dir (also interactively) . FILES -D . -D dir, --datadir dir (also interactively) () . FILES -C . -d date|num, --day date|num : o date o num date num . num . calcurse -d 3 calcurse -d -2 . -Q --filter-type cal --from date -Q --filter-type cal --days num . --daemon calcurse . daemon.enable Notify . --days num -Q. --from --to. --from . -Q --query . --dump-imported stdout . . Format Options . --export-uid UID . --from date -Q. -to --days ( ) -Q --query . -F, --filter -P . -P ( ). -g, --gc (garbage collector) . notes ( FILES ) . general.autogc General Options . -G, --grep TODO calcurse. -h, --help . -i file, --import file icalendar file. --input-datefmt format : format.inputdate ( General Options ). format 1 2 3 4 1 = mm/dd/yyyy 2 = dd/mm/yyyy 3 = yyyy/mm/dd 4 = yyyy-mm-dd. -l num, --limit num num. -n, --next . . --output-datefmt format : format.outputdate ( General Options ). format strftime(3) . -P, --purge ( Filter Options ). EXAMPLES . ( ) . --filter-invert . purge . : . -G . -P -G . . -q, --quiet (also interactively) (). . -Q, --query range of days ( ) TODO. ( ). day range --from --to/--days . --from a --to z a z . --from a --days n a n n . . -r[num], --range[=num] num . num . . -Q --filter-type cal --days num. --read-only (also interactively) todos . : calcurse ! -s[date], --startday[=date] date . -Q --filter-type cal --from date. -S regex, --search regex -a -d -r -s -t . -Q --filter-pattern regex. --status calcurse . (PID) . -t[num], --todo[=num] todo. num () num . 1 () 9 () . 0 () . -Q --filter-type todo --filter-priority --filter-completed --filter-uncompleted. --to date -Q. --from . --days -Q --query . -v, --version calcurse. -x[format], --export[=format] . todos stdout . : ical pcal. format ical . (FILTER OPTIONS) (-Q ) grep (-G) purge (-P) export (-x) DESCRIPTION . . calcurse . <> . --filter-type . . : (todo). TODO . . --filter-invert . (General filters) --filter-type type type . type event apt recur-event recur-apt todo . recur recur-event,recur-apt cal event,apt,recur . --filter-pattern pattern . (extended regular expression) . --filter-hash string string . (!) : string . (SHA1) (Extended format specifiers) . (Calendar filters) -from -to -after -before -range . (event) . () ( ) . -start- -from -after -range . -to -before -range . -end- . . . . --filter-start-from date . --filter-start-to date . --filter-start-after date . --filter-start-before date . --filter-start-range range . . --filter-end-from date . --filter-end-to date . --filter-end-after date . --filter-end-before date . --filter-end-range range . . (Todo filters) --filter-priority priority TODO . --filter-completed TODO . --filter-uncompleted TODO . (FORMAT OPTIONS) (queries) grep --dump-imported . . --format-apt format, --format-recur-apt format, --format-event format, --format-recur-event format, --format-todo format format printf ( ) . format . . : . (Default format strings) % . . (hh:mm) . . : --format-apt " - %S -> %E\n\t%m\n" --format-recur-apt " - %S -> %E\n\t%m\n" --format-event " * %m\n" --format-recur-event " * %m\n" --format-todo "%p. %m\n" (grep dump-imported) "%(raw)" . (Appointments) %d %e %E ..:.. %m %n %N %r %s %S ..:.. (Events) %m %n %N (Todo items) %m %n %N %p (Extended format specifiers) . . %(duration[:format]) %d %(remaining[:format]) %r format strftime(3) %d, %H, %M %S : ) "" 0-31 ( "" E ) ) ) % : - E "" %H, %M %S - E ) %(start[:format]) %s %(end[:format]) %e format strftime(3) epoch default (calcurse) %s %e ( Epoch) (calcurse) %S %E (strftime) %H:%M ..:.. / %(raw) grep dump-imported %(hash) (SHA1) (EXAMPLES) calcurse -d tomorrow ( calcurse -Q --filter-type cal --from tomorrow). calcurse -d friday . calcurse -d 7 ( calcurse -Q -filter-type cal --days 7). calcurse -r7 --format-apt " - %S -> %E\n\t%m\n%N" . . calcurse -r7 --format-apt " - %m (%S to %E)\n" --format-recur-apt " - %m (%S to %E)\n" (): - Some appointment (18:30 to 21:30) calcurse -t --format-todo "(%p) %m\n" (todo) . calcurse . . calcurse --input-datefmt 4 -G --filter-start-before 2015-1-1 TODO. (Purge). -G -P . . calcurse --input-datefmt 1 -G --filter-start-from 11/1/2015 --filter-type event,apt () . calcurse -G --filter-type apt --format-apt "%(hash) %m\n" (hash) - (SHA1) . calcurse -G --filter-type apt --format-apt "%(duration:%d/%EH/%EM)\t%m\n" () . calcurse -G --filter-type apt --format-apt "%(start:%c) %(duration:%d %H:%M)\t%m\n" . (FILES) (home) calcurse : $XDG_DATA_HOME/calcurse/ $XDG_CONFIG_HOME/calcurse/ |___apts |___conf |___notes/ |___hooks/ |___todo |___keys $XDG_DATA_HOME $HOME/.local/share $XDG_CONFIG_HOME $HOME/.config . : . calcurse calcurse calcurse . (Data files) apts todo . notes . SHA1 . () calcurse (.calcurse.pid) (.daemon.log) . daemon.log . -c . (Configuration files) conf keys . hooks (Hooks) . (Directory configuration) -D . -C -D . -D -C ( ) . $HOME/.calcurse . | | |__ apts |___ conf |__ todo |___ keys |__ notes/ |___ hooks/ defaults: : $XDG_DATA_HOME/calcurse ($HOME/.local/share/calcurse) : $XDG_CONFIG_HOME/calcurse ($HOME/.config/calcurse) both: $HOME/.calcurse (only if it exists) calcurse : $ calcurse $ calcurse -C "$HOME/.config/calcurse/config" (Hooks) /calcurse/hooks/ ( ) . . (executable) . pre-load . post-load . pre-save . post-save . contrib/hooks/ calcurse . (ENVIRONMENT) calcurse . CALCURSE_EDITOR, VISUAL, EDITOR . . vi . CALCURSE_PAGER, PAGER . less . MERGETOOL . vimdiff . . FILES . (BUGS) bugs@calcurse.org issue https://github.com/lfos/calcurse . (SEE ALSO) ical ( rfc2445) : http://tools.ietf.org/html/rfc2445 pcal: http://pcal.sourceforge.net/ calcurse: http://calcurse.org/ calcurse : https://github.com/lfos/calcurse html doc/ http://calcurse.org/files/manual.html . (AUTHORS) o Frederic Culot o Lukas Fleischer (COPYRIGHT) Copyright (c) 2004-2023 calcurse Development Team. BSD . 08/07/2025 CALCURSE(1)