Skip to content

A simple Bash-based calendar application with a graphical interface.

License

Notifications You must be signed in to change notification settings

coreymwamba/estonta

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

estonta

A simple Bash-based calendar application. It also has an optional Yad-based interface for entering events.

clockwise, from top-left: listing (in Termite), the same listing in Conky, estonta.conf, adding an event

estonta creates iCalendar files in a directory (which you can set in $HOME/.config/estonta.conf). It can also display a list of those events. You can filter them by category; search event summaries by word; or find an event by date.

Installation

If you use Arch Linux, you can install it from the AUR:

https://aur.archlinux.org/packages/estonta-git/

otherwise,

sudo install -p -D estonta -m 0755 /usr/local/bin/estonta
install -p -D estonta.conf -m 0644 $HOME/.config/estonta.conf

Then use your favourite text editor to edit estonta.conf.

Use

First, run estonta in a terminal.

$ estonta
New directory created at /home/corey/.local/share/ics.
No events found

Then run estonta -a to add an event. A series of questions (or with the -g, Yad dialogs) will guide you through adding an event. An iCalendar file is added to the directory.

The series of dialogs for adding

Here's an example from a terminal

$ estonta -a
*What date is the event (date: use DATESTRING format - no commas!)? *
20 Jul
*Enter the start time: *
7pm
*Where is it (Press Enter to skip)? *
Out!
*Please give the event a title  (Press Enter to skip):*
Hitting the clubs
*any tags  (Press Enter to skip)?*

*Write a short description (Press Enter to skip): *
Yes!
Event saved.

You can then list the event with estonta. If you want to display an event on a certain day, use the -d switch: this takes a date string (in quotes) as detailed in the manpage for date(1).

$ estonta -d "Friday"
22 Jul '16 @ 14:00 - Picnic
Normanton Park, Derby, United Kingdom
Bring a blanket!

No alcohol on the park

A note on date strings

Date strings are handy: they're "human readable". However, they're not calculated by humans. So bear in mind...

  • "next Thursday" means "Thursday coming" and NOT "Thursday, next week". For Thursday, next week use "next week Thursday"; and
  • don't use commas.

The -c switch filters events by category.

estonta -c "study"
19 Jul '16 @ 15:00 - Thermodynamics tutorial

The -s switch allows you to search for events where the summary contains a certain word. It's case sensitive.

estonta -s M3C
Tue 27 Sep, 10:00am - M3C Induction
Wed 28 Sep, 10:00am - M3C induction

You can find events within a date range with estonta -r "startdate" "enddate".

$ estonta -r "now" "+7days"
Thu 28 Jul, 1:00pm - Bob
Fri 29 Jul, 1:00pm - Laptop

Here's how to look into the past:

$ estonta -r "-7days" "now"
Wed 20 Jul, 5:00pm - Grignon/Ratcliffe
Fri 22 Jul, 5:00pm - Fusebox - solo

You could alias a range on the commandline, or in ~/.bashrc:

$ alias next7days='estonta -r "now" "+7days"'
$ next7days 
Thu 28 Jul, 1:00pm - Bob
Fri 29 Jul, 1:00pm - Laptop

You can edit and delete events by editing the ics files. You can also add events from other software by exporting them into the configured directory.

with Conky

In a Conky file, something like

{execi 10 estonta}

Sharing

estonta produces iCalendar (.ics) files, so you can share them with any application or device that can read that file type. If you have Dropbox (or another file sync service), you can set the events directory to be created in there, making it handy for sharing events across different laptops and phones.

Why?

I got sick of not having a straightforward, transparent way of making events on my laptop. By transparent I mean making an event that I can then send to something else (like a phone; or my site) without a conversion step or a binary program. I also needed something that would give me a plain list of events that I could use in Conky. I didn't want anything big, like a full calendaring application; just something I could look at quickly, and also add to if needed.

The name is Esperanto.

About

A simple Bash-based calendar application with a graphical interface.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages