2024-08-10

DirectoryPulse - Keyliner Backup Software

DirectoryPulse - keyliner Backup Software

keyliner has written a free Windows backup program.
-2024.08 - Version 2.00 - Updated with new features

Backup large swaths of directories to a separate backup drive.  Files can be saved in dated folders, as compressed files, or as generational backups (multiple versions of files).  Jobs can be saved and re-loaded, and scheduled for automatic runs. 

Backup are non-proprietary and fast!

Write to local drives, SAN drives, and cloud drives, organized by project, by date, etc.

(Click for larger view)

Features:

* Backup to a local disk, SAN, One-drive, GDrive, etc.
* Non-proprietary backup - straight-forward file-copies

* Backup to optional dated-folders (YYYY-MMDD)
* Supports Generational backups
   (multiple versions of same file, V1, V2, etc.)

* Optional ZIP backups
   (reduce upload times to OneDrive)

* Can skip non-changed files
   Automatically skip cache folders, temp files, and hibernation files
   Automatically skips Windows System Files
   Skips One-drive virtual file links (saving re-downloading)

* Manages its own backup inventory, erasing old backups
* Configurations can be saved for easy retrieve and re-run
* Automate and schedule with Windows Scheduler
* Occupies zero RAM or resources when not in use; no background tasks

* Includes a nifty Directory Report that displays a sortable report, showing file-sizes and counts in a way that file explorer does not.  Use this to find your biggest disk hogs.

DirectoryPulse was originally written as a Student and Instructor exercise in Volume 6 of the Computer Programming Book, War and Peace Programming in C#  -- Amazon Kindle, written and published by keyliner.  It grew into this program.

Try it:

See below for download and installation instructions.

1.  Launch program, "DirectoryPulse.exe" from the Start Menu tile or by double-clicking the .exe.

The program was written with C#, .DotNet 8.0. When first launched, you may be prompted to install Microsoft's .DotNet 8.0 libraries.

2.  On first-launch, you are prompted for default backup destinations.  These are one-time settings. 

Most users setup these destinations:

D:\drive (local secondary drive, or USB disk)
SAN  (local network disk, or assign to a USB disk)
Cloud  (Onedrive or GDrive backup folder)

For each destination, type or browse to a top-level "backup" folder name -- such as "Backups"; all backups, of any type, will live in this folder.  (Optionally, browse to each destination.  Use the word "none" to disable the SAN or CLOUD destinations.) 

Click for larger view

Save the changes and return to the main panel. 
The program builds the top-level destination directory automatically when you close the panel. 

3.  On the main panel, select which directories to backup.    

In the top-most field, type the path, browse, or use File Explorer to drag-n-drop a folder onto the target. 
(DirectoryPulse! only cares about folder-backups; you cannot select an individual file.)

Optionally, right-mouse-click the field and choose "Add User Profile Documents".
+Multiple folders can be stacked into the backup job.

When done adding folders,

4.  Click Button "Refresh DOS Directory List"

This inventories the folders and shows a nifty report, showing all directories and subdirectories, with file counts and sizes. Sort by column-headings; right-mouse-click for a context menu.  This list is used by the backup.

5.  Session Settings: 

Set a backup destination and other preferences by clicking the Gear icon:

