skynewz/putio repository overview

⁠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

$ 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/<OFUSCATION_TOKEN>/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.

$ go build -tags embedded -ldflags="-X 'main.putIOToken=XXXX'" .