Skip to main content

Locking files/folders [FF] in GNU/Linux via text-based user interface (TUI).

Project description

FFLocker

Locking files/folders [FF] in GNU/Linux via text-based user interface (TUI).

The most important part of the algorithm is that during the locking process, your password is never saved on the computer and only displayed in the terminal for you to save it.

Description

FFLocker uses AES encryption. You can either create a password with 16, 24, and 32 characters (which corresponds to 128, 192, and 256 bits, respectively) or generate a random password with the help of the secrets.choice.

After you lock the file/folder, the program will change the binary data and overwrite it. To read/open the encrypted file/folder, you have to enter the password.

I have written the program in such a way that when you decrypt the file/folder, a new file/folder will be created as a precaution against entering the wrong password. At the end of the decryption process, you can permanently delete the encrypted file/folder via a single command (see the WARNING subsection).

Additionally, every file and folder receives .enc and ENC extensions at the end of the encryption process. If your pathname does not contain these extensions, the decryption process does not begin. Similarly, you cannot encrypt the file/folder if it has a .enc or ENC extension.

WARNING

Even if your password is wrong, the program will decrypt the file/folder and produce a result if it has a sufficient number of characters (bytes). In this case, be careful about deleting the encrypted file/folder since the decrypted one will be unreadable due to the wrong password. As for advice, always open and read the decrypted file/folder before you delete the encrypted one.

Installation

You can install the FFLocker via pip

python3 -m pip install fflocker

or by directly cloning to your desired directory

git clone https://github.com/camarman/FFLocker.git

Requirements

FFLocker requires pycryptodome, which can be installed by running

python3 -m pip install pycryptodome

User Guide

To start the file locking process run

python3 -m fflocker.file_locker

Similarly, to start the folder locking process run

python3 -m fflocker.folder_locker

from the terminal.

Overview

Encryption process of a file Decryption process of a file
enc_file dec_file
Encryption process of a folder Decryption process of a folder
enc_folder dec_folder

Upcoming Features

I am thinking to implement a command line interface (CLI), and it will probably look like this:

$ fflocker -Fe [path]
$ fflocker -De [path]
$ fflocker -Fd [path]
$ fflocker -Dd [path]

-F --File
-D --Directory
-e --encrypt
-d --decrypt

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

fflocker-1.3.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

fflocker-1.3-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

Details for the file fflocker-1.3.tar.gz.

File metadata

  • Download URL: fflocker-1.3.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.3

File hashes

Hashes for fflocker-1.3.tar.gz
Algorithm Hash digest
SHA256 32597ec9342d071e929e494b7df7a1bcf378016508ebcc8619639da6c116cb51
MD5 79a0b7abf575fb8f1e48e6e6b4ba1ea0
BLAKE2b-256 2619dd1e678763a66168551ace60d8503b57256bcbb7cd31f918117c7eefe493

See more details on using hashes here.

File details

Details for the file fflocker-1.3-py3-none-any.whl.

File metadata

  • Download URL: fflocker-1.3-py3-none-any.whl
  • Upload date:
  • Size: 7.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.3

File hashes

Hashes for fflocker-1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 6b42bcbd08f7a6992c64a494cbc907d06c4f6a4e4c0f6e0b62c54b7f075d43e9
MD5 e5101e06ef48064a087dd5238bd2009a
BLAKE2b-256 0a243de8c06b9ed55c5d08ac58bb3a1a9e962f9de2aa859ab446f2b9e3e06517

See more details on using hashes here.

Supported by

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