https://github.com/skynewz/putio
Put.io HTTP interface as Nginx format
https://github.com/skynewz/putio
go http-server packr putio
Last synced: 11 months ago
JSON representation
Put.io HTTP interface as Nginx format
- Host: GitHub
- URL: https://github.com/skynewz/putio
- Owner: SkYNewZ
- License: gpl-3.0
- Created: 2020-04-30T17:43:07.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-03T20:56:39.000Z (almost 2 years ago)
- Last Synced: 2025-04-20T01:31:08.726Z (about 1 year ago)
- Topics: go, http-server, packr, putio
- Language: Go
- Size: 384 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Put.io HTTP interface
This tool is an index directory listing as Nginx format for your Put.io files. Its supported navigation like Nginx too.
For each file found, a download/streaming link is generated.
⚠️ Unfortunately, this application does not work self-hosted. I knew during one of my deployments that the generated download/streaming links were only valid for the IP that requested them. Concretely, if you deploy it in your local network, it will have the expected behavior. If you deploy it on a remote server and you want to consume a download/streaming link, Put.io will ask for an additional authentication because your IP is different from the remote server. https://app.swaggerhub.com/apis-docs/putio/putio/2.7.1#/files/get_files__id__url.
My instance is hosted on Google Cloud Run and I store users in Google Cloud Firestore.
## Features
- Use a Put.io OAuth token. You must set `PUT_IO_TOKEN=XXX`
- Ofuscation URI for a minimum of privacy. You must set `OFUSCATION_TOKEN=XXXX`
- Cache response (enable by default, can be disable with `NO_CACHE=1`)
- HTTP Basic auth (enable by default, can be disable with `NO_AUTH=1`)
- Store encrypted users passwords in Google Cloud Firestore (need `GOOGLE_CLOUD_PROJECT` of your Firestore project in authentication is enable)
- Support Google Stackdriver logging format using https://github.com/joonix/log
## Deploy with Docker
```bash
$ docker run -itd --name putio -e PUT_IO_TOKEN=XXX -e NO_AUTH=1 -e OFUSCATION_TOKEN=XXXX -p 127.0.0.1:8080:8080 skynewz/putio
```
Homepage URL is `http://localhost:8080//0`. `0` is the root folder ID.
## Standalone binary
To avoid setting environment variables during run (e.g. create a sharable binary for your friends who will be able to launch it with nothing to configure), you can build this application by inserting the necessary credentials.
```bash
$ go build -tags embedded -ldflags="-X 'main.putIOToken=XXXX'" .
```