https://github.com/jez/viewjrnl
Shell script to group jrnl entries by date and add color.
https://github.com/jez/viewjrnl
cli jrnl writing
Last synced: 12 months ago
JSON representation
Shell script to group jrnl entries by date and add color.
- Host: GitHub
- URL: https://github.com/jez/viewjrnl
- Owner: jez
- Created: 2018-01-15T06:52:00.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-07-10T21:36:30.000Z (12 months ago)
- Last Synced: 2025-07-11T03:38:43.406Z (12 months ago)
- Topics: cli, jrnl, writing
- Language: Shell
- Homepage:
- Size: 279 KB
- Stars: 7
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# viewjrnl
> Shell script to group `jrnl` entries by date and add color.
The default output from `jrnl` is pretty plain. `viewjrnl` is a nicer way to
read entries from `jrnl` at the command line. Here it is in action:
As seen in the screenshot, the features of `viewjrnl` include:
- Grouping entries by date, to see where one day ends and another starts.
- 12-hour timestamps, which are what I'm more used to reading.
- Colorized output, so it's pleasant to look at.
For comparison, this is what the plain `jrnl` output looks like:
## Install
`viewjrnl` depends on `jq` version 1.6 or higher. At the time of writing, you'll
have to install the release candidate to use version 1.6. On macOS:
```
# If you already have jq < 1.6:
brew reinstall --devel jq
# Otherwise, to install it for the first time:
brew install --devel jq
```
After that, `viewjrnl` is just a single shell script. You can download it and
put it on your path anywhere. Alternatively, on macOS:
```
brew install jez/formulae/viewjrnl
```
## Usage
`viewjrnl` accepts any arguments you give it and passes them on to `jrnl`.
Alternatively, omit arguments to view your jrnl for today. Examples:
```bash
# See jrnl for just today
viewjrnl
# See jrnl for last week
viewjrnl -from 'last week'
# See last 10 jrnl entries
viewjrnl -n 10
# See all jrnl entries tagged @important:
viewjrnl @important
```
## License
[](https://jez.io/MIT-LICENSE.txt)