patreon-dl-gui

An Electron app that provides a GUI for patreon-dl.

Features

• Download posts by a creator, in a collection or single post. Includes patron-only content provided you have a subscription to access it.
• Download products purchased from a creator's shop.
• Items included in downloads:
  • videos
  • images
  • audio
  • attachments
  • embedded YouTube and Vimeo videos
• Save campaign and content info
• Extensively configurable, e.g.:
  • Download only certain types of media
  • Filter posts by tier, date published, type of media contained
  • Download through proxy server

Installation

Download and install the package suitable for your system. Linux (RPM and DEB) and Windows x64 versions are provided. If you are on a different system, you may run or package the app from source.

If you are going to download videos, you should also install FFmpeg. This is required for most videos found on Patreon.

Furthermore, if you intend to download embedded Vimeo videos, you are recommended to install yt-dlp and use the bundled helper script. See Downloading embedded Vimeo videos using helper script.

Quick start guide

• The UI consists of two major components: the editor and an embedded web browser.
• In the embedded web browser, go to the Patreon page you want to download content from. For content that is accessible only through subscription (which you need to have), ensure you are logged in. Content that is downloadable includes:
  • Posts by a creator
  • A single post
  • Posts in a collection
  • Product purchased from a creator's shop
• When you visit a Patreon page, the app checks whether it contains content that is downloadable. Identified targets are shown in the Download section of the editor, along with crucial data such as cookie which is required to download patron-only content.
• Once a target is identified, you can configure the options to suit your needs. To get help about an option, select the "Show Help Icons" item in the Help menu.
• To begin downloading the target, click the "play" button in the toolbar. You may also save the configuration to file and open it on another occasion.

Downloading embedded Vimeo videos using helper script

patreon-dl-gui provides a helper script to facilitate downloading of embedded Vimeo videos. The script uses yt-dlp in the process. The easiest way to set things up would be to:

1. Download a precompiled binary of yt-dlp suitable for your system.
2. Then, in patreon-dl-gui, go to "Embeds" -> "Vimeo".
3. Select "Use helper script" for "Download method".
4. Click the folder icon for "Path to yt-dlp" and select the downloaded binary.

Interoperability with patreon-dl CLI

patreon-dl-gui is a standalone app that utilizes the patreon-dl library to download Patreon content. On the other hand, patreon-dl comes with a CLI tool that has the option to read downloader options from a config file.

Generally speaking, config files saved in patreon-dl-gui can be passed to the patreon-dl CLI tool without issue, subject to the following exceptions:

• The "Connect to YouTube account" option found in patreon-dl-gui has no equivalent in patreon-dl CLI config. You would have to connect to your YouTube account separately through executing patreon-dl --configure-youtube.
• Like patreon-dl-gui, patreon-dl provides a helper script for downloading embedded Vimeo videos, but you would have to set it up yourself in the config (see example).

What about the other way round? You should note that the config schema accepted by patreon-dl CLI is broader than that for patreon-dl-gui. This means, if you have a config file manually created for use by patreon-dl CLI, opening it in patreon-dl-gui will not necessarily import all the options therein. In particular:

• Multiple targets are not supported.
• For file logger configuration, sections other than [logger.file.1] are ignored. patreon-dl-gui only supports a single file logger configuration.

When you open a config file, the app will notify you of any omitted or unsupported options.

If you intend to create a config file in patreon-dl-gui for use with patreon-dl CLI, you should also ensure that the version of patreon-dl used by the app matches that of the CLI:

patreon-dl-gui version	patreon-dl version used
v1.0.0 - v2.0.0	v2.4.1
v2.1.0	v2.4.2

Running / packaging the app from source

You need Node JS v20.18.1 or higher.

To run in dev mode:

$ git clone https://github.com/patrickkfkan/patreon-dl-gui.git
$ cd patreon-dl-gui
$ npm i
$ npm run start

To package the app for your OS:

$ npm run make

Changelog

v2.1.0

• Update patreon-dl library to v2.4.2 (mainly fixes YouTube download issues)
• Fix compatibility with Node JS v23 (#2)
• Simplify downloading embedded Vimeo videos through helper script

v2.0.0

• Major UI overhaul: web browser is now embedded into the main window
• Remove the need to download web browser dependency
• One-click to apply proxy settings to web browser session
• Add option to connect to YouTube acount for embedded YouTube videos
• File logger is disabled by default
• Bugfixes

v1.0.0

• Initial release

License

MIT