{"id":51366228,"url":"https://github.com/rubicon/rubicon_set_future_file_added_date","last_synced_at":"2026-07-03T02:01:36.922Z","repository":{"id":322903847,"uuid":"1091108822","full_name":"rubicon/rubicon_set_future_file_added_date","owner":"rubicon","description":"A lightweight macOS CLI that sets a file’s Finder “Date Added” and aligns “Date Modified” for demos, automation, and reproducibility — even for future timestamps.","archived":false,"fork":false,"pushed_at":"2026-07-02T20:55:28.000Z","size":31,"stargazers_count":1,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-02T22:10:13.558Z","etag":null,"topics":["automation","bash","cli","developer-tools","file-date","file-date-changer","finder","macos","metadata","spotlight","timestamp"],"latest_commit_sha":null,"homepage":"https://github.com/rubicon/rubicon_set_future_file_added_date","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/rubicon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-06T15:10:58.000Z","updated_at":"2026-07-02T20:55:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rubicon/rubicon_set_future_file_added_date","commit_stats":null,"previous_names":["rubicon/rubicon_set_future_file_added_date"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rubicon/rubicon_set_future_file_added_date","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubicon%2Frubicon_set_future_file_added_date","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubicon%2Frubicon_set_future_file_added_date/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubicon%2Frubicon_set_future_file_added_date/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubicon%2Frubicon_set_future_file_added_date/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rubicon","download_url":"https://codeload.github.com/rubicon/rubicon_set_future_file_added_date/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubicon%2Frubicon_set_future_file_added_date/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35069183,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-03T02:00:05.635Z","response_time":110,"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":["automation","bash","cli","developer-tools","file-date","file-date-changer","finder","macos","metadata","spotlight","timestamp"],"created_at":"2026-07-03T02:00:40.638Z","updated_at":"2026-07-03T02:01:36.916Z","avatar_url":"https://github.com/rubicon.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rubicon: Set Future File Added Date\n\nA tiny, focused macOS CLI that sets a file’s Finder **Date Added** (and aligns **Date Modified**) to a specified instant — useful for demos, metadata control, Dock behavior tuning, and automation workflows.\n\n\u003e Works on macOS only. Requires Xcode Command Line Tools for a small helper build step.\n\n## Features\n\n- Set Finder **Date Added** to an exact timestamp\n- Align filesystem **Date Modified** (mtime) accordingly and report any OS clamping\n- Idempotent and chatty: prints before/after from both Spotlight (`mdls`) and filesystem (`stat`)\n- No external deps beyond standard macOS toolchain\n\n## Common Use Cases\n\n- **Dock Overlay Icons** — Set file “Date Added” timestamps to control the sort order and overlay indicators in your **Downloads stack** or Dock folders. Perfect for showcasing files at the top without renaming them.\n- **Demo Preparation** — Stage datasets, screenshots, or project assets so they appear freshly added.\n- **Data Migration Testing** — Validate timestamp preservation or system behavior with future or synthetic dates.\n- **Forensics \u0026 Metadata Research** — Explore how macOS stores and displays time-based metadata across versions.\n\n## Quickstart\n\n```bash\n# clone\ngit clone https://github.com/rubicon/rubicon_set_future_file_added_date.git\ncd rubicon_set_future_file_added_date\n\n# run\n./rubicon_set_future_file_added_date.sh /path/to/file --date \"2035-11-06T14:29:09Z\"\n```\n\nIf `--date` is omitted, the script defaults to **10 years in the future**.  \n**Needs Verification:** confirm the default offset matches your version of macOS.\n\n## Install (optional symlink)\n\n```bash\nsudo make install     # installs to /usr/local/bin (or /opt/homebrew/bin on Apple Silicon)\nrubicon-set-date --help\n```\n\n## Usage\n\n```bash\n./rubicon_set_future_file_added_date.sh \u003cfile\u003e [--date \"\u003cISO8601\u003e\"]\n```\n\n- `--date` accepts ISO 8601, e.g. `2025-12-31T23:59:59Z`.  \n  Local times are parsed by macOS `date` and converted to UTC.  \n  **Needs Verification:** locale handling for non-`en_US.UTF-8`.\n\n### Behavior Notes\n\n- macOS may clamp impossible future mtimes; the script reports the actual result.\n- Spotlight metadata updates can be asynchronous; this script reindexes and verifies the final state.\n\n## Badges\n\n[![CI](https://github.com/rubicon/rubicon_set_future_file_added_date/actions/workflows/ci.yaml/badge.svg)](https://github.com/rubicon/rubicon_set_future_file_added_date/actions/workflows/ci.yaml)\n[![Release](https://img.shields.io/github/v/release/rubicon/rubicon_set_future_file_added_date)](https://github.com/rubicon/rubicon_set_future_file_added_date/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Last Commit](https://img.shields.io/github/last-commit/rubicon/rubicon_set_future_file_added_date)](https://github.com/rubicon/rubicon_set_future_file_added_date/commits)\n\n## Development\n\n```bash\n# format \u0026 lint\nmake fmt\nmake lint\n\n# run tests (smoke tests only)\nmake test\n```\n\n### Tooling\n\n- **shfmt** for formatting\n- **shellcheck** for static analysis\n- **bats** for lightweight testing\n- **release-please** for automated versioning and changelog updates\n\nInstall tools on macOS:\n\n```bash\nbrew install shellcheck shfmt bats-core\n```\n\n## Contributing\n\nWe use Conventional Commits and automated releases.  \nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## Security\n\nPlease report vulnerabilities responsibly through [SECURITY.md](SECURITY.md).  \nNo guarantees are made; see [LICENSE](LICENSE) for terms.\n\n## License\n\nMIT © 2025 Dax Davis\n\n## Social Preview\n\nFor better share cards, set a repository social preview image — for example,  \na Finder window with a highlighted **Date Added** column and a subtle forward arrow motif.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubicon%2Frubicon_set_future_file_added_date","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frubicon%2Frubicon_set_future_file_added_date","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubicon%2Frubicon_set_future_file_added_date/lists"}