Skip to main content

An append-only journaling tool using Joplin to store the entries

Project description

Joplin-jrnl

This is a CLI to append notes to a notebook as a running, append-only journaling system. The general inspiration was the jrnl command line tool. I like the general simplicity of how it works, but wanted the data to be more accessible through Joplin, which I use for general notetaking.

How the heck do I use this?

joplin-jrnl has been published to PyPi, so you should be able to get this running by simply executing pip install joplin-jrnl. You may then run the jj command to see how to further interact with it.

This is an early development version, as such there aren't many sanity checks in place. So at the moment you have to create an area for the configuration to live and there is currently no option to specify an alternate location (I'll get there ;) )

Create a note in joplin that will serve as your journal

In order for the script to work, you must have a note designated as the journal. To do this:

1. Open Joplin
2. Create a note (you can name it anything you wish)
3. Right click the note and select "copy markdown link"
4. You will get a value like "[note-name](:/df36fc8138da4169b29f0a577cba601e)  You need to paste in just the 'df36fc8138da4169b29f0a577cba601e' part as the note id in ~/.config/jj/conf.yaml.

create configuration file and path

1. `mkdir ~/.config/joplin-jrnl/`
2. `cp conf.yaml ~/.config/joplin-jrnl/`
3. Edit conf.yaml to reflect your values

demo

Demonstration

Roadmap/Hopes and Dreams

  • Add entries to a joplin note
  • Optionally use editor to make bigger edits (or to deal with annoying characters in entry that shell wants to expand to something
  • Search for entries based on content
  • Search for entries based on tags
  • More intelligent handling of options
    • Create a note if you don't specify one
    • Utilize options to override settings
  • Print out entries to CLI
  • Basically work like jrnl, but with joplin :)
  • Figure out asyncio stuff and use that instead of requests

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

joplin-jrnl-0.3.2.tar.gz (5.1 kB view hashes)

Uploaded Source

Built Distribution

joplin_jrnl-0.3.2-py3-none-any.whl (5.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page