Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wogong/dayone-to-roam
Day One to Roam Research
https://github.com/wogong/dayone-to-roam
dayone roam roamcult roamresearch
Last synced: about 1 month ago
JSON representation
Day One to Roam Research
- Host: GitHub
- URL: https://github.com/wogong/dayone-to-roam
- Owner: wogong
- License: mit
- Created: 2020-07-09T12:59:00.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-07-09T13:19:27.000Z (over 4 years ago)
- Last Synced: 2024-05-16T02:39:36.052Z (6 months ago)
- Topics: dayone, roam, roamcult, roamresearch
- Language: Python
- Homepage:
- Size: 3.91 KB
- Stars: 8
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Day One to Roam Research
This is a simple exporter script for `DayOne.app (Version 2)`.
Each entry in `journal_name.json` will be exported as Roam Research pages.
## Requirements
Currently, the script runs with Python3.6, and is tested on macOS and Ubuntu 16.04.
* Python 3.6 or higher
* You may need Homebrew, Anaconda, or pyenv to use the latest version of python.
* Python packages
* See requirements.txt.
## Install
Just copy `dayone-to-roam.py` to somewhere, or clone this repository.
```sh
$ git clone https://github.com/wogong/dayone-to-roam
$ cd dayone-to-roam
```
## Usage
- Your journal file should be exported by DayOne.app as 'JSON in Zip' and extracted into certain directory, for example:
```sh
-- journal_name.json JSON file exported from DayOne.app
```
- Define `EMAIL` and `HEADLINE` in dayone-to-roam.py
- Then run this script from your terminal.
```sh
# Show help (long-form only)
$ python dayone-to-roam.py --help
Usage: dayone-to-roam.py JSONPATH
Convert *.json exported by DayOne2.app to Roam Research
Options:
--help Show this message and exit.
# Convert
$ python dayone-to-roam.py export_dir/Journal.json
```
## Note
1. This repository is modified from [dayone2md](https://github.com/tuxedocat/dayone2md)
2. Roam Research json format details see [here](https://roamresearch.com/#/app/help/page/RxZF78p60)
3. I don't handle the dayone journal metadata except create and update time, while other metadata can be handled easily
4. Note that every journal item in Day One will be imported as Daily Notes in Roam Research, with content under HEADLINE as you defined before