Metadata-Version: 2.1
Name: dropit
Version: 0.1.10
Summary: A Flask-based command line file sharing application.
Home-page: https://github.com/1darshanpatil/dropit
Author: Darshan P.
Author-email: drshnp@outlook.com
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Flask
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Flask==3.0.3
Requires-Dist: Flask-BasicAuth==0.2.0
Requires-Dist: qrcode==7.4.2
Requires-Dist: click<8.2.0,>=8.0.0
Requires-Dist: Werkzeug==3.1.3
Requires-Dist: Jinja2==3.1.6
Requires-Dist: MarkupSafe==3.0.2
Requires-Dist: itsdangerous==2.2.0
Requires-Dist: typing_extensions==4.14.1
Requires-Dist: blinker==1.9.0
Requires-Dist: cryptography==45.0.5
Requires-Dist: cffi==1.17.1
Requires-Dist: pycparser==2.22
Requires-Dist: pypng==0.20220715.0

# Dropit - Simple Cross-Platform File Sharing
![image](https://github.com/user-attachments/assets/0a711081-d9c2-4a95-9674-7239b76bcded)
![image](https://github.com/user-attachments/assets/2e3cd01d-7cdc-4e62-be6a-5159c1cc3b9a)

Below image for legacy <= v0.1.5 ( 0.1.6 is a bug should be skipped)
![image](https://github.com/user-attachments/assets/a360f9b0-dac3-45dc-9678-0960a658588c)


## Introduction
Dropit simplifies the process of sharing files across multiple devices, including laptops and mobile phones, regardless of their operating system. Whether you're a developer working with multiple OS environments, or simply need to transfer files between devices, Dropit offers a straightforward solution.

## Key Features
- **Cross-Platform Compatibility**: Share files seamlessly between any devices on the same network.
- **Easy to Use**: Just a single command is needed to start sharing files.
- **Optional Password Protection**: Enhance security with an optional password.

## How to Use
To share files with Dropit, simply run the following command in your terminal:

```bash
dropit [--password <password>] [--geturl] [--getqr] [--maxsize <integer>]
```

*Options*
```
--password: <password>: Secures your file sharing session with basic authentication.
--geturl: Prints the URL to access Dropit from the other devices.
--getqr: Displays a QR code in the terminal, which can be scanned to connect to Dropit.
--maxsize <size_in_GB>: Sets a maximum file size for uploads (default is 2GB).
```
**NOTE**: The default username is `admin`

*Accessing Dropit:*

Open a web browser on any device connected to the same network and enter the URL displayed in the terminal. If a password is set, you will be prompted to enter it. 




### Additional Sections

#### Configuration Options
Detail other configuration settings if available, such as changing the default upload folder.


## Troubleshooting

- **Connection Issues**: Ensure all devices are on the same network. Check firewall settings if devices cannot connect to the server.
- **Performance Issues**: For large file transfers, ensure the server machine has sufficient resources. Consider increasing the system limits if uploads fail due to file size.
- **Mobile Device Compatibility**: Some mobile devices might experience difficulties accessing `http` URLs.



## Contributing

Contributions are welcome! If you have improvements or bug fixes, please open a pull request. For major changes, please open an issue first to discuss what you would like to change.
Please ensure to update tests as appropriate.
