PHPackages                             ergebnis/day-one-to-obsidian-converter - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. ergebnis/day-one-to-obsidian-converter

AbandonedArchivedProject[CLI &amp; Console](/categories/cli)

ergebnis/day-one-to-obsidian-converter
======================================

Provides a console command for converting DayOne journals to Obsidian notes.

1.1.0(2y ago)819[1 PRs](https://github.com/ergebnis/day-one-to-obsidian-converter/pulls)MITPHPPHP ~8.1.0 || ~8.2.0 || ~8.3.0

Since Nov 15Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/ergebnis/day-one-to-obsidian-converter)[ Packagist](https://packagist.org/packages/ergebnis/day-one-to-obsidian-converter)[ Docs](https://github.com/ergebnis/day-one-to-obsidian-converter)[ RSS](/packages/ergebnis-day-one-to-obsidian-converter/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (16)Versions (4)Used By (0)

day-one-to-obsidian-converter
=============================

[](#day-one-to-obsidian-converter)

[![Integrate](https://github.com/ergebnis/day-one-to-obsidian-converter/workflows/Integrate/badge.svg)](https://github.com/ergebnis/day-one-to-obsidian-converter/actions)[![Merge](https://github.com/ergebnis/day-one-to-obsidian-converter/workflows/Merge/badge.svg)](https://github.com/ergebnis/day-one-to-obsidian-converter/actions)[![Release](https://github.com/ergebnis/day-one-to-obsidian-converter/workflows/Release/badge.svg)](https://github.com/ergebnis/day-one-to-obsidian-converter/actions)[![Renew](https://github.com/ergebnis/day-one-to-obsidian-converter/workflows/Renew/badge.svg)](https://github.com/ergebnis/day-one-to-obsidian-converter/actions)

[![Code Coverage](https://camo.githubusercontent.com/6df609888a9463b3391b80fd7dd692237f68de5bb36d96e2131ea32d700cecb7/68747470733a2f2f636f6465636f762e696f2f67682f65726765626e69732f6461792d6f6e652d746f2d6f6273696469616e2d636f6e7665727465722f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/ergebnis/day-one-to-obsidian-converter)[![Type Coverage](https://camo.githubusercontent.com/6580534c01cbe10701a858d9747c70890696f8c0188a5a6be53467ec6e76ad36/68747470733a2f2f73686570686572642e6465762f6769746875622f65726765626e69732f6461792d6f6e652d746f2d6f6273696469616e2d636f6e7665727465722f636f7665726167652e737667)](https://shepherd.dev/github/ergebnis/day-one-to-obsidian-converter)

[![Latest Stable Version](https://camo.githubusercontent.com/e5e6cbf9cd406df5ec0fbb1ac90d6e397b1c586e144e323149bd0c55657ac984/68747470733a2f2f706f7365722e707567782e6f72672f65726765626e69732f6461792d6f6e652d746f2d6f6273696469616e2d636f6e7665727465722f762f737461626c65)](https://packagist.org/packages/ergebnis/day-one-to-obsidian-converter)[![Total Downloads](https://camo.githubusercontent.com/3981564735a464fc68f9c6aace4012d48877e647a9a865c22e948a15fec6edcc/68747470733a2f2f706f7365722e707567782e6f72672f65726765626e69732f6461792d6f6e652d746f2d6f6273696469616e2d636f6e7665727465722f646f776e6c6f616473)](https://packagist.org/packages/ergebnis/day-one-to-obsidian-converter)[![Monthly Downloads](https://camo.githubusercontent.com/a1645ab80c8160aeeae636f2f9820259f00dea141ce99febc2363733a053807e/687474703a2f2f706f7365722e707567782e6f72672f65726765626e69732f6461792d6f6e652d746f2d6f6273696469616e2d636f6e7665727465722f642f6d6f6e74686c79)](https://packagist.org/packages/ergebnis/day-one-to-obsidian-converter)

This project provides a [`composer`](https://getcomposer.org) package with a console command for converting [DayOne](https://dayoneapp.com) journals to [Obsidian](https://obsidian.md) notes.

Installation
------------

[](#installation)

Run

```
composer require ergebnis/day-one-to-obsidian-converter
```

Usage
-----

[](#usage)

Run

```
php bin/day-one-to-obsidian-converter
```

The command will

- look for JSON files in ``
- convert JSON files that match the JSON Schema in [`resource/day-one/schema.json`](resource/day-one/schema.json) to Markdown files in ``

Ideally, the `` should not exist yet.

Demo
----

[](#demo)

Run

```
git clone git@github.com:ergebnis/day-one-to-obsidian-converter.git
```

to clone this repository.

Run

```
composer install
```

to install dependencies with `composer`.

Run

```
php bin/day-one-to-obsidian-converter demo/day-one demo/obsidian
```

to see the converter in action.

Changelog
---------

[](#changelog)

The maintainers of this project record notable changes to this project in a [changelog](CHANGELOG.md).

Contributing
------------

[](#contributing)

The maintainers of this project suggest following the [contribution guide](.github/CONTRIBUTING.md).

Code of Conduct
---------------

[](#code-of-conduct)

The maintainers of this project ask contributors to follow the [code of conduct](.github/CODE_OF_CONDUCT.md).

General Support Policy
----------------------

[](#general-support-policy)

The maintainers of this project provide limited support.

You can support the maintenance of this project by [sponsoring @ergebnis](https://github.com/sponsors/ergebnis).

PHP Version Support Policy
--------------------------

[](#php-version-support-policy)

This project supports PHP versions with [active and security support](https://www.php.net/supported-versions.php).

The maintainers of this project add support for a PHP version following its initial release and drop support for a PHP version when it has reached the end of security support.

Security Policy
---------------

[](#security-policy)

This project has a [security policy](.github/SECURITY.md).

License
-------

[](#license)

This project uses the [MIT license](LICENSE.md).

Credits
-------

[](#credits)

This converter is inspired by [`quantumgardener/dayone-to-obsidian`](https://github.com/quantumgardener/dayone-to-obsidian).

The list of non-printable characters for the [`RemoveNonPrintableCharacters`](src/Inside/Domain/DayOneToObsidian/Text/RemoveNonPrintableCharacters.php) text processor is obtained from [`PhpCsFixer\Fixer\Basic\NonPrintableCharacterFixer`](https://github.com/FriendsOfPHP/PHP-CS-Fixer/blob/v3.10.0/src/Fixer/Basic/NonPrintableCharacterFixer.php#L58-L64), originally created by [Ivan Borzenkov](https://github.com/ivan1986).

The files in [`demo/day-one/`](demo/day-one/) are taken from [Importing data to Day One: Details about the import file types](https://dayoneapp.com/guides/settings/importing-data-to-day-one/#details-about-the-import-file-types-), and can be downloaded [here](https://bloom-documentation.s3.amazonaws.com/JSON+Export+example.zip)

Social
------

[](#social)

Follow [@localheinz](https://twitter.com/intent/follow?screen_name=localheinz) and [@ergebnis](https://twitter.com/intent/follow?screen_name=ergebnis) on Twitter.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance54

Moderate activity, may be stable

Popularity12

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~391 days

Total

2

Last Release

882d ago

PHP version history (2 changes)1.0.0PHP ^8.1

1.1.0PHP ~8.1.0 || ~8.2.0 || ~8.3.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/8cabc9efd157e2b47aa5aa9830180f5ebd07813cc3e93ff1a9993b2c3d264909?d=identicon)[localheinz](/maintainers/localheinz)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (496 commits)")[![ergebnis-bot](https://avatars.githubusercontent.com/u/59560144?v=4)](https://github.com/ergebnis-bot "ergebnis-bot (486 commits)")[![localheinz](https://avatars.githubusercontent.com/u/605483?v=4)](https://github.com/localheinz "localheinz (187 commits)")

---

Tags

converterday-oneobsidian

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm, Rector

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ergebnis-day-one-to-obsidian-converter/health.svg)

```
[![Health](https://phpackages.com/badges/ergebnis-day-one-to-obsidian-converter/health.svg)](https://phpackages.com/packages/ergebnis-day-one-to-obsidian-converter)
```

###  Alternatives

[drush/drush

Drush is a command line shell and scripting interface for Drupal, a veritable Swiss Army knife designed to make life easier for those of us who spend some of our working hours hacking away at the command prompt.

2.4k57.4M685](/packages/drush-drush)[crunzphp/crunz

Schedule your tasks right from the code.

2292.0M6](/packages/crunzphp-crunz)[humbug/php-scoper

Prefixes all PHP namespaces in a file or directory.

7963.0M35](/packages/humbug-php-scoper)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[crazywhalecc/static-php-cli

Build single static PHP binary, with PHP project together, with popular extensions included.

1.8k13.9k](/packages/crazywhalecc-static-php-cli)[acquia/orca

A tool for testing a company's software packages together in the context of a realistic, functioning, best practices Drupal build

32902.4k](/packages/acquia-orca)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
