{"id":31947545,"url":"https://github.com/morgant/claws-mail-labels","last_synced_at":"2025-10-14T11:45:52.847Z","repository":{"id":310925516,"uuid":"1041543979","full_name":"morgant/claws-mail-labels","owner":"morgant","description":"Fast-ish Gmail-like \"labels\" support for claws-mail using mairix","archived":false,"fork":false,"pushed_at":"2025-08-30T00:38:03.000Z","size":13,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-05T18:06:18.781Z","etag":null,"topics":["claws-mail","email","folder-management","gmail","google-workspace","imap","indexing","labels","mairix"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/morgant.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2025-08-20T16:36:45.000Z","updated_at":"2025-09-09T11:06:56.000Z","dependencies_parsed_at":"2025-08-21T04:32:36.901Z","dependency_job_id":"deac123c-83ad-4427-b220-2108eb7a9039","html_url":"https://github.com/morgant/claws-mail-labels","commit_stats":null,"previous_names":["morgant/claws-mail-labels"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/morgant/claws-mail-labels","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morgant%2Fclaws-mail-labels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morgant%2Fclaws-mail-labels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morgant%2Fclaws-mail-labels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morgant%2Fclaws-mail-labels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/morgant","download_url":"https://codeload.github.com/morgant/claws-mail-labels/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morgant%2Fclaws-mail-labels/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019073,"owners_count":26086518,"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","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["claws-mail","email","folder-management","gmail","google-workspace","imap","indexing","labels","mairix"],"created_at":"2025-10-14T11:45:51.756Z","updated_at":"2025-10-14T11:45:52.838Z","avatar_url":"https://github.com/morgant.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claws-mail-labels\nby Morgan Aldridge \u003cmorgant@makkintosshu.com\u003e\n\n## OVERVIEW\n\n`claws-mail-labels` is a multi-function 'Action' script for [Claws Mail](https://claws-mail.org/) to aid in managing email message 'labels' (tags, essentially) within Gmail and/or Google Workspace IMAP accounts. It utilizes [mairix](https://github.com/vandry/mairix) for performant indexing \u0026 searching email messages in the claws-mail(1) local IMAP cache, bending the rules a bit to perform fast re-indexing of individual labels.\n\n**IMPORTANT:** _This project is very much a work-in-progress and developed specifically for my needs. Use at your own risk!_\n\n### Prerequisites\n\n* perl(1)\n* mairix(1)\n* An IMAP account synchronized for offline use\n* Claws Mail 'Actions' configured to execute `claws-mail-labels`:\n    * \"Show Message Labels\": `~/libexec/claws-mail-actions -f %f -l`\n    * \"Reindex Message Labels\": `~/libexec/claws-mail-actions -f %f -r`\n\n#### Suggested\n\n* [zenity](https://gitlab.gnome.org/GNOME/zenity)\n* Fast storage device to improve message indexing/re-indexing time\n\n### Limitations\n\n* It can only search for labels of a single message\n* It only supports IMAP accounts (though could be modified to support POP \u0026 local MH accounts)\n* It cannot find messages that have not yet been downloaded from the IMAP server and stored locally\n* It cannot [yet] search across multiple accounts\n\n### Directory Structure\n\n```\n~/.claws-mail/\n  labelscache/\n    \u003cserver\u003e/\n      \u003cmailbox\u003e/\n        mairixrc\n        mairixrc-reindex\n        mairixdb\n      .../\n    ../\n```\n\n## USAGE\n\n### Initialize Mailbox\n\nOne can initialize `claws-mail-labels`'s mairix(1) configuration files for Google Gmail/Workspace IMAP account by executing (replacing `\u003cmailbox\u003e` with the email address, e.g. \"some-fake-address@gmail.com\"):\n\n```\n~/libexec/claws-mail-labels -m \u003cmailbox\u003e\n```\n\n### Mailbox Full Index\n\nOnce a mailbox has been initialized, one can perform a full index by executing (again, replacing `\u003cmailbox` with the email address, e.g. \"some-fake-address@gmail.com\"):\n\n```\n~/libexec/claws-mail-labels -m \u003cmailbox\u003e -i\n```\n\n#### Full Index of All Mailboxes\n\nOnce one or more mailboxes have been initialized, one can perform a full index of all mailboxes as follows:\n\n```\n~/libexec/claws-mail-labels -a -i\n```\n\n### Configure Claws Mail Actions\n\n#### Message Labels/Show\n\nAdd a \"Shell command\" Action:\n\n* **Menu name:** `Message Labels/Show`\n* **Command:** `~/libexec/claws-mail-labels -f %f -l`\n\n##### With Zenity\n\nIf you'd like a nicer GUI display, use the following command instead:\n\n```\n~/libexec/claws-mail-labels -f %f -l | zenity --list --title=\"Labels\" --text=\"%f\" --hide-header --column=\"Label\"\n```\n\n#### Message Labels/Reindexing\n\nAdd a \"Shell command\" Action:\n\n* **Menu name:** `Message Labels/Re-index`\n* **Command:** `~/libexec/claws-mail-labels -f %f -r`\n\n## REFERENCE\n\n* [Claws Mail FAQ: Actions](https://claws-mail.org/faq/index.php/Actions)\n* [Claws Mail FAQ: Using Claws Mail with other programs](https://claws-mail.org/faq/index.php/Using_Claws_Mail_with_other_programs)\n    * [Claws Mail FAQ: Using Claws Mail with other programs (How can I use Claws Mail with mairix?](https://www.claws-mail.org/faq/index.php/Using_Claws_Mail_with_other_programs#How_can_I_use_Claws_Mail_with_mairix.3F)\n* [Wikipedia: MH Message Handling System](https://en.wikipedia.org/wiki/MH_Message_Handling_System)\n* [Zenity Manual](https://help.gnome.org/users/zenity/stable/index.html.en)\n\n## LICENSE\n\nReleased under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorgant%2Fclaws-mail-labels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmorgant%2Fclaws-mail-labels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorgant%2Fclaws-mail-labels/lists"}