https://github.com/housebirdgames/date-time-cleaner

Date-Time Cleaner: A Node.js tool for Windows to reset or customize file and folder date/time metadata, with .gitignore support.
https://github.com/housebirdgames/date-time-cleaner

date-time file-metadata file-modification gitignore metadata-cleaning nodejs windows

Last synced: about 1 month ago
JSON representation

Date-Time Cleaner: A Node.js tool for Windows to reset or customize file and folder date/time metadata, with .gitignore support.

• Host: GitHub
• URL: https://github.com/housebirdgames/date-time-cleaner
• Owner: HousebirdGames
• Created: 2024-02-04T13:45:22.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-02-04T13:59:54.000Z (11 months ago)
• Last Synced: 2024-02-14T11:46:22.040Z (11 months ago)
• Topics: date-time, file-metadata, file-modification, gitignore, metadata-cleaning, nodejs, windows
• Language: JavaScript
• Homepage:
• Size: 14.9 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Date-Time Cleaner

Date-Time Cleaner is a Node.js application for Windows that allows you to set the creation and last modified dates/times of the folder it is in, all subfolders, and all contained items. By default, it sets the date/time to "01/01/1970 00:00:00", but you can specify a different date/time when you run the application. It excludes everything specified in the `.gitignore` file, if one is available within that folder.

## Use Cases

Date-Time Cleaner can be useful in several scenarios:

1. **Privacy**: If you want to share files but don't want the metadata to reveal when the files were created or last modified, you can use Date-Time Cleaner to reset these dates/times.

2. **Testing**: If you're testing software that depends on the creation or modification dates/times of files, you can use Date-Time Cleaner to set these dates/times to a known value.

3. **Cleanup**: If you have old files with incorrect dates/times, you can use Date-Time Cleaner to reset them.

Remember to always back up your files before running Date-Time Cleaner, as it will permanently modify the metadata of your files. 

> **Use the cleaner at your own risk.**

## Pre-compiled Executable

A pre-compiled executable for Windows x64 is available in the `/dist` directory. You can download and run this executable without needing to install Node.js or any dependencies.

## Initialization

Before running the application, you need to install the necessary dependencies. Run the following command in your terminal:

```bash

npm install

```

## Running the Application

To run the application, use the following command:

```bash

npm start

```

This command will start the application in your terminal. The application will ask for your confirmation before it starts modifying the metadata of your files.

## Packaging the Application

To package the application into an executable file, use the `pkg` tool with the following command:

```bash

pkg . --targets node14-win-x64 -o ./dist/Date-Time-Cleaner

```

This command will package the application and output the executable file to the `./dist` directory. The packaged application can be run on any Windows machine with x64 architecture, without needing to install Node.js or any dependencies.

## Note

Please use this tool responsibly. Modifying the metadata of your files can have unintended consequences. Always make sure to back up your files before running this application.