Click the "Gear" icon (-- this job's configuration settings)
Name this configuration file (e.g. "MyFavoriteBackup" or "Local-DataFolder")
Type a short description
Choose the type of backup ("Dated Folder [1-10]" - recommended)


Click for larger view

Set a pre-named sub-folder (which helps to build-out a destination-path).  Subfolders, such as "Projects", "Monthly", "Adhoc" are offered.

Once the subfolder is selected, a suggested backup destination path is constructed.  This is a recommended value, but can be changed manually to any other path (destination).  Destination folders are built automatically when the backup starts. 

The default subfolder names and other paths are adjustable.  See "System Defaults", this panel.

See the next article for Detailed Switch documentation.


6.  "Save" these preferences or click "Apply" to only use for this session.

7.  From the main screen, click bottom-row button "Backup"

The backup runs.  The backup re-creates the source-path (backup folders) in the destination path, creating each directory, one-for-one.  For example, if backing-up C:\data\subfolder1, the backup destination might be D:\Backups\adhoc\data\subfolder1.

When done, a report displays, along with a log file.

You are done!

If the backup type is "Dated Folder [1-10]", the backup destination has a subfolder: 
For example:  D:\Backups\Adhoc\2024.0804.  In this folder is a duplicate of the source drive's directory structure, with all eligible files.

Each time this configuration is run, it creates a new folder, keeping 10 generations of backups.  On the 11th backup (the 11th date), the oldest date is automatically deleted -- a self-cleaning backup.


Details and additional program documentation can be found here:
Detailed Switch documentation

Installation Steps:

DirectoryPulse is free to download and use for personal and commercial use. 
No registration, no login, no email. No advertisements, no nags, no spying.
Keyliner does not (and cannot) track who downloads or runs this program.

Installation is easy:
Download the .exe (.zip) and copy its supporting files into any folder on your hard disk.
Double-click the .exe to run - no installation required. 

Using the .exe from a download folder, or copying to a (my Documents) folder is a quick workaround for various Windows security concerns.  Some vendors recommend this, but these folders are inappropriate for executable software.  Instead, the program should be copied to Program Files so it gains the protection of other Windows security features. Total time: about a minute.


Follow these steps for a more professional installation:

A.  Download the .exe and support files (as a .zip) to a Download or Temp folder:

From Keyliner's public GDrive, click this link and download to a local temp or download directory.  

Version 2.02 Download Link
https://drive.google.com/file/d/1G-1eMXWpVW8UF5XFat8yk4oib2gZr-3A/view?usp=drive_link




When downloading, different browsers behave differently.
Select "Save-As"

Windows security will not let you download directly into Program Files -- you must save to a temp directory (technically, you will not be able to remove the "mark of the web" if downloaded directly into Program Files).

Since keyliner cannot afford a signing certificate, you will be prompted that the file is not safe (being downloaded from the internet).  Click "more information" and allow the program to download/run.

Zip File Hashes:
MD5: b3-83-aa-49-54-2e-5b-23-a6-6e-07-25-61-2a-1f-d1
SHA256: 7cf33b0aa486c6979cdb1825163fae12a682cf00882183e456787fddeeaf5f22

B.  Mark the download as safe-to-run:

Using File Explorer,

Right-mouse-click the downloaded DirectoryPulse.zip
Select "Properties"
Check [x] Unblock.  (This removes the "mark of the web.")

                 Click for larger view


* Only do this if you trust keyliner *and* only if downloaded from keyliner's public GDrive. 

If "Unblock" is not visible, it has already been unlocked (by Microsoft Edge).
Once [x] Unblocked is clicked, this security menu disappears.

C.  Create a Program folder to hold the program:

Using File Explorer, open folder C:\Program Files,
Create a new utility folder:  C:\Program Files\Util


D.  Copy the .exe and two support files to ProgramFiles\Util:

Using File Explorer,
Double-click to open the .zip folder

Copy/paste three files from the zip,
Paste to C:\Program Files\Util

DirectoryPulse.exe
DirectoryPulse.dll
DirectoryPulse.runtimeconfig.json

Do this copy as a two-step, copying from the temp/download folder, then into Program Files.  


E.  Create a Start Menu Tile:

Using File Explorer,
Tunnel to C:\Program Files\Util
Right-mouse-click the DirectoryPulse.exe and "Pin to Start"
The program is ready to run.  See icon on Start Menu.

On first-time launch, you are prompted for default backup destinations -- this is where you choose where you want the backups to write to.  See details earlier in this article, with additional program documentation here: Detailed Switch documentation



Version history:

2.02 - 2024.1005  Still had problems with high-resolution laptop screens; believe now fixed
2.01 - 2024.0923  Fixed display problem on laptops with high-resolution screens (140%)
2.00 - 2024.0810  Numerous design changes. 
          Improved Configuration selection and prompts
          Simplified Backup-type and option settings
          Added subfolder-cosmetic tagging
          Added drag-n-drop support
          Added eyecandy to help guide decisions
          Improved backend INI file settings

Note: Version 1.x INI config files not compatible with this version; sorry.  You will have to rebuild the config files.

1.05 - 2023.0430 Moved the Config/INI lookup button to top of panel
          Added cosmetic "Destination:" during the backup
          Added a "Delete" button (in addition to the Context menu) for INI Delete
1.04 - Fixed bug where sometimes root drive not inventorying: "Unexpected error in DOS directory"
1.03 - Minor changes to the report Log file, making it easier to find skipped directories
1.02 - Not released
1.01   2021.0610 Initial Release

Thank you to my Beta-testers: DLW, of Boise.