journey-cloud2md

Convert Journey.cloud backup data (JSON + images) to Obsidian-compatible Markdown files.

Features

• Converts Journey.cloud JSON exports to clean Markdown
• Two output modes: daily (one file per day) and yearly (one file per year)
• Copies attached images/videos to an assets/ directory
• Preserves metadata: mood, weather, location, tags, favourite status
• YAML frontmatter for Obsidian compatibility
• Timezone-aware date handling
• Zero runtime dependencies

Requirements

• Node.js >= 18.0.0

Installation

# Install globally
npm install -g journey-cloud2md

# Or run directly
npx journey-cloud2md <input-dir>

Usage

journey-cloud2md <input-dir> [output-dir] [options]

Arguments

| Argument | Description | Default | |-------------|------------------------------------------------|------------| | input-dir | Path to Journey.cloud backup directory (required) | - | | output-dir| Output directory for markdown files | ./output |

Options

| Option | Description | Default | |-------------------|--------------------------------------------------|---------| | --mode <mode> | Output mode: daily or yearly | daily | | --no-copy-assets| Skip copying image/video files to output | - | | -h, --help | Show help message | - | | -v, --version | Show version | - |

Examples

# Daily mode (default) - one file per day
journey-cloud2md ./journey-backup

# Yearly mode - one file per year, reverse chronological
journey-cloud2md ./journey-backup ./output --mode yearly

# Custom output directory
journey-cloud2md ./journey-backup ./my-obsidian-vault/journal

# Skip copying images
journey-cloud2md ./journey-backup ./output --no-copy-assets

How to Export from Journey.cloud

1. Go to Journey.cloud web app
2. Navigate to Settings > Export
3. Select Export to Zip
4. Extract the downloaded zip file
5. Use the extracted directory as input-dir

Output Format

Daily Mode (--mode daily)

Creates one .md file per day (e.g., 2024-12-25.md).

Single entry per day:

---
date: 2024-12-25
journal_date: 2024-12-25 14:30
mood: "Amazing"
weather: "Clear Sky, -4°C"
location: "Seoul, Korea"
tags: ["Christmas"]
favourite: true
---

Journal entry text here...

![](./assets/photo.jpg)

Multiple entries per day:

---
date: 2024-12-25
---

## 09:15
> mood: Good | weather: Snow, -2°C

Morning entry...

---

## 14:30
> mood: Amazing | location: Seoul

Afternoon entry...

![](./assets/photo.jpg)

Yearly Mode (--mode yearly)

Creates one .md file per year (e.g., journey-2024.md), entries sorted newest first.

---
year: 2024
entry_count: 365
---

## 2024-12-31 23:50
> mood: Amazing | weather: Snow, -3°C

New Year's Eve entry...

---

## 2024-12-30 14:20
> mood: Good

Another entry...

Metadata Mapping

| Journey Field | Markdown Output | |--------------|----------------| | mood (0-6) | Awful / Bad / So-so / Neutral / Good / Great / Amazing | | weather | Description + temperature (e.g., "Clear Sky, 5°C") | | address | Location string | | tags | YAML array | | favourite | Boolean | | photos | ![](./assets/filename.jpg) |

License

MIT