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
File details
Details for the file sneakersync-1.2.2.tar.gz
.
File metadata
- Download URL: sneakersync-1.2.2.tar.gz
- Upload date:
- Size: 5.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
956d071ece5418751b62c8a98129b5502fc95d0c448ddf9912bc88b9a2c6659d
|
|
MD5 |
753d713f3904bde6f19f8f747c8d1173
|
|
BLAKE2b-256 |
2ade38edc193d8f42bbc063a1622744d382c61df23563f1db49796f5f35a5986
|
File details
Details for the file sneakersync-1.2.2-py3-none-any.whl
.
File metadata
- Download URL: sneakersync-1.2.2-py3-none-any.whl
- Upload date:
- Size: 7.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
b1c70adcc794802f17899adc65b5c7b656f1455bb3ecee22f83756af7be2c113
|
|
MD5 |
0ec28c0e81726c69534ebd106677343c
|
|
BLAKE2b-256 |
96e744ceedb60d45df124dd5167f8848699968da4020b78059f147de9d4cd59d
|