BackDrop

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #claude-code #cli #windows #codex #developer-tools #dsh

★ 67 Open GitHub ↗

A cold storage backup tool for drives, folders, and network shares

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

At it's core, BackDrop is a tool to copy data from one place to another for backup.

Online storage of data can get expensive. Obviously, the cheap way to back up important data is to load copies of it onto spare drives, and cart them to a friend's house. If you're like me, not all of the data you want to back up will always fit on one drive, and I wanted a way to automate the backup without having to manually figure out the best way to split directories.

BackDrop can copy from multiple sources, and will automatically split them among one or more destinations.

![BackDrop UI](https://raw.githubusercontent.com/TechGeek01/BackDrop/master/docs/img/showcase.png)

## Installation
If you're not running a pre-compiled version of the source code, you can run the Python directly. All packages can be installed by passing the associated requirements.txt file to `pip`.

## Usage
For both source and destination, you can select whole drives, or arbitrary paths (your desktop for the source, or a subfolder on an external drive for the destination, for example), and more than one can be selected.

BackDrop will automatically check the free space on destinations, and the size of sources, and make sure that you have enough room for everything you selected. When you run a backup, the config is saved to each destination, so when you open the destination in BackDrop later, it'll select everything for you so you don't have to remember what you were backing up. The backup itself is in two parts.

### Portable Mode
By default, BackDrop stores the config inside of the user's AppData folder. If you want to run in portable mode, you can create a `backdrop.ini` file in the same directory as the executable (or Python) file, and it will use that instead. A sample file can be found in the repo, named `backdrop-example.ini`

### Analysis
First, the analysis scans the directory structure of the folders and drives you have. It will try and pack as efficiently as possible, avoiding splitting folders if they don't have to be split. If a folder has to be split, it will try and arrange it so that it most efficiently fills up one destination, and split as least as possible.

Once this splitting is done, BackDrop will take a look at the existing file structure to determine a list of exactly what needs to be deleted, updated, or copied, and their file size. This means that while the initial backup may take some time due to having to copy everything, subsequent backups will take much less time to complete.

### Backup
Once the analysis is done, and BackDrop knows what files go where, you can actually run the backup. This will iterate through the list of files, and give you live output of what's happening. While copying your files, BackDrop also does a second verification pass to make sure the data copied over successfully.

Should you need to stop in the middle of a copy for any reason, you can abort the backup. Any active copy or delete operations are killed, and the rest of the backup is aborted. If the current operation was verifying a copied file, the verification will complete before killing the rest of the backup.

## Features
* **Automatic source drive selection:** Once you set the drive letter for the source, BackDrop will remember it, and will automatically use that drive letter each time you run the tool later.
* **Multi-source:** With options for both single or multi source, you can back up specific folders on one drive, or name and backup several drives if your sources are in multiple locations.
* **Network and local drives:** Both the source and destination can use either a mounted network share, or a local drive.
* **Split share mode:** If you can't connect all of the drives at once when updating an existing config, there's an option for split mode. With split mode enabled, the backup will be analyzed and processed as though all drives are connected, but commands to drives that are disconnected will be skipped.
* **Drive split mode warnings:** If a config is loaded from a drive, and not all drives are connected, it will automatically warn you, and only let you continue with analysis if you connect the missing drives, or enable split mode.
* **Backup config memory:** Config files about your backups are stored on each drive. This means that when you select a drive you've previously used for backup, BackDrop will automatically select the other drives in the config, and the shares you had selected, so that you can update the backup that's already on the drive.
* **Command line:** There's a built-in command line mode that's able to take parameters to configure and run a backup. This makes it possible to script and automate backups with BackDrop.
* **Portability:** The best part about it is that there is no installation, and it's all a single executable! This means you can take it with you if you want, or run it on multiple computers. And because there's no installation, when you're not using it, BackDrop is completely out of the way.

BackDrop

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README