Metadata-Version: 2.1
Name: paradise
Version: 0.2.0
Summary: A file sharing and media streaming utility for local network
Home-page: https://github.com/rahulsrma26/paradise
Author: Rahul Sharma
Author-email: rahulsrma26@gmail.com
Maintainer: rahulsrma26
Maintainer-email: welcometors@gmail.com
License: LICENSE
Project-URL: Code, https://github.com/rahulsrma26/paradise
Keywords: sharing streaming network setuptools development
Platform: any
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Communications :: File Sharing
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Multimedia
Requires-Python: >= 3.6
Description-Content-Type: text/markdown
Requires-Dist: fastapi
Requires-Dist: uvicorn
Requires-Dist: aiofiles
Requires-Dist: python-multipart

# Paradise

A file sharing and media streaming solution for local networks. Using this utility you can start a local server on your machine that is visible to other devices like mobile, laptop etc. Which can be used to download/upload files from other machines.

![preview](docs/img/preview.png)

## Why it's needed?

### Can't I just transfer files from/to External drive or internet.

This utility is useful for people that are using office/work laptop/device that usually disables USB ports and/or external disks. And you want to transfer locally, so that it will be faster as well as don't your internet data.

## Getting Started

These instructions will get you a server up and running on your local machine.

### Prerequisites

Requires: python 3.6+

### Installing

Paradise is available on [PyPi](https://pypi.org/project/paradise/) and can be easily installed using pip.

```
pip install paradise
```

If you already have paradise and want to update to a newer version

```
pip install -U paradise
```

You can get the cutting edge version directly from dev branch (this can be unstable)

```
pip install git+https://github.com/rahulsrma26/paradise
```

## Running

```
paradise
```

This will show the output and ip of your machine on local network

```
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO:     Started reloader process [14192] using statreload
INFO:     Started server process [1580]
INFO:     Waiting for application startup.
[Visit url] http://192.168.0.123:8000
INFO:     Application startup complete.
```

Web server can be reached using http://127.0.0.1:8000 on your browser on the same machine. But if you want to access the web server from other devices then you need to open `Visit url` in the browser. In this example it is `http://192.168.0.123:8000`.

## Built With

* [FastAPI](http://https://fastapi.tiangolo.com/) - Backend
* [Vue.js](https://vuejs.org/) - Client framework

## Authors

* **Rahul Sharma** - *Initial work* - [Rahul Sharma](https://github.com/rahulsrma26)

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details

## Acknowledgments

* Hat tip to anyone whose code was used
* Inspiration - [Testing & Packaging by Hynek Schlawack](https://hynek.me/articles/testing-packaging/)


