Skip to content

Repository files navigation

Patreon Gate

Patreon Gate is a Nextcloud app that lets administrators protect selected folders behind Patreon authentication and tier-based access.

Patrons do not receive Nextcloud accounts and do not interact with the normal Nextcloud Files interface. Instead, they open a protected Patreon Gate link, authenticate with Patreon, and receive access only if their current Patreon membership matches one of the tiers configured for that share.

Features

  • Native integration with the Nextcloud Files sharing sidebar
  • Patreon OAuth authentication
  • Per-folder Patreon tier selection
  • Multiple Patreon tiers per share
  • Recursive access to files and subfolders
  • Protected links that can be revoked permanently
  • Large-file streaming
  • HTTP Range support for resumable downloads
  • Files larger than 2 GB supported on 64-bit PHP
  • Native Nextcloud administration settings
  • Optional administrator-only test access for configuration and troubleshooting

Requirements

  • Nextcloud 33
  • 64-bit PHP
  • A Patreon creator account
  • A Patreon OAuth client
  • A Patreon creator access token with access to campaign membership and tier information

How it works

A Nextcloud administrator selects a folder in Files and creates a Patreon Gate share from the standard Sharing sidebar.

The administrator chooses which Patreon tiers may access the folder. Patreon Gate creates a protected URL for that share.

When a visitor opens the protected URL:

  1. Patreon Gate requires Patreon authentication.
  2. The visitor's current entitled Patreon tiers are checked.
  3. Access is granted only when at least one entitled tier matches the share configuration.
  4. The visitor can browse only the shared folder and its descendants.
  5. Downloads remain protected by the same authorization checks.

The protected URL itself is not a credential.

Security model

Patreon Gate does not create Nextcloud accounts for patrons.

A Patreon share exposes only the explicitly selected folder and its descendants. Nextcloud node IDs outside that shared tree cannot be accessed through the share.

Revoking a Patreon Gate share permanently disables its token. Re-sharing the same folder creates a new token.

Administrator test access is disabled by default and can only be used by a Nextcloud administrator.

Large downloads

Patreon Gate streams downloads rather than loading entire files into memory.

It supports HTTP byte ranges, including pause and resume behavior in browsers. Large-file testing has included range requests beyond the 2 GB boundary.

Configuration

After installing and enabling Patreon Gate:

  1. Open Administration Settings → Patreon Gate.
  2. Configure the Patreon Client ID.
  3. Configure the Patreon Client Secret.
  4. Configure the Patreon Creator Access Token.
  5. Use the displayed callback URL in the Patreon OAuth client configuration.
  6. Refresh Patreon tiers.
  7. Open Files, select a folder, and use Sharing → Additional shares → Patreon.

Secrets are stored in Nextcloud app configuration and are not returned by the Patreon Gate settings API.

Status

Patreon Gate is currently being prepared for its first public release.

The initial release targets Nextcloud 33 only.

License

Patreon Gate is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later).

About

A nextcloud app for Patreon client authentication integration

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages