Synchronize files through the sneakernet
Project description
Sneakersync
Synchronize files through the sneakernet, i.e. using a removable drive.
Requirements:
- rsync. The version must support extended attributes (
-X
flag). - A removable drive with a filesystem matching the source and target computers.
- Feet or a compatible mean of transportation of the removable drive between computers.
Installation
Simply run pip install sneakersync
.
Configuration
The configuration is a YAML-formatted file that contains modules (directories to be synchronized) and filters (rules that exclude or include files or directories). Each module must contain a root entry (the top-level path to be synchronized) and may contain filters; if no filter is specified, all files and directories below the root of the module are included. Filters are defined by a list of include or exclude directives.
A minimal example which synchronizes the home folder of a user would look like:
modules:
- root: /home/john.doe
To exclude a directory (and its content) and files with a given extension from a module, add a filters directive:
modules:
- root: /home/john.doe
filters:
- exclude: /home/john.doe/.firefox/caches
- exclude: *.pyc
To filter entries from all modules, use the top-level filters directive:
modules:
- root: /home/john.doe
- root: /home/jane.blogs
filters:
- exclude: .firefox/caches
Filters defined at the top-level will have priority over module-level filters.
Usage
- Create a filesystem on a removable drive that matches the source and target computers.
- Optional, but highly recommended: encrypt your removable drive.
- Store the configuration in a file named
sneakersync.cfg
on the root of the drive. - To send data, run
sneakersync send <PATH_TO_YOUR_DRIVE>
. - Move your drive to the other computer and plug it in.
- To receive data, run
sneakersync receive <PATH_TO_YOUR_DRIVE>
.
Known limitations:
- The last access time (
atime
) is not preserved: rsync needs to access files in order to transfer them. - The creation / meta-data change time (
ctime
) is not preserved: this attribute is not user-modifiable.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sneakersync-1.2.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b1c70adcc794802f17899adc65b5c7b656f1455bb3ecee22f83756af7be2c113 |
|
MD5 | 0ec28c0e81726c69534ebd106677343c |
|
BLAKE2b-256 | 96e744ceedb60d45df124dd5167f8848699968da4020b78059f147de9d4cd59d |