minchin.jrnl version 7.1 Documentation

project logo

You can use it to easily create, search, and view journal entries. Journals are stored as human-readable plain text, and can also be encrypted using AES encryption.

PyPI version number Changelog Supported Python versions License GitHub Workflow Status Download Count

To get help, submit an issue on Github.

In a Nutshell

To make a new entry, just enter

jrnl yesterday: Called in sick. Used the time to clean the house and write
my book.

yesterday: is interpreted by minchin.jrnl as a timestamp. Everything until the first sentence ending (either ., ?, or !) is interpreted as the title, and 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 write my book.

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


pip install minchin.jrnl

Read full installations instructions.


You are reading the full documentation. Consult the Table of Contents.


Release notes are on my blog at https://blog.minchin.ca/label/minchinjrnl/

Read the full Changelog.


The project is licensed under GPLv3. Read the full license.

Code contributed on or before April 18, 2020 and by William Minchin (any date) is duel licensed under the MIT license as well. One of the long term projects of the goal is to remove or replace any GPLv3 code, and move the entire project to the MIT license.



Our maintainers help keep the lights on for the project:

Please thank them if you like minchin.jrnl!

Code Contributors

This project is made with love by the many fabulous people who have contributed. minchin.jrnl couldn’t exist without each and every one of you!

Your contributions to make minchin.jrnl better would be greatly welcomed!