Skip to content

A POSIX compliant shell script for tracking dates and deadlines in text files.

License

Notifications You must be signed in to change notification settings

shushcat/txt-agenda

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

txt-agenda

txt-agenda is a script for keeping track of dates and deadlines scattered throughout a series of text files. So far as I know, it is entirely POSIX compliant with the -f flag, and when that flag is omitted, the only additional dependency is fzf. While this documentation is obviously incomplete, the script itself is functional.

Syntax

The deadline and reminder syntax used by txt-agenda is taken from Howm mode for Emacs, but the agenda behavior when using fzf is closer to that of Org-mode.

The format is as follows:

  • Reminders [YYYY-MM-DD]- sink after the date
  • Tasks [YYYY-MM-DD]+ float after the date
  • Deadlines [YYYY-MM-DD]! float before and after the date

As with Howm, repeated entries are achieved by entering multiple dates.

Flags

| -f | Report without fzf | | -h | Print help message | | -y | Output agenda items for the year centered on the current date |

progress

  • Vim plugin for fzf.
  • Setup man file (will need to look into roff).
    • see man-pages(7)
  • Determine whether an appended q command is likely to make Sed's print commands faster; see https://stackoverflow.com/questions/83329/how-can-i-extract-a-predetermined-range-of-lines-from-a-text-file-on-unix.
  • line output to something more sensible: date:line:filename:linenum; probably add a filename to the fzf preview; or maybe just change the preview layout to horizontal
  • allow arguments (getopt/getopts?)
  • Convert $SORT_LINES to a variable
  • Make date portable
    • Set date properly when it's December or January
  • Preview context for datelines in fzf.
  • highlight matched date in fzf's preview window
  • test filtering with fzf now!
  • fix line display; ex: [YYYY-MM-DD]+:LINUM:LINE:FILE
  • preserve references to files while arranging the agenda

Related Projects and Resources

About

A POSIX compliant shell script for tracking dates and deadlines in text files.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages