Package: jrnl-mw
jrnljrnl is a personal journal management application.UsageSetupSet up your journal by printing out a config file, like so:jrnl --setupand fill out the path to the root of your journal.Using jrnlOpen up today's journal entry withjrnlwhich will open up today's journal entry in your favourite text editor.Using jrnl grepjrnl also comes with a grep wrapper which you can invoke as follows:jrnl grep [OPTIONS] PATTERNwhereOPTIONSare normalgrep
options.Advanced usageTimestampsYou can generate a timestamp before opening the entry by using the-tflag:jrnl -tor you can have timestamps always written by specifying so in your config file.Negative date offsetsYou can open up another date's journal entry by specifying a date as an
argument. One way of doing this is with negative date offsets: for
example, to open up yesterday's journal runjrnl -1Fuzzy datesAnother way to pass a date to jrnl is with a date string (wrapped in
quotes if it contains spaces). jrnl usesdateutil's fuzzy date parser to
parse the strings you pass in, which lets you specify dates like"Nov 7 2017":jrnl "Nov 7 2017"dateutil can do more: for example, specifying the 4th of the current
month's date withjrnl 4Accessing the latest existing entryYou can open the latest existing journal entry withHEADlike so:jrnl HEADAliases forHEADareLASTandLATEST—all of which are case
insensitive.Accessing an existing entry's ancestorYou can access the ancestor of an existing entry with suffixes^or~N(for the Nth ancestor). These work almost identically to the same
suffixes ingit. For example, to find the fifth last existing journal
enty, you can dojrnl HEAD~5These suffixes can be stacked and combined in any way you like.Accessing the closest existing entry to a given dateTo access the closest existing journal entry for a given date, add the@suffix to the date. For example, to find the closest entry to
2017-01-01, you'd dojrnl @2017-01-01Opening multiple entriesTo open up multiple entries simply pass in multiple date arguments. For
example,jrnl -7 "Jan 01 2016" 20180504will open entries for a week ago, 2018-01-01, and 2018-05-04.Extending a date past midnightIf in your config file you havehours_past_midnight_included_in_date:NwhereNis some postive integer; then for a given date, at 0N:00 or
earlier, jrnl will open up the day before's journal entry.:confused: What? Here's the motivation:When it's 02:00, we're likely to refer to this time as night, rather
than morning. Likewise, you might want a journal chunk (for lack of a
better term) written at 02:00 to be in the same entry as chunks from
(technically) the previous day. If you do want such a thing, you can
specify a time in your config file: at any time before this specified
time (inclusive), jrnl will open up the day before's journal entry.Journal structureRight now you're constrained to having a journal structure like so:journal_root/
journal_root/2017/
journal_root/2017/2017-07-05.txt
journal_root/2017/2017-09-01.txtand if you want to use all the features you're going to need to be okay
with ISO 8601-based timestamps:2017-09-01
21:06

You'd write stuff here.

22:30

And more stuff here.How do I install this?sudo pip3 install jrnl-mwor just run therun_jrnl.pyscript directly.