{"id":16408645,"url":"https://github.com/creativeprojects/imap","last_synced_at":"2025-03-23T06:30:56.861Z","repository":{"id":60145545,"uuid":"485944635","full_name":"creativeprojects/imap","owner":"creativeprojects","description":"IMAP tools: backup, copy, move your emails between servers and locally","archived":false,"fork":false,"pushed_at":"2025-01-03T22:43:43.000Z","size":235,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-18T18:15:38.191Z","etag":null,"topics":["backup","imap","imap-tools","imapsync","maildir"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/creativeprojects.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2022-04-26T20:54:31.000Z","updated_at":"2025-02-28T18:56:50.000Z","dependencies_parsed_at":"2024-10-28T15:27:20.578Z","dependency_job_id":"240eb8b1-cab7-4546-a972-d0be0fb08686","html_url":"https://github.com/creativeprojects/imap","commit_stats":{"total_commits":65,"total_committers":2,"mean_commits":32.5,"dds":0.06153846153846154,"last_synced_commit":"b3b5901cf675d19cea6ef93879c19be3c43ccbab"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativeprojects%2Fimap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativeprojects%2Fimap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativeprojects%2Fimap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativeprojects%2Fimap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/creativeprojects","download_url":"https://codeload.github.com/creativeprojects/imap/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245066496,"owners_count":20555402,"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","imap","imap-tools","imapsync","maildir"],"created_at":"2024-10-11T06:17:25.049Z","updated_at":"2025-03-23T06:30:55.924Z","avatar_url":"https://github.com/creativeprojects.png","language":"Go","readme":"# imap tools\n\n[![codecov](https://codecov.io/gh/creativeprojects/imap/branch/main/graph/badge.svg?token=3LGb0PvATl)](https://codecov.io/gh/creativeprojects/imap)\n\n\nBackup, copy, move your emails from and to IMAP servers. It can also load and save your emails locally.\n\n## backend supported:\n\n* IMAP\n* [Maildir](https://en.wikipedia.org/wiki/Maildir) (**not** for Windows)\n* Local database of compressed emails (boltDB)\n\n## commands implemented:\n\n* `list`: list mailboxes from the account\n* `copy`: copy all messages from one account to another one (incremental copy)\n* `history`: see an history of the actions on the account (only `copy` for now)\n* `selfupdate`: update automatically to the newest version from Github releases\n\n## keeping history for the incremental copy\n\nThe copy command will save a history of messages copied from the source. The history is saved on the destination backend. This is needed to associate the messages IDs of the source with the destination.\n\nThe way the history is saved is different for each backend:\n* local: the history is saved in the database file\n* Maildir: the history is saved in a file `\u003cmailbox name\u003e.history.json`\n* imap: the history is saved in a folder `.cache`\n\nThe incremental copy will break if you delete the history: all messages will be copied again.\n\n## copying from multiple sources while keeping history\n\nEach account is given an account ID so we can reference it in the history. The way this ID is generated depends on the backend:\n* local: randomly generated at creation and saved in the database file\n* Maildir: randomly generated at creation and saved in a file `.account.metadata.json`\n* imap: generated from the server URL and login name (not saved anywhere)\n\n## restart after error\n\nAfter a connection to an IMAP server is lost, the current copy is saved in the history. It should restart from where it stopped if you rerun the `copy` command.\n\n## configuration file\n\n```yaml\n---\naccounts:\n\n  imap-user:\n    type: imap\n    serverURL: localhost:993\n    username: user@example.com\n    password: pass\n    skipTLSverification: true\n\n  maildir-test:\n    type: maildir\n    root: ./maildir-test\n\n  local-test:\n    type: local\n    file: ./local/test.db\n\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreativeprojects%2Fimap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcreativeprojects%2Fimap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreativeprojects%2Fimap/lists"}