https://github.com/jadedctrl/farend

Simple shell-based todo list. (🪞)
https://github.com/jadedctrl/farend

suckless todo todo-list todolist

Last synced: about 2 months ago
JSON representation

Simple shell-based todo list. (🪞)

• Host: GitHub
• URL: https://github.com/jadedctrl/farend
• Owner: JadedCtrl
• License: gpl-3.0
• Created: 2020-01-26T07:40:07.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-01-29T06:35:27.000Z (11 months ago)
• Last Synced: 2024-01-29T08:33:55.897Z (11 months ago)
• Topics: suckless, todo, todo-list, todolist
• Language: Shell
• Homepage: https://hak.xwx.moe/jadedctrl/farend
• Size: 19.5 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.txt
  • License: COPYING.txt

Awesome Lists containing this project

README

        
===============================================================================

FAREND(.SH)

===============================================================================

Farend is a very simple todo-list program in shell.

It doesn't manage your todo-list; it can't delete, add, or edit events.

All it does is *display* them in a friendly way, ordered by earliest to latest.

By default, it will print a report listing “TODAY”'s events, followed by the

events of the following seven days. Anything not happening today— or in 7 days—

is ignored.

The idea is that it'll just take your todo-list text file, which you may fill

up with as many events as you want, and only print the immediately relevant

ones.

————————————————————————————————————————

TODO FILE

————————————————————————————————————————

TODO files are formatted like this:

	YYYY-MM-DD HH:MM Event description goes here.

You can use wildcard in any of the date slots; if you don't know the specific

date, to signfify it happens all day (*:*), to signify it's yearly (*-MM-DD),

etc etc.

————————————————————————————————————————

USAGE

————————————————————————————————————————

-l $LIMIT      | The amount of days you'd like to print events in advance (7)

-d $DIVIDER    | Set the divider string under headers (default is 40 "-" chars)

-T $TODAY_MSG  | Set the header title for today's events ("TODAY")

-L $LATER_MSG  | Set the header title to non-today upcoming events  ("NEXT")

-q             | Print upcoming events without dividers or headers ($*_MSG)

-h             | Print the help message

$ farend -l 100 -q /tmp/todo

# Will print upcoming events for the next 100 days, without headers or anything

# … usage goes on along those lines.

————————————————————————————————————————

UTILS

————————————————————————————————————————

The "utils/" folder contains some stuff I personally find useful that's related

to the project.

Right now, it just contains `ccal`, a frontend to `cal` that portably

highlights the current day (since it's not builtin in many versions).

————————————————————————————————————————

BORING STUFF

————————————————————————————————————————

License is GPLv3-- check COPYING.txt.

Author is Jaidyn Ann 

Sauce is at https://hak.xwx.moe/jadedctrl/farend