{"id":13583232,"url":"https://github.com/hasankhan/trash-cleaner","last_synced_at":"2025-06-21T21:11:08.119Z","repository":{"id":46520083,"uuid":"378821872","full_name":"hasankhan/trash-cleaner","owner":"hasankhan","description":"A program to delete trash emails based on keyword and label filters.","archived":false,"fork":false,"pushed_at":"2021-11-12T03:00:24.000Z","size":855,"stargazers_count":92,"open_issues_count":0,"forks_count":15,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-06T18:38:03.031Z","etag":null,"topics":["gmail","spam-filtering"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/hasankhan.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}},"created_at":"2021-06-21T05:56:05.000Z","updated_at":"2024-12-25T09:53:39.000Z","dependencies_parsed_at":"2022-07-22T11:02:24.560Z","dependency_job_id":null,"html_url":"https://github.com/hasankhan/trash-cleaner","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/hasankhan/trash-cleaner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasankhan%2Ftrash-cleaner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasankhan%2Ftrash-cleaner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasankhan%2Ftrash-cleaner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasankhan%2Ftrash-cleaner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hasankhan","download_url":"https://codeload.github.com/hasankhan/trash-cleaner/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasankhan%2Ftrash-cleaner/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261193152,"owners_count":23122913,"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":["gmail","spam-filtering"],"created_at":"2024-08-01T15:03:20.496Z","updated_at":"2025-06-21T21:11:03.105Z","avatar_url":"https://github.com/hasankhan.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Trash Cleaner\r\n\r\nA program to delete trash emails based on keyword and label filters.\r\n\r\n## Prerequisites\r\n\r\n[Node.js \u0026 npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)\r\n\r\n## Installation \r\n\r\n### Via NPM\r\n```bash\r\nnpm install -g trash-cleaner\r\n```\r\n### Via GitHub\r\n```\r\ngit clone https://github.com/hasankhan/trash-cleaner\r\ncd trash-cleaner\r\n# If you want to try out the development version then 'git checkout dev'\r\nnpm install -g\r\n```\r\n\r\n## Gmail Configuration\r\n1. Create a [Google Cloud Platform project with the API enabled](https://developers.google.com/workspace/guides/create-project).\r\n2. Create [Authorization credentials for a desktop application](https://developers.google.com/workspace/guides/create-credentials) and download `gmail.credentials.json` file in the `config` directory.\r\n3. Rename `keywords.json.sample` file in the `config` directory to `keywords.json` and update its contents.\r\n\r\n## Outlook Configuration\r\n1. Register an application with the [Microsoft identity platform](https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app).\r\n2. Rename `outlook.credentials.json.sample` file in the `config` directory to `outlook.credentials.json` and update its contents.\r\n3. Rename `keywords.json.sample` file in the `config` directory to `keywords.json` and update its contents.\r\n\r\n## Get Started\r\nTo get the list of all parameters type `trash-cleaner -h`\r\n\r\n```\r\nUsage: trash-cleaner [options]\r\n\r\nOptions:\r\n  -V, --version               output the version number\r\n  -r, --reconfig              reconfigures the auth for a service\r\n  -t, --dry-run               perform a dry-run cleanup without deleting the emails\r\n  -d, --debug                 output extra debugging info\r\n  -l, --launch                launch the auth url in the browser\r\n  -c, --configDirPath \u003cpath\u003e  the path to config directory (default: \"config\")\r\n  -s, --service \u003cservice\u003e     the email service to use (choices: \"gmail\", \"outlook\", default: \"gmail\")\r\n  -h, --help                  display help for command\r\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasankhan%2Ftrash-cleaner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhasankhan%2Ftrash-cleaner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasankhan%2Ftrash-cleaner/lists"}