vjournal-explorer

... is an app for browsing and editing VJOURNAL files in a directory.

VJOURNAL is a type of event in iCalendar standard, so these files can be intermixed with and synchronised (e.g. though CalDav protocol) along with the rest of your iCalendar/ics setup.

I personally use vdirsyncer to synchronise my nextcloud calendars with a directory with ics files on my computer. I use this app to interact with VJOURNAL-type entries among them.

As of writing this, among full-blown calendar/todo applications, evolution can also interact with VJOURNAL entries (they call them 'Memos'); and jtx Android app can do so as well.

installation

At the moment, the code exists only in this repo.

Perhaps the most convenient way to install this is with pipx:

pipx install git+https://git.drak.xyz/flabbergast/vjournal-explorer

After this you'll have the vje command available in terminal.

running

Run vje DIRECTORY in your terminal.

When ran without arguments, vje will try to read a configuration file $HOME/.config/vjournal-explorer/config. This can be used to set DIRECTORY like so:

directory="/home/USER/vjournal_directory"

Run vje --help for full list of options (for now rather short).

technical

vjournal-explorer expects a directory with ics (VCALENDAR) files, each of them with a single VJOURNAL entry. However VCALENDAR files can have multiple entries. For now, one needs to be careful with deleting entries -- this deletes the whole ics file. Other functionality should work fine.

todo

• fix deleting (remove entry, check for empty vcal, clean up file if needed)