v1.68

Pixeldrain

This is the backend for Pixeldrain’s premium filesystem feature. This is not the same as pixeldrain’s free file sharing product. The filesystem requires either a Pro subscription or the Prepaid plan. More information on subscriptions.

An overview of the filesystem’s features and limitations is available in the filesystem guide on pixeldrain.

Usage with account

To use the personal filesystem you will need a pixeldrain account and either the Prepaid plan or one of the Patreon-based subscriptions. After registering and subscribing, your personal filesystem will be available at this link: https://pixeldrain.com/d/me.

Go to the API keys page on your account and generate a new API key for rclone. Then run rclone config and use the API key to create a new backend.

Example:

  1. No remotes found, make a new one?
  2. n) New remote
  3. d) Delete remote
  4. c) Copy remote
  5. s) Set configuration password
  6. q) Quit config
  7. n/d/c/s/q> n
  8. Enter name for new remote.
  9. name> pixeldrainfs
  10. Option Storage.
  11. Type of storage to configure.
  12. Choose a number from below, or type in your own value.
  13. ...
  14. XX / Pixeldrain Filesystem
  15. \ (pixeldrain)
  16. ...
  17. Storage> pixeldrain
  18. Option api_key.
  19. API key for your pixeldrain account.
  20. Found on https://pixeldrain.com/user/api_keys.
  21. Enter a value. Press Enter to leave empty.
  22. api_key> b1bb1e81-9b7b-406b-986a-c9b20be76e15
  23. Option directory_id.
  24. Root of the filesystem to use. Set to 'me' to use your personal filesystem.
  25. Set to a shared directory ID to use a shared directory.
  26. Enter a string value. Press Enter for the default (me).
  27. directory_id>
  28. Edit advanced config?
  29. y) Yes
  30. n) No (default)
  31. y/n>
  32. Configuration complete.
  33. Options:
  34. - type: pixeldrain
  35. - api_key: b1bb1e81-9b7b-406b-986a-c9b20be76e15
  36. Keep this "pixeldrainfs" remote?
  37. y) Yes this is OK (default)
  38. e) Edit this remote
  39. d) Delete this remote
  40. y/e/d>
  41. Current remotes:
  42. Name Type
  43. ==== ====
  44. pixeldrainfs pixeldrain
  45. e) Edit existing remote
  46. n) New remote
  47. d) Delete remote
  48. r) Rename remote
  49. c) Copy remote
  50. s) Set configuration password
  51. q) Quit config
  52. e/n/d/r/c/s/q> q

Usage without account

It is possible to gain read-only access to publicly shared directories through rclone. For this you only need a directory ID. The directory ID can be found in the URL of a shared directory, the URL will look like this https://pixeldrain.com/d/abcd1234 where abcd1234 is the directory ID. Directory IDs in your own filesystem can also be listed with the lsf command:

rclone lsf Pixeldrain: --dirs-only -Fpi

This will print directories in your Pixeldrain home directory and their public IDs.

Enter this directory ID in the rclone config and you will be able to access the directory.

Standard options

Here are the Standard options specific to pixeldrain (Pixeldrain Filesystem).

--pixeldrain-api-key

API key for your pixeldrain account. Found on https://pixeldrain.com/user/api_keys.

Properties:

  • Config: api_key
  • Env Var: RCLONE_PIXELDRAIN_API_KEY
  • Type: string
  • Required: false

--pixeldrain-root-folder-id

Root of the filesystem to use.

Set to ‘me’ to use your personal filesystem. Set to a shared directory ID to use a shared directory.

Properties:

  • Config: root_folder_id
  • Env Var: RCLONE_PIXELDRAIN_ROOT_FOLDER_ID
  • Type: string
  • Default: “me”

Advanced options

Here are the Advanced options specific to pixeldrain (Pixeldrain Filesystem).

--pixeldrain-api-url

The API endpoint to connect to. In the vast majority of cases it’s fine to leave this at default. It is only intended to be changed for testing purposes.

Properties:

--pixeldrain-description

Description of the remote.

Properties:

  • Config: description
  • Env Var: RCLONE_PIXELDRAIN_DESCRIPTION
  • Type: string
  • Required: false

Metadata

Pixeldrain supports file modes and creation times.

Here are the possible system metadata items for the pixeldrain backend.

NameHelpTypeExampleRead Only
btimeTime of file birth (creation)RFC 33392006-01-02T15:04:05.999999999Z07:00N
modeFile modeoctal, unix style755N
mtimeTime of last modificationRFC 33392006-01-02T15:04:05.999999999Z07:00N

See the metadata docs for more info.