Skip to content

Releases: fluxnull/WinTouch

WinTouch v0.3.0 - Windows-native touch.exe

29 May 15:33
@fluxnull fluxnull
v0.3.0
d23842c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
WinTouch v0.3.0 - Windows-native touch.exe Latest
Latest

WinTouch v0.3.0

Initial Windows-first release of WinTouch, a Windows-native touch.exe inspired by BSD touch.

WinTouch creates files and precisely controls Windows file timestamps from CMD, treating Created, Modified, and Accessed as first-class timestamp fields.

Features

  • Creates files when missing.

  • Updates existing file timestamps.

  • Defaults to updating Created, Modified, and Accessed.

  • Supports timestamp selectors:

    • -a / --accessed
    • -m / --modified
    • -c / --created

  • Supports grouped boolean flags:

    • -am
    • -ac
    • -mc
    • -amc
    • -np
    • -rm

  • Sets readable dates with -d / --date <DATE>.

  • Sets BSD compact timestamps with -t <TIMESTAMP>.

  • Synchronizes timestamps from another file with -s / --sync <FILE>.

  • Applies relative timestamp offsets with -e / --edit <OFFSET>.

  • Supports no-create mode with -n / --no-create.

  • Creates missing parent directories with -p / --parents.

  • Supports wildcard targets.

  • Supports files and directories.

  • Supports Unicode paths.

  • Supports long Windows paths.

  • Supports reparse controls:

    • -f / --follow-reparse
    • -i / --ignore-reparse

  • Supports UAC relaunch with -r / --runas.

Example commands

touch file.txt
touch -m -d "2026-05-28 21:30:00" file.txt
touch -amc -d "2026-05-28 21:30:00" file.txt
touch -s reference.txt target.txt
touch -e +0130 file.txt
touch -p logs\build\output.txt
touch -r -m -d "2027-06-29 22:31:01" protected.txt

Testing

Validated on Windows with the included CMD-only behavior test runner.

Covered behavior includes:

  • help aliases
  • version aliases
  • timestamp selectors
  • boolean clusters
  • separated value tokens
  • date parsing
  • BSD compact timestamp parsing
  • timestamp sync
  • positive, negative, and unsigned offsets
  • conflict rejection
  • wildcards
  • directories
  • Unicode paths
  • long paths
  • runas clustered form

License

WinTouch is released under the Zero-Clause BSD license (0BSD).

Provenance

WinTouch is a Windows-native implementation inspired by BSD touch behavior. FreeBSD source files are not redistributed in this repository; upstream reference links are provided in PROVENANCE.md.

Full Changelog: https://github.com/fluxnull/wintouch/commits/v0.3.0

Assets 3
Loading