Synchronize files through the sneakernet
Project description
# Sneakersync
Synchronize files through the [sneakernet](<https://en.wikipedia.org/wiki/Sneakernet>), i.e. using a removable drive.
Requirements:
[rsync](<https://rsync.samba.org/>). 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](<https://en.wikipedia.org/wiki/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: `` yaml 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: `` yaml 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: `` yaml 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](<https://en.wikipedia.org/wiki/Disk_encryption>) your removable drive.
Store the [configuration](#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>.
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 Distributions
Hashes for sneakersync-1.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7c1e02cc4f28f4c95a93722318a646d57d53fa487c5806c3779b9e315c4430fc |
|
MD5 | 3d9918dad38418c34008728dd1e3f7c6 |
|
BLAKE2b-256 | 1c9131eaa39d99cdb18f5321fa754185fbf494601cc6b9764aa9528dacc124d5 |
Hashes for sneakersync-1.1.1-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b63829481ca928ddaa48983e3ce21db7ea0263cdaf582135917c1dcd5e59dd5a |
|
MD5 | ad2bbdae29e20ded887115dbf2263e7f |
|
BLAKE2b-256 | cd8f7f077fed4000d83d4a8c5b6a7c117856bcc87087938deab65088c39eeb82 |