jrnl/docs/overview.md
Jonathan Wren 29234ddc35
Documentation updates (Thanks @guydebros!) (#1031)
* updated README.md:

- corrected information about encryption
- made additions based on proposed changes to overview.md
- made other changes for clarity and grammar

* ongoing changes to overview.md

* added note that `pycrypto` is required

made other small changes for grammar and clarity

* added new python decryption script to encryption.md

* updated encryption.md to clarify dependencies

other relatively small changes for clarity

straightened quotes

Co-authored-by: Guy B. deBros <guydebros@users.noreply.github.com>
2020-08-22 12:13:36 -07:00

2.4 KiB

Overview

jrnl is a simple journal application for the command line.

jrnl's goal is to facilitate the rapid creation and viewing of journal entries. It is flexible enough to support different use cases and organization strategies. It is powerful enough to search through thousands of entries and display, or "filter," only the entries you want to see.

jrnl has most of the features you need, and few of the ones you don't.

Plain Text

jrnl stores each journal in plain text. jrnl files can be stored anywhere, including in shared folders to keep them synchronized between devices. Journal files are compact (thousands of entries take up less than 1 MiB) and can be read by almost any electronic device, now and for the foreseeable future.

Tags

To make it easier to find entries later, jrnl includes support for inline tags (the default tag symbol is @). Entries can be found and filtered

Support for Multiple Journals

jrnl includes support for the creation and management of multiple journals, each of which can be stored as a single file or as a set of files. Entries are automatically timestamped in a human-readable format that makes it easy to view multiple entries at a time. jrnl can easily find the entries you want so that you can read them or edit them.

Support for External Editors

jrnl plays nicely with your favorite text editor. You may prefer to write journal entries in an editor. Or you may want to make changes that require a more comprehensive application. jrnl can filter specific entries and pass them to the external editor of your choice.

Encryption

jrnl includes support for 128-bit AES encryption using cryptography.Fernet. The encryption page explains jrnl's cryptographic framework in more detail.

Import and Export

jrnl makes it easy to import entries from other sources. Existing entries can be exported in a variety of formats.

Multi-Platform Support

jrnl is compatible with most operating systems. Pre-compiled binaries are available through several distribution channels, and you can build from source. See the installation page for more information.

Open-Source

jrnl is written in Python and maintained by a friendly community of open-source software enthusiasts.