Day One Word Cloud

This script takes your Day One entries and turns them into a formatted word cloud.

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Day One is a popular journaling app for Mac and iOS, now owned by WordPress owner Automattic.

I have 14 years worth of entries in my Day One app and I want to know what words I used most frequently so I decided to crack open the database and see if I could find this information.

Once I had the data I wanted a nice way to display it and I decided a word cloud would be ideal.

(back to top)

Built With

• PHP
• [Wordcloud2.js] (https://github.com/timdream/wordcloud2.js)

(back to top)

Getting Started

Running the script is very straight forward:

1. download the code
2. copy your Day One SQLite file to the same folder as the code
3. run php index.php

You can read more about how this all works in this blog post.

Prerequisites

Requirements are very simple - just requires PHP and I tested on v7.4.33.

Installation

1. Clone the repo:

   git clone https://github.com/williamsdb/dayone-wordcloud.git

(back to top)

Usage

1. make a copy of your Day One database (DayOne.sqlite) and place it in the same folder as the code. Read about how to find your database in this article.
2. Run the code: php index.php

You will see output similar to the following:

When the process of extracting the word counts completes a web page will open showing your word cloud.

For more information, please refer to the this blog post

(back to top)

Known Issues

• currently the conversion from frequencies to font sizes only works for < 10,000 max frequency
• the word with the largest frequest is shown in red but this frequency is currently hard-coded.

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the GNU General Public License v3.0. See LICENSE for more information.

(back to top)

Contact

Your Name - @spokenlikeageek - Contact

Project Link: https://github.com/williamsdb/dayone-wordcloud

(back to top)

Acknowledgments

• Timothy Guan-tin Chien for Wordcloud2.js
• Day One for the excellent app

(back to top)