{"id":13592244,"url":"https://github.com/vzhd1701/evernote-backup","last_synced_at":"2025-04-14T13:53:22.719Z","repository":{"id":41958056,"uuid":"361166211","full_name":"vzhd1701/evernote-backup","owner":"vzhd1701","description":"Backup \u0026 export all Evernote notes and notebooks","archived":false,"fork":false,"pushed_at":"2025-04-14T08:49:09.000Z","size":470,"stargazers_count":1127,"open_issues_count":7,"forks_count":85,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-04-14T09:46:19.522Z","etag":null,"topics":["backup","database","enex","enex-files","evernote","evernote-backup","evernote-client","evernote-data","evernote-export","evernote-notes","export","notebooks","python","sync","yinxiang"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vzhd1701.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":["https://www.buymeacoffee.com/vzhd1701","https://github.com/vzhd1701/donation-wallets"]}},"created_at":"2021-04-24T13:16:00.000Z","updated_at":"2025-04-14T08:49:13.000Z","dependencies_parsed_at":"2024-06-21T16:34:08.259Z","dependency_job_id":"353e7416-b3cd-4702-a988-94327f89ee5b","html_url":"https://github.com/vzhd1701/evernote-backup","commit_stats":{"total_commits":122,"total_committers":3,"mean_commits":"40.666666666666664","dds":"0.016393442622950838","last_synced_commit":"e09a805b8187aa229b7cf70ce69fd1225a347626"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vzhd1701%2Fevernote-backup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vzhd1701%2Fevernote-backup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vzhd1701%2Fevernote-backup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vzhd1701%2Fevernote-backup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vzhd1701","download_url":"https://codeload.github.com/vzhd1701/evernote-backup/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248860125,"owners_count":21173339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backup","database","enex","enex-files","evernote","evernote-backup","evernote-client","evernote-data","evernote-export","evernote-notes","export","notebooks","python","sync","yinxiang"],"created_at":"2024-08-01T16:01:07.289Z","updated_at":"2025-04-14T13:53:22.692Z","avatar_url":"https://github.com/vzhd1701.png","language":"Python","funding_links":["https://www.buymeacoffee.com/vzhd1701","https://github.com/vzhd1701/donation-wallets"],"categories":["Python"],"sub_categories":[],"readme":"# evernote-backup\n\n[![PyPI version](https://img.shields.io/pypi/v/evernote-backup?label=version)](https://pypi.python.org/pypi/evernote-backup)\n[![Python Version](https://img.shields.io/pypi/pyversions/evernote-backup.svg)](https://pypi.org/project/evernote-backup/)\n[![tests](https://github.com/vzhd1701/evernote-backup/actions/workflows/test.yml/badge.svg)](https://github.com/vzhd1701/evernote-backup/actions/workflows/test.yml)\n[![codecov](https://codecov.io/gh/vzhd1701/evernote-backup/branch/master/graph/badge.svg)](https://codecov.io/gh/vzhd1701/evernote-backup)\n\nBackup your notes \u0026 notebooks from Evernote locally and export them at any time!\n\n## Features\n\n- Quickly sync all your notes into the SQLite database for backup.\n- Export all backed up notes in `*.enex` format, as **notebooks** or **single notes**.\n- Support for both [Evernote](https://evernote.com/) and [Yinxiang (印象笔记)](https://yinxiang.com/).\n\n## Installation\n\n### Using portable binary\n\n[**Download the latest release**](https://github.com/vzhd1701/evernote-backup/releases/latest) for your OS.\n\n### With [Homebrew](https://brew.sh/) (Recommended for macOS)\n\n```bash\n$ brew install evernote-backup\n```\n\n### With [PIPX](https://github.com/pypa/pipx) (Recommended for Linux \u0026 Windows)\n\n```shell\n$ pipx install evernote-backup\n```\n\n### With PIP\n\n```bash\n$ pip install --user evernote-backup\n```\n\n**Python 3.8 or later required.**\n\n### With [**Docker**](https://docs.docker.com/)\n\n[![Docker Image Size (amd64)](\u003chttps://img.shields.io/docker/image-size/vzhd1701/evernote-backup?arch=amd64\u0026label=image%20size%20(amd64)\u003e)](https://hub.docker.com/r/vzhd1701/evernote-backup)\n[![Docker Image Size (arm64)](\u003chttps://img.shields.io/docker/image-size/vzhd1701/evernote-backup?arch=arm64\u0026label=image%20size%20(arm64)\u003e)](https://hub.docker.com/r/vzhd1701/evernote-backup)\n\n```bash\n$ docker run --rm -t -v \"$PWD\":/tmp vzhd1701/evernote-backup:latest\n```\n\nTo log in to Evernote using OAuth with Docker, you'll have to forward port 10500 for a callback:\n\n```bash\n$ docker run --rm -t -v \"$PWD\":/tmp -p 10500:10500 vzhd1701/evernote-backup:latest init-db\n```\n\n### From source\n\nThis project uses [poetry](https://python-poetry.org/) for dependency management and packaging. You will have to install it first. See [poetry official documentation](https://python-poetry.org/docs/) for instructions.\n\n```shell\n$ git clone https://github.com/vzhd1701/evernote-backup.git\n$ cd evernote-backup/\n$ poetry install\n$ poetry run evernote-backup\n```\n\n## Usage\n\n### Step 1. Database initialization\n\nTo start you need to initialize your database.\n\n```console\n$ evernote-backup init-db\nUsername or Email: user@example.com\nPassword:\nLogging in to Evernote...\nEnter one-time code: 120917\nAuthorizing auth token, evernote backend...\nSuccessfully authenticated as user!\nCurrent login will expire at 2022-03-10 10:22:00.\nInitializing database en_backup.db...\nReading database en_backup.db...\nSuccessfully initialized database for user!\n```\n\nIf you log in to Evernote, it will prompt you to complete OAuth login using your browser.\n\nTo connect to **Yinxiang** instead of Evernote, use `--backend china` option. It will prompt you to enter your account credentials. You can provide them beforehand with `--user` and `--password` options. OAuth is not supported for **Yinxiang**.\n\n### Step 2. Downloading Evernote data\n\nThen you will be able to sync your account data.\n\n```console\n$ evernote-backup sync\nReading database en_backup.db...\nAuthorizing auth token, evernote backend...\nSuccessfully authenticated as user!\nCurrent login will expire at 2022-03-10 10:22:00.\nSyncing latest changes...\n  [####################################]  6763/6763\n566 notes to download...\n  [####################################]  566/566\nUpdated or added notebooks: 23\nUpdated or added notes: 566\nExpunged notebooks: 0\nExpunged notes: 0\nSynchronization completed!\n```\n\nYou can interrupt this process at any point. It will continue from where it's left off when you will rerun `evernote-backup sync`.\n\n**evernote-backup** keeps track of the sync state and downloads only new changes that have been made since the last run. So every sync will go pretty fast, but you'll have to wait for a bit on the first run if you have a lot of notes in your account. Syncing uses the Evernote Cloud API.\n\n### Step 3. Exporting `*.enex` files\n\nFinally, you can export your data into specified **output directory**\n\n```console\n$ evernote-backup export output_dir/\nReading database en_backup.db...\nExporting notes...\n  [####################################]  23/23\nAll notes have been exported!\n```\n\nBy default, **evernote-backup** will export notes by packing them into notebooks, one `*.enex` file each. If you want to extract notes as **separate files**, use the `--single-notes` flag.\n\nTo also include **trashed** notes in export, use the `--include-trash` flag.\n\nExporting is performed wholly offline, and does not require access to the Evernote Cloud API to convert the notes.\n\nThat's it! So to export all your Evernote data, you will have to run three commands:\n\n```console\n$ evernote-backup init-db\n$ evernote-backup sync\n$ evernote-backup export output_dir/\n```\n\nAfter first initialization, you can schedule `evernote-backup sync` command to keep your local database always up-to-date. However, `evernote-backup export` will always re-export all notebooks to the specified output directory.\n\n### How to refresh expired token\n\nIn case your auth token that you initialized your database with expires, you have an option to re-authorize it by running the `evernote-backup reauth` command. It has the same options as the `init-db` command.\n\n## Getting help\n\nIf you found a bug or have a feature request, please [open a new issue](https://github.com/vzhd1701/evernote-backup/issues/new/choose).\n\nIf you have a question about the program or have difficulty using it, you are welcome to [the discussions page](https://github.com/vzhd1701/evernote-backup/discussions). You can also mail me directly, I'm always happy to help.\n\n## Further reading\n\n- [How to export Notebooks in new Evernote client](https://help.evernote.com/hc/en-us/articles/360053159414-Export-notebooks)\n- [Backing up and restoring Evernote data (Reference article) (requires registration)](https://discussion.evernote.com/forums/topic/86152-backing-up-and-restoring-evernote-data-reference-article/?tab=comments#comment-367110)\n- [Migrating Your Notes from Evernote to Obsidian](https://www.dmuth.org/migrating-from-evernote-to-obisidian/)\n- https://github.com/davidedc/A-thousand-notes\n\n## Similar projects\n\nI've also combined a [bigger list](https://github.com/vzhd1701/evernote-backup/blob/master/SIMILAR_PROJECTS.md) where I included all adjacent projects that I could find.\n\n### Export\n\nProject                                                                |  Description                                                                                                      |  Language\n-----------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|--------------\n[ExportAllEverNote](https://github.com/dong-s/ExportAllEverNote)       |  Export notes in ENEX format driectly from your account                                                           |  Python\n[evernote2](https://github.com/JackonYang/evernote2)                   |  Improved version of standard Evernote SDK. Also provides a tool for exporting notes driectly from your account   |  Python\n[evernote-to-sqlite](https://github.com/dogsheep/evernote-to-sqlite)   |  Converts ENEX files into SQLite database                                                                         |  Python\n[enote](https://github.com/tkjacobsen/enote)                           |  Utility that can backup Evernote notes and notebooks                                                             |  Python\n[evernote-exporter](https://github.com/shawndaniel/evernote-exporter)  |  Export notes from old Evernote local database .exb format                                                        |  Python\n\n### Export / Sync\n\nProject                                                                |  Description                                                                                                      |  Language\n-----------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|--------------\n[SyncToGit](https://github.com/KostyaEsmukov/SyncToGit)                |  Syncs your notes with their resources to the git repository in HTML format                                       |  Python\n[evermark](https://github.com/akuma/evermark)                          |  A command line tool for syncing markdown notes to Evernote                                                       |  JavaScript\n[eversync](https://github.com/yejianye/eversync)                       |  Sync your local directories with evernote notebooks                                                              |  Python\n[EverMark](https://github.com/liuwons/EverMark)                        |  A tool that can sync local markdown/text notes to Evernote                                                       |  Python\n[LocalEvernote](https://github.com/lwabish/LocalEvernote)              |  Syncs local directory containing notes in Markdown format with Evernote                                          |  Python\n[gnsync](https://github.com/vitaly-zdanevich/geeknote)                 |  Part of Geeknote                                                                                                 |  Python\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvzhd1701%2Fevernote-backup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvzhd1701%2Fevernote-backup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvzhd1701%2Fevernote-backup/lists"}