{"id":13581946,"url":"https://github.com/woojiahao/gmail-filter-organiser","last_synced_at":"2025-09-04T09:33:25.338Z","repository":{"id":90942330,"uuid":"264808841","full_name":"woojiahao/gmail-filter-organiser","owner":"woojiahao","description":"CLI tool to organise your filters in Gmail","archived":false,"fork":false,"pushed_at":"2020-05-18T07:50:27.000Z","size":21,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-03-31T17:39:27.060Z","etag":null,"topics":["command-line","command-line-tool","email-filters","gmail","gmail-api","go","golang"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/woojiahao.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}},"created_at":"2020-05-18T02:51:55.000Z","updated_at":"2024-06-19T06:45:03.888Z","dependencies_parsed_at":null,"dependency_job_id":"429fa1b8-ee5d-4202-a73b-c187b0c34096","html_url":"https://github.com/woojiahao/gmail-filter-organiser","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/woojiahao/gmail-filter-organiser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woojiahao%2Fgmail-filter-organiser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woojiahao%2Fgmail-filter-organiser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woojiahao%2Fgmail-filter-organiser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woojiahao%2Fgmail-filter-organiser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/woojiahao","download_url":"https://codeload.github.com/woojiahao/gmail-filter-organiser/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woojiahao%2Fgmail-filter-organiser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273583421,"owners_count":25131820,"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-09-04T02:00:08.968Z","response_time":61,"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":["command-line","command-line-tool","email-filters","gmail","gmail-api","go","golang"],"created_at":"2024-08-01T15:02:20.551Z","updated_at":"2025-09-04T09:33:25.039Z","avatar_url":"https://github.com/woojiahao.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# gmail-filter-organiser\n\nCLI tool to organise your filters in Gmail\n\n## Running this tool\n\nEnsure that Go is installed. If it isn't, visit [this link](https://golang.org/doc/install) to get \nit setup.\n\nEnsure that you setup the Gmail API with your own API console. Follow step 1 [here](https://developers.google.com/gmail/api/quickstart/go) \nand make sure that you copy the `credentials.json` file to the project root.\n\nClone the repository\n\n```bash\n$ git clone https://github.com/woojiahao/gmail-filter-organiser\n$ cd gmail-filter-organiser/\n```\n\nRun the tool\n\n```bash\n$ go run cmd/main.go\n```\n\nIf this is the first time you are running this tool (or if the token has expired), the tool will\nprompt you to visit the site to authenticate your application. Once it has been authenticated, you\nwill receive a token that you can copy over to the tool and press \"Enter\".\n\n## Motivations to make this tool\n\nI have been using Gmail's labels and filters system to organise my inbox for a while now and one \nissue I have faced is having too many filters being created that assign a group of emails to the\nsame label. This is because Gmail's web interface is severely limited in allowing users to \ncreate and manage their filters for their accounts. For instance, a filter can only assign a \nsearch criteria to a single label at a time. Therefore, trying to assign a single email to more\nthan one label will require multiple filters. Additionally, two filters may have different search \ncriteria to the same label.\n\nThe goal of this tool is to clean these repeated filters to clean up any clutter and make \norganising filters and labels in Gmail a lot easier.\n\n## Use case\n\nThe use case of this CLI is very minimal as it is meant to suit my own use of filters, which\nrevolves around three key criterion when creating the filter:\n\n1. Skip inbox - remove the label \"INBOX\"\n2. Apply the label \n3. Apply filter to all existing elements\n\nIn doing so, we do not add any additional conditionals to the filter (this includes TO, SUBJECT, \nHAS THE WORDS, DOESN'T HAVE, SIZE, ATTACHMENT, etc).\n\nThere may be plans to add more but for the current use case, it is not supported.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoojiahao%2Fgmail-filter-organiser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwoojiahao%2Fgmail-filter-organiser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoojiahao%2Fgmail-filter-organiser/lists"}