Skip to main content

Syncrypt client

Project description

# Syncrypt client

[![Build status](https://travis-ci.org/syncrypt/client.svg?branch=master)](https://travis-ci.org/syncrypt/client) [![Build status](https://ci.appveyor.com/api/projects/status/9jjn4gadwlc802c7?svg=true)](https://ci.appveyor.com/project/Syncrypt/client) [![PyPI version](https://img.shields.io/pypi/v/syncrypt.svg)](https://pypi.python.org/pypi/syncrypt) [![PyPI status](https://img.shields.io/pypi/status/syncrypt.svg)](https://pypi.python.org/pypi/syncrypt)

Syncrypt is a fully encrypted file storage service for groups and private backups. This is the client that you can use to store and retrieve files. The client will also do all encryption.

The source code for this client is released under the GNU General Public License Version 3. For more information have a look at the LICENSE file in this directory. Additional information on the GNU GPLv3 can be found here: http://www.gnu.org/licenses/quick-guide-gplv3.html

## Installation

Option 1: Install from PyPI (requires Python 3.6+)

pip install syncrypt

This requires the snappy-c library in order to build the [python-snappy](https://github.com/andrix/python-snappy) dependency. In Ubuntu, you can install it with the APT package libsnappy-dev. In OS X, you can install it with `brew install snappy`.

Option 2: Download one of the packages on our [releases page](https://alpha.syncrypt.space/releases/).

Option 3: Install latest development version from source:

pip install git+https://github.com/syncrypt/client

## Let’s get started

The syncrypt executable is the command line interface for Syncrypt. You can login to syncrypt so that you won’t have to enter your login for every command you issue.

syncrypt login

This will ask for the email and the password of your Syncrypt account. If you do not have an account yet, please [sign up](https://syncrypt.space/) for our closed alpha mailing list and we will send you an invite.

You can now initialize an arbitary directory as a vault. Simply change into this directory using cd and call:

syncrypt init

After you’ve set up the directory, you can push all of its contents by typing:

syncrypt push

For an extensive description of syncrypt commands, please see the [client manual](docs/manual.md).

## Further Information

  • [Syncrypt Alpha Signup](https://syncrypt.space/)

  • [Syncrypt Encryption](docs/encryption.md)

  • [Syncrypt CLI Manual](docs/manual.md)

  • [Syncrypt Daemon](docs/daemon.md)

  • [A guide through the Syncrypt client source code](docs/source_guide.md)

## Tests

Install test requirements:

bin/pip install -e ‘.[test]’

Run all tests:

bin/py.test

Currently there is no public syncrypt instance that you can run your test against, so you can limit the tests to those not requiring a test server instance:

bin/py.test -m ‘not requires_server’

## Develop

Setup in virtualenv for development:

virtualenv . bin/pip install -e ‘.[dev]’

## Deploy

Make Syncrypt distribution package for the current platform:

bin/pip install -e ‘.[dist]’ bin/python setup.py dist

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

syncrypt-0.6.0.tar.gz (84.3 kB view details)

Uploaded Source

File details

Details for the file syncrypt-0.6.0.tar.gz.

File metadata

  • Download URL: syncrypt-0.6.0.tar.gz
  • Upload date:
  • Size: 84.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.1 CPython/3.6.7

File hashes

Hashes for syncrypt-0.6.0.tar.gz
Algorithm Hash digest
SHA256 22b9344c8610310f2937b5f0a43d49dc2914dcb1999d255ce5296b84c3ac4f54
MD5 5ca77bb16ca6df20bcd822541e47eaa7
BLAKE2b-256 79622e21c65511f53326370c29e2ac3755a855bc6aeb26136e4c1286138e70f2

See more details on using hashes here.

Supported by

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