A P2P file transfer tool using Django Channels.
Written in Python/Django

Overview

FileShare is a Django-based tool for securely transferring files between devices, similar to ShareDrop. It allows users to send and receive files directly over the network with built-in encryption for enhanced privacy.

How It Works

Your data is protected using AES 256-bit encryption, making the file transfer process secure and reliable.

Sender Process

1. The file is first byte-encoded (client-side).
2. The encoded file is then encrypted using AES 256-bit encryption (server-side).
3. The encrypted file is transferred to the recipient (still encrypted).

Receiver Process

1. The received file is decrypted using the same encryption key (server-side).
2. The decrypted data is byte-decoded (client-side).
3. The original file is reconstructed and made available for download.

This way only the intended recipient can access the file throughout the transfer.

Purpose

The primary goal of this project is to provide an open-source application that anyone can use and learn from.

If you find this project interesting, helpful, or inspiring, please consider giving a star, following, or even donating.

Setup for Local Development

Install uv

cd path/to/root/directory
pip install uv

Create Enviroment Variable file

touch .env
nano .env

Add the following (adjust as needed):

SECRET_KEY="example_secret_key"  # https://stackoverflow.com/a/57678930
ENCRYPTION_KEY="example_encryption_key"  # https://cryptography.io/en/latest/fernet/#cryptography.fernet.Fernet
DEBUG=True  # For development

Save changes and close the file.

Migrate Database (Optional)

uv run manage.py migrate

Run Django Server

uv run manage.py runserver

Access web application at http://127.0.0.1:8000/ or http://localhost:8000/. Open two browser windows to transfer files between users.

Run Tests

uv run manage.py test

Demo Image

Demo Videos

User 1

user1.mp4

User 2

user2.mp4

Contributing Guidelines

Pull Requests

• Simplicity: Keep changes focused and easy to review.
• Libraries: Avoid adding non-standard libraries unless discussed via an issue.
• Testing: Ensure code runs error-free, passes all tests, and meets coding standards.

Bug Reports

• Report bugs via GitHub Issues.
• Submit pull requests via GitHub Pull Requests.

Thank you for supporting FileShare!