Metadata-Version: 2.5
Name: pdrive
Version: 0.9.0
Summary: A simple web-based document and file manager
Project-URL: Homepage, https://github.com/huyng/pdrive
Project-URL: Repository, https://github.com/huyng/pdrive
Project-URL: Issues, https://github.com/huyng/pdrive/issues
Author-email: Huy Nguyen <121183+huyng@users.noreply.github.com>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
Keywords: file-browser,file-manager,flask,react,web
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Flask
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: System :: Filesystems
Requires-Python: >=3.9
Requires-Dist: flask
Requires-Dist: gunicorn
Description-Content-Type: text/markdown

# pdrive

pdrive is a browser-based document and file manager based on Python 3 and React. If you need a quick way of browsing files on a remote server, this is the tool for you.

You can use it as a pretty alternative to `python -m http.server` or as a simple interface into a remote network-attached-storage drive.

It's designed to combine the excellent usability of Google Drive with the benefits of having control over your own data.

![pdrive](https://user-images.githubusercontent.com/121183/87987433-7e86fb00-ca93-11ea-9236-14823d0650c2.gif)


### Installation

```
pip install pdrive
```

### Usage

You can start a server for browsing or modifying a given directory with the following command

```
cd /path/to/my/directory
python -m pdrive
```

### Getting started

You can run pdrive by calling the `python -m pdrive` command within a directory you want to explore. Once running, you can visit the web interface at `http://127.0.0.1:9999`.

If you're running this on a remote server, you can use ssh port forwarding to access the web interface over an ssh connection:

```
ssh -N -L 9999:localhost:9999 your@host.com
```

**SECURITY NOTE:** pdrive will have all the same permissions to modify your file system as the user who started the program.

### Documentation

```
usage: python -m pdrive [-h] [-H HOST] [-p PORT]

optional arguments:
  -h, --help            show this help message and exit
  -H HOST, --host HOST
  -p PORT, --port PORT
```
