https://github.com/jrnl-org/jrnl

Collect your thoughts and notes without leaving the command line.
https://github.com/jrnl-org/jrnl

cli command-line encrypted journal journal-application jrnl note-taking notes productivity python shell

Last synced: 3 days ago
JSON representation

Collect your thoughts and notes without leaving the command line.

• Host: GitHub
• URL: https://github.com/jrnl-org/jrnl
• Owner: jrnl-org
• License: gpl-3.0
• Created: 2012-03-29T17:23:58.000Z (about 13 years ago)
• Default Branch: develop
• Last Pushed: 2025-04-10T19:49:47.000Z (15 days ago)
• Last Synced: 2025-04-17T10:22:55.279Z (8 days ago)
• Topics: cli, command-line, encrypted, journal, journal-application, jrnl, note-taking, notes, productivity, python, shell
• Language: Python
• Homepage: https://jrnl.sh
• Size: 4.53 MB
• Stars: 6,669
• Watchers: 83
• Forks: 528
• Open Issues: 138
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

• stars - jrnl-org/jrnl
• jimsghstars - jrnl-org/jrnl - Collect your thoughts and notes without leaving the command line. (Python)
• awesome-starred - jrnl-org/jrnl - Collect your thoughts and notes without leaving the command line. (cli)
• definitive-opensource - jrnl

README

        












jrnl

 [![Testing](https://github.com/jrnl-org/jrnl/workflows/Testing/badge.svg)](https://github.com/jrnl-org/jrnl/actions?query=workflow%3ATesting)

 [![Downloads](https://pepy.tech/badge/jrnl)](https://pepy.tech/project/jrnl)

 [![Version](http://img.shields.io/pypi/v/jrnl.svg?style=flat)](https://pypi.python.org/pypi/jrnl/)

 [![Homebrew](https://img.shields.io/homebrew/v/jrnl?style=flat-square)](https://formulae.brew.sh/formula/jrnl)

 [![Gitter](https://img.shields.io/gitter/room/jrnl-org/jrnl)](https://gitter.im/jrnl-org/jrnl)

 [![Changelog](https://img.shields.io/badge/changelog-on%20github-green)](https://github.com/jrnl-org/jrnl/blob/develop/CHANGELOG.md)

====

_To get help, [submit an issue](https://github.com/jrnl-org/jrnl/issues/new/choose) on

GitHub._

`jrnl` is a simple journal application for the command line.

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](http://en.wikipedia.org/wiki/Advanced_Encryption_Standard).

## In a Nutshell

To make a new entry, just enter

``` sh

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

book.

```

`yesterday:` is  interpreted by `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 _jrnl_ to use your external editor.

For more information, please read the

[documentation](https://jrnl.sh).

## Contributors

### Maintainers

Our maintainers help keep the lights on for the project:

 * Jonathan Wren ([wren](https://github.com/wren))

 * Micah Ellison ([micahellison](https://github.com/micahellison))

Please thank them if you like `jrnl`!

### Code Contributors

This project is made with love by the many fabulous people who have contributed.

`jrnl` couldn't exist without each and every one of you!



If you'd also like to help make `jrnl` better, please see our [contributing

documentation](docs/contributing.md).

### Financial Backers

Another way show support is through direct financial contributions. These funds

go to covering our costs, and are a quick way to show your appreciation for

`jrnl`.

[Become a financial contributor](https://opencollective.com/jrnl/contribute)

and help us sustain our community.