LANdToss

Transfer files instantly between your devices without uploading to the cloud, waiting for sync, or exposing your data to external services.

Quick Start

1. Navigate to your folder and clone repo:

git clone https://github.com/oh-nought/LANdToss
cd landtoss

2. Set up virtual environment:

python -m venv .venv
source .venv/bin/activate # or .venv\Scripts\activate for Windows

3. Install dependencies:

pip install -r requirements.txt

4. Create an .env file and paste the following into it:

HOST=0.0.0.0
PORT=8000

5. Navigate to the server folder:

cd server

6. Run the program:

python server.py

How to use LANdToss

After running the program, you will be prompted with something like this:

LANdToss Server


    Visit: http://[your host]:[your port] to connect
          
        
INFO:     Started server process [94048]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
...

Upon connecting to the page, users will be given a unique name and id.

To send a file:

1. Select files - drag and drop or click to browse
2. Choose recipient - click on an online user from the list
3. Click "Toss" - send a transfer request
4. Wait for acceptance - the recipient will see a popup to accept or decline your request
5. Transfer begins - files stream in real time upon acceptance

To recieve a file:

1. Keep browser open - your device will appear as "online" to other users
2. Accept incoming requests - you can review file details before accepting
3. Automatic download - files will download immediately upon transfer completion