https://github.com/dopevog/fileshare
💥 Share files easily over your local network from the terminal!
https://github.com/dopevog/fileshare
file-share file-sharing python terminal-based
Last synced: 23 days ago
JSON representation
💥 Share files easily over your local network from the terminal!
- Host: GitHub
- URL: https://github.com/dopevog/fileshare
- Owner: dopevog
- License: mit
- Created: 2021-06-18T11:44:58.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2021-06-19T14:55:25.000Z (almost 4 years ago)
- Last Synced: 2025-05-08T17:02:20.894Z (23 days ago)
- Topics: file-share, file-sharing, python, terminal-based
- Language: Python
- Homepage:
- Size: 43 KB
- Stars: 12
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Fileshare
📨 Share files easily over your local network from the terminal! 📨
## Installation
```bash
# clone the repo
$ git clone https://github.com/dopevog/fileshare.git
# change the working directory to fileshare
$ cd fileshare
# install the requirements
$ pip3 install -r requirements.txt
```
## Usage
```
usage: python fileshare [-h] [--debug] [--receive] [--port PORT]
[--ip_addr {192.168.0.105}] [--auth AUTH]
file_path
Transfer files over WiFi between your computer and your smartphone from the
terminal
positional arguments:
file_path path that you want to transfer or store the received
file.
optional arguments:
-h, --help show this help message and exit
--debug, -d show the encoded url.
--receive, -r enable upload mode, received file will be stored at
given path.
--port PORT, -p PORT use a custom port
--ip_addr {192.168.0.105} specify IP address
--auth AUTH add authentication, format: username:password
--no-force-download Allow browser to handle the file processing instead of
forcing it to download.
```
**Note:** Both devices needs to be connected to the same network
**Exiting:** To exit the program, just press ```CTRL+C```.
---
Transfer a single file
```bash
$ python fileshare.py /path/to/file.png
```
Transfer a full directory. **Note:** the directory gets zipped before being transferred
```bash
$ python fileshare.py /path/to/directory/
```
Receive/upload a file from your phone to your computer
```bash
$ python fileshare.py -r /path/to/receive/file/to/
```
## License
This Project Has Been [MIT Licensed](https://github.com/cgraphite/fileshare/blob/main/LICENSE)