{"id":30185971,"url":"https://github.com/claeusdev/macsdrmr","last_synced_at":"2025-08-12T14:09:58.887Z","repository":{"id":270695747,"uuid":"911180673","full_name":"claeusdev/macsdrmr","owner":"claeusdev","description":"A very simple macos system data cleaner","archived":false,"fork":false,"pushed_at":"2025-01-02T22:11:07.000Z","size":9,"stargazers_count":4,"open_issues_count":2,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-02T16:27:17.875Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/claeusdev.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":"2025-01-02T12:26:23.000Z","updated_at":"2025-01-12T18:36:34.000Z","dependencies_parsed_at":"2025-01-02T17:02:32.751Z","dependency_job_id":null,"html_url":"https://github.com/claeusdev/macsdrmr","commit_stats":null,"previous_names":["claeusdev/macsdrmr"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/claeusdev/macsdrmr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claeusdev%2Fmacsdrmr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claeusdev%2Fmacsdrmr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claeusdev%2Fmacsdrmr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claeusdev%2Fmacsdrmr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/claeusdev","download_url":"https://codeload.github.com/claeusdev/macsdrmr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claeusdev%2Fmacsdrmr/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270073664,"owners_count":24522389,"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-08-12T02:00:09.011Z","response_time":80,"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":[],"created_at":"2025-08-12T14:09:56.750Z","updated_at":"2025-08-12T14:09:58.879Z","avatar_url":"https://github.com/claeusdev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# macOS System Data Cleaner\n\nA Node.js tool for analyzing and cleaning macOS system data storage. This tool helps you identify what's taking up space in your system storage and safely remove unnecessary files.\n\n## Installation\n\n1. Make sure you have Node.js installed on your Mac\n\n2. Clone the repository:\n```bash\ngit clone https://github.com/yourusername/macos-cleaner.git\ncd macos-cleaner\n```\n\n3. Install dependencies:\n```bash\nnpm install\n```\n\n## Usage\n\nThe tool provides three main commands:\n\n### 1. Scan System Data\nShows all system data locations and their sizes:\n```bash\nsudo node app.mjs scan\n```\n\nThis will analyze common system data locations including:\n- `/private/var/db/diagnostics` (System diagnostics)\n- `/private/var/folders` (Temporary files)\n- `/private/var/log` (System logs)\n- `/Library/Caches` (System caches)\n- And more...\n\n### 2. Inspect Specific Locations\nView contents and sizes of a specific directory:\n```bash\nsudo node app.mjs inspect /path/to/directory\n```\n\nExample:\n```bash\nsudo node app.mjs inspect /Library/Caches\n```\n\n### 3. Remove Items\nRemove specific files or directories:\n```bash\nsudo node app.mjs remove /path/to/item\n```\n\nExample:\n```bash\nsudo node app.mjs remove /Library/Caches/some-folder\n```\n\n## Safety Features\n\nThe tool includes several safety measures:\n- Protected paths list to prevent removal of critical system files\n- Recursive size calculation before removal\n- Size reporting after successful removal\n- Skip handling for inaccessible files\n- Error handling for insufficient permissions\n\n## Protected Locations\n\nThe following locations are protected from removal:\n- `/System`\n- `/Library/LaunchDaemons`\n- `/Library/LaunchAgents`\n- `/System/Library/LaunchDaemons`\n- `/System/Library/LaunchAgents`\n\n## Best Practices\n\n1. Always run `scan` first to understand your system's storage usage\n2. Use `inspect` to examine contents before removal\n3. Be cautious when removing items - make sure you know what they are\n4. Run with `sudo` to ensure proper access to system directories\n5. Consider backing up important data before removing large amounts of files\n\n## Common Issues\n\n1. \"Permission denied\" errors:\n   - Make sure to run the commands with `sudo`\n   - Some system files are protected by SIP (System Integrity Protection)\n\n2. \"Cannot remove protected system path\":\n   - The file/directory is in the protected paths list\n   - This is a safety feature to prevent system damage\n\n## Warning\n\nWhile this tool includes safety checks, use it at your own risk. Be especially careful when removing files from system locations. When in doubt:\n1. Research what the files/directories are used for\n2. Consider using macOS's built-in storage management tools\n3. Back up important data before making changes\n\n## Limitations\n\n- Cannot remove SIP-protected files\n- Some system files may require additional permissions\n- Total sizes may be approximate due to rapidly changing system files\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclaeusdev%2Fmacsdrmr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclaeusdev%2Fmacsdrmr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclaeusdev%2Fmacsdrmr/lists"}