{"id":16653620,"url":"https://github.com/norm/imap-tools","last_synced_at":"2025-07-08T18:35:06.877Z","repository":{"id":66550708,"uuid":"23344851","full_name":"norm/imap-tools","owner":"norm","description":null,"archived":false,"fork":false,"pushed_at":"2015-12-06T09:46:24.000Z","size":9,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-12T17:49:51.604Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Perl","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/norm.png","metadata":{"files":{"readme":"README.markdown","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}},"created_at":"2014-08-26T08:41:36.000Z","updated_at":"2023-05-17T03:05:58.000Z","dependencies_parsed_at":"2023-02-28T13:16:19.608Z","dependency_job_id":null,"html_url":"https://github.com/norm/imap-tools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/norm/imap-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fimap-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fimap-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fimap-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fimap-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/norm","download_url":"https://codeload.github.com/norm/imap-tools/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norm%2Fimap-tools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264324526,"owners_count":23590889,"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":[],"created_at":"2024-10-12T09:46:04.672Z","updated_at":"2025-07-08T18:35:06.857Z","avatar_url":"https://github.com/norm.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"IMAP::Tools\n===========\n\nCommand line tools for manipulating email (on remove servers) via IMAP.\n\n\nInstallation\n------------\n\nThis is a perl library. Install with \n[cpanminus](http://search.cpan.org/~miyagawa/App-cpanminus/lib/App/cpanminus.pm).\n\n    # install cpanm (with brew, apt-get, etc)\n    sudo cpanm https://github.com/norm/imap-tools/tarball/master\n\n\nConfiguration\n-------------\n\nCreate a file at `$HOME/etc/imap.conf` with a section for each email account,\nlike so:\n\n    [cackhanded]\n        user = norm\n        pass = __________\n        host = imap.cackhanded.net\n        ssl  = 1\n\n    [gmail]\n        user = m.n.francis\n        pass = __________\n        host = imap.gmail.com\n        ssl  = 1\n\nA section is required even if there is only one account.\n\n\nScripts installed\n-----------------\n\n### imap-move\n\nMove email messages from inside one folder to another.\n\nArguments are the account, the 'from' folder, the 'to' folder. Then optionally\na subset ('newest', 'oldest' or 'random') if you don't want to move all\nmessages, and a count (defaults to 10).\n\n    # move everything from the \"tonight\" folder to the inbox\n    imap-move cackhanded 03-postpone/tonight INBOX\n\n    # move 10 randomly picked messages from \"holiday\" to the inbox\n    imap-move work holiday INBOX random\n\n    # move the newest 20 messages from \"on-hold\" to the inbox\n    imap-move gmail on-hold INBOX newest 20\n\n### imap-folder\n\nCreate or delete mail folders.\n\nArguments are the account, `create` or `delete` and then one or more folder\nnames.\n\n    # create two folders\n    imap-folder cackhanded create 01-spam 03-postpone/tonight\n\n    # delete a folder\n    imap-folder gmail delete on-hold\n\n### imap-list\n\nList the messages in a folder.\n\nArguments are the account and the folder (which defaults to `INBOX`).\n\n    # list new email\n    imap-list cackhanded\n\n    # what to do? what to do?\n    imap-list gmail outstanding/todo\n\n### imap-mark\n\nUpdate status of messages in a folder.\n\nArguments are the account, the folder, and then one or more status options:\n\n*   read\n*   unread\n*   flagged\n*   unflagged\n\nExamples:\n\n    # mark everything unread\n    imap-mark cackhanded INBOX unread\n\n    # mark everything unread and important\n    imap-mark gmail outstanding/todo unread flagged\n\n### imap-list-folders\n\nList all folders in an account.\n\nArguments are the account.\n\n    # list folders on google\n    imap-list-folders gmail\n\n*Important note*: there is a parsing bug in the `Net::IMAP::Client` library at\nversion 0.9505 that means folder names that start with numbers (eg\n`03-postpone/tonight`) are returned simply as the number. I have a \n[patched version 0.9506a][patch] which you can install instead (but be warned\n it has not had extensive testing, so if you use `Net::IMAP::Client` in other\nscripts/libraries you might not want to install this).\n\n    # upgrade Net::IMAP::Client\n    sudo cpanm git@github.com:norm/p5-Net-IMAP-Client-patch.git\n\n[patch]: https://github.com/norm/p5-Net-IMAP-Client-patch/\n\n### imap-depostpone\n\nHandles de-postponing email postponed by moving it into specially named\nfolders.\n\nArguments are the account, and optionally 'create' to create the folders\nit uses or 'crontab' to get a reminder of what to put in your crontab.\n\nThis needs more explanation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnorm%2Fimap-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnorm%2Fimap-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnorm%2Fimap-tools/lists"}