README.md

FreyaFS - a Mix&Slice virtual filesystem

Prerequisites

• Install the openssl/crypto library. On Ubuntu you can do so as follows:

  sudo apt install libssl-dev

• Install the aesmix and fusepy python modules:

  pip install aesmix
  pip install fusepy
  pip install pynacl

If you want to compile it:

• Install the pyinstaller python module:

  pip install pyinstaller

• Bundle FreyaFS and all its dependencies into a single binary freyafs:

  pyinstaller main.py -n freyafs --noconsole --onefile

Usage

usage: main.py [-h] [-t] MOUNT DATA

Freya File System - a Mix&Slice virtual file system

positional arguments:
  MOUNT              mount point of FreyaFS
  DATA               folder containing your encrypted files

optional arguments:
  -h, --help         show this help message and exit
  -t, --multithread  run in multi-threaded mode

From source

You can get usage information with:

python3 main.py --help

From binary

After following the instruction to compile FreyaFS, you will find the freyafs executable under the dist directory.

You can get usage information with:

./dist/freyafs --help

Acknowlegments

This repository has been produced by Michele Beretta as part of his bachelor thesis.