0xdstn hello projects wiki reading art feeds

💻 lawa

A flat-file journaling script written in Python. You can prepend words with a + to mark them as "positive", a - to mark them as "negative", and a ~ to mark them as tags.

When viewing a post, it will display the key words in green, red, or blue (+,-,~), and show a count of how positive or negative a post was.

The intent is to journal, but with statistics on how you were feeling that day. The goal isn't to have only positive posts, but instead to assess your mental state over time. It's up to you to determine which words are positive or negative. Sometimes the same word could even be one or the other, depending on the context. It's all about how you feel.

Source code: https://github.com/0xdstn/lawa

  1. Etymology
  2. Data
  3. Timezone
  4. Usage
  5. Release notes


The name lawa comes from the language Toki Pona. It means "head" and felt appropriate since you are documenting your state of mind.


All data is stored in a single ~/.lawa file. Each day is prepended to the file and starts with the date. Line breaks are represented with a /.


There is a hard coded timezone of America/Los_Angeles in the script. You can comment it out to use your system timezone, or specify your own. Just modify the timezone line in the lawa.py file.


You can use the following commands (example: lawa.py add):

Release notes

👋 Hey! Thanks for reading! If you have any comments or questions about this post, or anything else, I'd love to chat! You can find the best way to contact me on my hello page or send me an email.