Collect your thoughts and notes without leaving the command line.
Find a file
Jonathan Wren 10d8a32b64 Squashed commit of the following:
commit 75113187432939a51486422c3f70b3a9e2bcf0aa
Merge: 74d1854 47e10fb
Author: Jonathan Wren <9453067+wren@users.noreply.github.com>
Date:   Thu Oct 24 17:02:10 2019 -0700

    Merge pull request #665 from notbalanced/issue_662

    Fixes Issue #662 - Day names not treated consistently for new entry

commit 74d1854a4bba468221b4eee254bdee2bb40f5d5a
Merge: 97e4d6a 6a5726a
Author: Jonathan Wren <9453067+wren@users.noreply.github.com>
Date:   Sat Oct 5 15:30:57 2019 -0700

    Merge pull request #418 from philipsd6/2.0-fancy_exporter

    Add exporter to output entries inside unicode box character boxes

commit 47e10fbee7
Author: Craig Moyer <craig.moyer@gmail.com>
Date:   Sun Sep 29 19:06:53 2019 -0400

    Fix issue #662 to properly handle day names as new entry dates and
    command line (-on, -from, -to).

commit 9588913100
Author: Craig Moyer <craig.moyer@gmail.com>
Date:   Sun Sep 29 08:27:27 2019 -0400

    Syncing with jrnl-org/master

commit 4c68eb193d
Merge: 81dfebb 97e4d6a
Author: Craig Moyer <craig.moyer@gmail.com>
Date:   Sun Sep 29 07:52:02 2019 -0400

    Merge remote-tracking branch 'upstream/master' into 2.0-rc1-maebert

commit 81dfebb2c0
Author: Manuel Ebert <manuel@1450.me>
Date:   Mon Apr 29 20:34:18 2019 +0200

    export changes

commit 6a5726acd2
Author: Philip Douglass <philip@philipdouglass.com>
Date:   Fri Dec 22 20:56:36 2017 -0500

    Enable FancyExporter plugin

commit 3d1b226871
Author: Philip Douglass <philip@philipdouglass.com>
Date:   Fri Jan 29 11:17:41 2016 -0500

    Add exporter to output entries inside unicode box character boxes
2020-04-10 11:51:55 -07:00
.github Adding "new" labels to new issues 2020-04-10 11:51:55 -07:00
docs [GH-666] updating documentation to reflect v2 behavior: 2020-04-10 11:51:55 -07:00
features Squashed commit of the following: 2020-04-10 11:51:55 -07:00
jrnl Squashed commit of the following: 2020-04-10 11:51:55 -07:00
.gitignore Add Poetry config 2020-04-10 11:51:55 -07:00
.travis.yml Clarify currently supported Python versions 2020-04-10 11:51:55 -07:00
CHANGELOG.md fix typos, spelling (#734) 2020-04-10 11:51:55 -07:00
CODE_OF_CONDUCT.md [GH-602] Add a code of conduct file (rather than adding to contributing) 2020-04-10 11:51:55 -07:00
CONTRIBUTING.md [GH-693] cleaning up "Developing" section and adding a note about behave 2020-04-10 11:51:55 -07:00
LICENSE fix typos, spelling (#734) 2020-04-10 11:51:55 -07:00
Makefile ¯\_(ツ)_/¯ 2020-04-10 11:51:55 -07:00
mkdocs.yml Moving from sphinx to mkdocs 2020-04-10 11:51:55 -07:00
poetry.lock Clarify currently supported Python versions 2020-04-10 11:51:55 -07:00
pyproject.toml Clarify currently supported Python versions 2020-04-10 11:51:55 -07:00
README.md Smaller doc fixes, fixes #486 2020-04-10 11:51:55 -07:00

jrnl Build Status Downloads Version

To get help, submit an issue on Github.

jrnl is a simple journal application for your command line. Journals are stored as human readable plain text files - you can put them into a Dropbox folder for instant syncing and you can be assured that your journal will still be readable in 2050, when all your fancy iPad journal applications will long be forgotten.

Optionally, your journal can be encrypted using the 256-bit AES.

Why keep a journal?

Journals aren't just for people who have too much time on their summer vacation. A journal helps you to keep track of the things you get done and how you did them. Your imagination may be limitless, but your memory isn't. For personal use, make it a good habit to write at least 20 words a day. Just to reflect what made this day special, why you haven't wasted it. For professional use, consider a text-based journal to be the perfect complement to your GTD todo list - a documentation of what and how you've done it.

In a Nutshell

to make a new entry, just type

jrnl yesterday: Called in sick. Used the time to clean the house and spent 4h on writing my book.

and hit return. yesterday: will be interpreted as a timestamp. Everything until the first sentence mark (.?!) will be interpreted as the title, the rest as the body. In your journal file, the result will look like this:

2012-03-29 09:00 Called in sick.
Used the time to clean the house and spent 4h on writing my book.

If you just call jrnl, you will be prompted to compose your entry - but you can also configure jrnl to use your external editor.

Known Issues

jrnl used to support integration with Day One, but no longer supports it since Day One 2 was released with a different backend. See the GitHub issue for more information.

Authors

Current maintainers:

Original maintainer: