FILE ENCODER

This repository allows you to encode files using a password.

Install

First clone the repository
Then run the following command to install necessary packages.

pip3 install cryptography

Once it is done, you first need to generate a salt. To do that, run the following command in the folder fileEncoder :

python3 createSalt.py

You will need to edit the top of encoder.py file by replacing this line :

saltFileName = "/Volumes/SALT/.encoderFileSalt"

by :

saltFileName = "/PATH/TO/YOUR/.encoderFileSalt"

For more safety, you can move the file .encoderFileSalt to an external flash drive. Then you will need to plug in this external flash drive each time you need to encode/decode a file and replace the path accordingly (same step as above).

Then, to use it easily with the terminal, copy this in your .bashrc or .zshrc file. You need to write the path to this project in "PATH/TO/PROJECT".

# file encoder shortcut
encode(){
	if [ -z "$1" ]; then 
		echo "invalid argument"
	else
		python3 PATH/TO/PROJECT/encoder.py encode "$1"
	fi
}

decode(){
	if [ -z "$1" ]; then 
		echo "invalid argument"
	else 
		python3 PATH/TO/PROJECT/encoder.py decode "$1"
	fi
}

How to use it

To encode a file run this command in a terminal:

encode PATH/TO/file

To decode a file run this command in a terminal:

decode PATH/TO/file

Be careful : once you have encoded a file, if you lose the password or if you delete the file .encoderFileSalt you won't be able to recover it

caillouc/fileEncoder

FILE ENCODER

Install

How to use it