Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A simple file system that encrypts files individually.

Project Description

A simple file system that encrypts each file individually. Designed for use with cloud storage.


Quick high-level overview:

  1. You have some files abc, 123, asdf.
  2. You make an encryptFS in a directory and add all three files. You end up with an encrypted index file and three files with randomly generated names (e.g. e4e90f66761a0ddf52ec47e3d9f1851e3e2304b2b9abd6ae0f818cafa26d56a0).
  3. Later, you can open the existing encryptFS and decrypt your files back.


  • What do you use for the actual encryption? PyCrypto, AES-256 (32-byte key)
  • Why are the files encrypted separately instead of being put together in blocks? Isn’t this a flaw in the security? For now, I’m willing to trade off the security to simplify the code and to allow for easier/quicker decryption of specific individual files.
  • Does this keep my original file metadata? For now, no.


This project is very new and this API is very subject to change.

Set up

git clone
cd encryptFS
pip install -r requirements.txt

Example script

from encryptfs import EncryptFS

# Replace `asdfasdf` with a password
encfs = EncryptFS('asdfasdf')

# This will encrypt all new files in the current directory

# This will decrypt all encrypted files in the index

Have questions or suggestions? Open an issue.


CLI requires the click package.

python <action> <password>
Release History

Release History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
encryptfs-0.0.1.tar.gz (4.3 kB) Copy SHA256 Checksum SHA256 Source Jan 15, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting