Skip to main content

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

  1. Create a filesystem on a removable drive that matches the source and target computers.
  2. Optional, but highly recommended: encrypt your removable drive.
  3. Store the configuration in a file named sneakersync.cfg on the root of the drive.
  4. To send data, run sneakersync send <PATH_TO_YOUR_DRIVE>.
  5. Move your drive to the other computer and plug it in.
  6. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sneakersync-1.2.2.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

sneakersync-1.2.2-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

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

Hashes for sneakersync-1.2.2.tar.gz
Algorithm Hash digest
SHA256 956d071ece5418751b62c8a98129b5502fc95d0c448ddf9912bc88b9a2c6659d
MD5 753d713f3904bde6f19f8f747c8d1173
BLAKE2b-256 2ade38edc193d8f42bbc063a1622744d382c61df23563f1db49796f5f35a5986

See more details on using hashes here.

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

Hashes for sneakersync-1.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b1c70adcc794802f17899adc65b5c7b656f1455bb3ecee22f83756af7be2c113
MD5 0ec28c0e81726c69534ebd106677343c
BLAKE2b-256 96e744ceedb60d45df124dd5167f8848699968da4020b78059f147de9d4cd59d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page