Skip to content

kijimoshi1337/SwooshFile

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SwooshFile

Modern local network file sharing built for speed, simplicity, and every device you own.

SwooshFile is a polished self-hosted web application that lets you instantly share files and clipboard content between devices on the same network. Open it in a browser and start transferring — no accounts, no setup headaches, no cloud dependency.

Designed for desktop and optimized for mobile, SwooshFile now delivers a smooth commercial-style experience with drag & drop uploads, responsive mobile navigation, upload bundles, shared clipboard syncing, previews, and elegant UI animations.


Features

File Sharing

  • Drag & drop file uploads
  • Folder uploads support
  • Automatic ZIP bundle creation
  • Download and delete actions
  • File previews for images and PDFs
  • Duplicate-safe uploads
  • Fast local network transfers

Mobile Experience

  • Fully responsive mobile-first design
  • Sticky bottom navigation
  • Optimized touch interactions
  • Smooth scrolling and transitions
  • Native-app-like feel on phones and tablets

Shared Clipboard

  • Share text instantly between devices
  • Great for links, commands, notes, and snippets
  • Persistent shared clipboard section

Modern UI

  • Glassmorphism-inspired interface
  • Smooth animations and transitions
  • Commercial-grade polish
  • Lightweight and fast

Privacy & Simplicity

  • No registration
  • No cloud uploads
  • Works entirely on your local network
  • Self-hosted and fully under your control

Screenshots

TODO


Installation

1. Clone the repository

git clone https://github.com/kijimoshi1337/SwooshFile.git
cd SwooshFile

2. Create virtual environment

Windows

python -m venv venv
venv\Scripts\activate

macOS / Linux

python3 -m venv venv
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

4. Start the server

python app.py

5. Open SwooshFile

On the host device:

http://localhost:5050

To access from another device on the same network:

http://<your-local-ip>:5050

Example:

http://192.168.1.15:5050

Project Structure

SwooshFile/
├── app.py
├── requirements.txt
├── README.md
├── uploads/
├── templates/
│   └── index.html
├── static/
│   ├── styles.css
│   ├── animations.css
│   ├── script.js
│   └── images/
└── venv/

Supported Platforms

SwooshFile has been tested on:

  • Windows 10 & 11
  • macOS Sequoia
  • Ubuntu 22.04+
  • Android (Chrome, Firefox)
  • iPhone / iPad (Safari, Chrome)

Use Cases

  • Transfer files between PC and phone
  • Quickly send screenshots or documents
  • Share folders across devices
  • Temporary local network sharing
  • Copy/paste text between devices
  • AirDrop alternative for mixed ecosystems

Tech Stack

  • Python
  • Flask
  • HTML/CSS/JavaScript
  • APScheduler

Roadmap

Planned future improvements:

  • Upload progress bars
  • QR code quick connect
  • PWA install support
  • Dark mode
  • Multi-user support
  • LAN device discovery
  • Real-time upload updates
  • Drag-to-share links

License

MIT License


Support the Project ☕️

If you enjoy using SwooshFile and want to support development:

PayPal

Thank you for supporting the project ❤️

About

A lightning-fast local network file-sharing solution. Effortlessly share files across macOS, Windows, Linux, Android, and any device with a web browser. Just open SwooshFile on your network, drag and drop your files, and access them instantly from any platform. Simple, secure, and seamless

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors