patreon-dl
v3.6.0TypeScript
Patreon Downloader
0/weekUpdated 3 weeks agoMITUnpacked: 45.4 MB
Published by Patrick Kan
npm install patreon-dl
patreon-dl
A Patreon downloader written in Node.js.
This repo contains the patreon-dl library and its command-line tool. For GUI application, check out patreon-dl-gui.
$3
- Access to patron-only content through cookie. This refers to content you have access to under your account. It does not include locked content that you don't have a subscription for.
- Download posts by user, in a collection or single post.
- Download products (aka shop purchases)
- Items included in downloads:
- videos
- images
- audio
- attachments
- embedded videos
- YouTube downloader built-in with configurable max resolution
- Supports external downloader
- Save campaign and content info
- Extensively configurable
- Browse downloaded content through integrated web server
You can run patreon-dl from the command-line or use it as a library for your project. Node.js v20 or higher required.
$3
- Embedded links are not followed; only info about the embed is saved. Exception:
- YouTube video link - in which case the video is downloaded; or
- An external downloader is configured for the link provider.
For information on external downloaders, see the Embedded videos / links - external downloader section. Example config is provided for fetching YouTube (replacing the built-in downloader) and Vimeo videos.
$3
FFmpeg is required when downloading:
- videos that are provided only in streaming format; and
- embedded YouTube videos.
Not all video downloads require FFmpeg, but you should have it installed on your system anyway.
$3
patreon-dl supports downloading embedded YouTube videos or from embedded YouTube video links.
#### Deno dependency
The built-in YouTube downloader runs code retrieved from YouTube or Google servers. If Deno is installed on your system, it will be used to execute this code within a secure, sandboxed environment. Without Deno, the code runs without isolation, increasing the risk of security vulnerabilities such as unauthorized access, data corruption, or malicious behavior. For this reason, installing Deno is strongly recommended.
When needed, the downloader will attempt to invoke the deno command. If it’s not found, it will default to unsafe execution. If Deno is installed but the deno executable isn’t available in your system’s PATH, you can manually specify its location using the --deno CLI option or path.to.deno config file option:
``
// CLI
$ patreon-dl --deno path/to/deno ...
// Config file
[downloader]
path.to.deno = "path/to/deno"
...
`
#### Premium access
If you have a YouTube Premium subscription, you can connect patreon-dl to your account and download videos at qualities available only to Premium accounts (e.g. '1080p Premium'). For CLI users, you would configure patreon-dl as follows:
`
$ patreon-dl --configure-youtube
> ...or you may just refer to the next section on how to download enhanecd-quality videos without a Premium account.
$3
You can specify external programs to download embedded videos or from embedded links. For YouTube videos, this will replace the built-in downloader.
See the example config on how to configure an external downloader to fetch YouTube, Vimeo and SproutVideo content through yt-dlp. Helper scripts bundled with patreon-dl are used in the case of Vimeo and SproutVideo (patreon-dl-vimeo.js and patreon-dl-sprout.js respectively).
Installation
1. First, install Node.js.
2. Then, install FFmpeg (if you are going to download videos).
3. Then, in a terminal, run the following command:
`
$ npm i -g patreon-dl
The -g option is for installing patreon-dl globally and have the CLI executable added to the PATH. Depending on your usage, you might not need this.
CLI usage
`
$ patreon-dl [OPTION]... URL
$3
| Option | Alias | Description | List tiers for the given creator(s). Separate multiple creators with a comma. Configure YouTube connection.
|-----------|-------|-------------|
| --help | -h | Display usage guide |-C
| | Load configuration file at for setting full options |--cookie
| | -c | Cookie for accessing patron-only content; how to obtain cookie. |--ffmpeg
| | -f | Path to FFmpeg executable |--deno
| | -d | Path to Deno executable |--out-dir
| |-o | Directory to save content |--log-level
| | -l | Log level of the console logger: info, debug, warn or error; set to none to disable the logger. |--no-prompt
| | -y | Do not prompt for confirmation to proceed |--dry-run
| | | Run without writing files to disk (except logs, if any). Intended for testing / debugging. |posts.in.tier
| filtering option under include section of configuration file. |--list-tiers
| , but takes user ID instead of vanity. |--configure-youtube
| | | patreon-dl supports downloading embedded YouTube videos. If you have a YouTube Premium account, you can connect patreon-dl to it for downloading Premium-quality streams. |
$3
#### Supported URL formats
`
// Download products from a creator's shop
https://www.patreon.com/
https://www.patreon.com/c/
https://www.patreon.com/cw/
// Download a single product
https://www.patreon.com/
// Download posts by creator
https://www.patreon.com/
https://www.patreon.com/c/
https://www.patreon.com/cw/
https://www.patreon.com/user/posts?u=
// Dowload a single post
https://www.patreon.com/posts/
https://www.patreon.com/posts/
// Download posts in a collection
https://www.patreon.com/collection/
`
#### Multiple URLs
You may specify multiple URLs by separating them with a comma. E.g.:
`
// First download posts by johndoe, followed by posts by janedoe.
$ patreon-dl "https://www.patreon.com/johndoe/posts,https://www.patreon.com/janedoe/posts"
#### Supplying URLs through file
You can also use a file to supply URLs to patreon-dl. For example, you can have a urls.txt that has the following content:
`Each URL is placed in its own line
Comments (lines starting with '#') will be ignored
https://www.patreon.com/johndoe/posts
https://www.patreon.com/janedoe/posts
`
You can then pass urls.txt to patreon-dl:
`
$ patreon-dl urls.txt
In this file, you can also override include options provided in a configuration file passed to patreon-dl (through the -C option). include options allow you specify what to include in downloads. This overriding mechanism allows you to specify different content to download for each target URL. For example, you might have the following include option in your configuration file:
`
...
[include]
Include posts that belong only to tier ID '-1' (public tier)
posts.in.tier = -1
...
`
Then, in your urls.txt, you can override as follows:
`URL 1
https://www.patreon.com/johndoe/posts
Override 'posts.in.tier = -1' in [include] section of configuration file.
This will cause downloader to download posts from URL 1 belonging to tier with
ID '123456' or '789100'.
include.posts.in.tier = 123456, 789100
Other include options - they basically have the same name as those
in the configuation file, but prepended with 'include.':
#
include.locked.content
include.posts.with.media.type
include.posts.published.after
include.posts.published.before
include.campaign.info
include.content.info
include.preview.media
include.content.media
include.all.media.variants
include.images.by.filename
include.audio.by.filename
include.attachments.by.filename
include.comments
URL 2
https://www.patreon.com/janedoe/posts
If you don't place any 'include.*' statements here, the downloader will use
options from configuration file or default values if none provided.
URL 3
...
`
$3
Content is saved with the following directory structure:
`
out-dir
├── campaign
├── campaign_info
├── posts
│ ├── post 1
│ │ ├── post_info
│ │ ├── images
│ │ ├── ...
│ ├── post 2
│ ├── post_info
│ ├── images
│ ├── ...
├──shop
├── product 1
├── product_info
├── content_media
├── ...
$3
Command-line options are limited. To access the full range of options, create a configuration file and pass it to patreon-dl with the (capital) -C option.
Refer to the example config to see what options are offered. Also see How to obtain Cookie.
Note that you can override an option from a configuration file with one provided at the command-line, provided of course that a command-line equivalent is available.
Browsing downloaded content
patreon-dl comes with a web server that allows you to browse downloaded content. To start the web server:
`
$ patreon-dl-server [OPTION]
$3
| Option | Alias | Description |
|-----------|-------|-------------|
| --help | -h | Display usage guide |--data-dir
|
|-i | Directory containing downloaded content. Default: current working directory |
| --port |-p | Web server port. Default: 3000, or a random port if 3000 is already in use. |
| --log-level | -l | Log level of the console logger: info, debug, warn or error; set to none to disable the logger. Default: info |
| --log-file | -f | Save logs to . |
$3
Say you downloaded something with
patreon-dl:`
$ patreon-dl -o "C:\PatreonDownloads"
This will download content to
. To view the downloaded content, start patreon-dl server as follows:`
$ patreon-dl-server -i "C:\PatreonDownloads"...info: Web server is running on
Note the URL shown in the output. Open this URL in a web browser to begin viewing the downloaded content.
> Keep in mind that the web server is in no way secure. It is meant for local browsing and should not be exposed to outside parties!
Changelog
v3.6.0
- Browse: affix nav links (previous / next post) to viewport bottom if post content overflows (patreon-dl-gui#41)
- Fix error when Deno path contains spaces (patreon-dl-gui#42)
- Add SproutVideo download script (patreon-dl-gui#43)
- Fix YouTube download returning "auth required" error
v3.5.0
- Add support for downloading from "shop" URLs (e.g.
). This will download all products from a creator's shop.
- Add productsPublished / products.published.after / products.published.before option to set publish date criteria of products included in download.
- Since stopOn / stop.on option now also applies to products, the postPreviouslyDownloaded and postPublishDateOutOfRange values have been deprecated in favor of previouslyDownloaded and publishDateOutOfRange, respectively.
- Add Collections support. Collection info is now saved when downloading posts. This means you can browse posts by collection. (#107)
- (Browse) Add search functionality (#106)
- Add Tags support. Tag info is now saved when downloading posts. This means you can filter posts by tag.
- Add include.mediaThumbnails optionv3.4.0
- Fix "no posts found" on "cw" pages (patreon-dl-gui#30)
- Fix YouTube streams returning 403 error (patreon-dl-gui#31)
- Add
pathToDeno / --deno / path.to.deno option (used by built-in YouTube downloader)
- Merged PRs:
- Allow directory to be a symlink (@piperswe - #101)
- Add Github actions (@piperswe - #102)
- Add maxVideoResolution / max.video.resolution option to limit video downloads to a maximum resolution (see example.conf) (@eisenbruch - #105) - extended to include site-hosted videosv3.3.1
- Fix bugs affecting library usage:
-
DB.getInstance() returning same instance despite different DB path
- API.getInstance() returning same instance despite different DB instance
- DB not closed when downloader ends or web server stopsv3.3.0
- Fix:
- YouTube stream fetching error (patreon-dl-gui#28)
- Unsupported option error with FFmpeg v7.1.0 (#97)
- Browse:
- Add next / previous links to post page (#93)
- Fix media filter error when tier selected but not "Post"
- Process linked attachments in body of posts (patreon-dl-gui#27)
- Some DB optimizations (contrib by @piperswe - PR #95)
v3.2.1
- Fix log file path sometimes not sanitized properly on Windows
- API: add support for passing request options to
getCampaign()
- CLI: add support for using request options from conf file when running with / --list-tiers-uidv3.2.0
- Fix:
- "Initial data not found" error in
pages (#85) and custom-domain pages
- FFmpeg v7.x compatibility issues (#86)
- Dry-run mode executing ops that should have been skipped
- Wrong log file path returned in some cases
- Various YouTube downloading issues
- Add:
- Support passing options to yt-dlp in Vimeo download script
- Support case-sensitivity flag in config.include.mediaByFilename options
- Browse:
- Show inline images within post body
- Show YouTube embed HTML content if video not downloaded (#87)
- Display "show more" toggle for long post bodies
- API:
- Downloader.getCampaign(params): enable lookup by params.campaignIdv3.1.0
- Defer database initialization until downloader starts
- UI: fix post column width possibly exceeding screen width
- Add
optionv3.0.0
- Add support for browsing downloaded content through integrated web server. Note: this feature will not work for downloads made with previous versions of
patreon-dl.v2.4.3
- Fix YouTube embeds failing to download due to YT changes
- Add fallback download logic to Vimeo download script
- Fix error when downloading video (#75)
v2.4.2
- Fix YouTube embeds failing to download due to YT changes
- Fix slow YouTube downloads (#66)
- Other minor fixes
v2.4.1
- Fix Vimeo download script obtaining and downloading from player URL in embed HTML (#65)
- Add
post-url and cookie to available external downloader exec params
- API changes (non-breaking):
- Expose cookie in DownloaderConfig
v2.4.0
- Support additional URL format:
- Add option (#63)
- Add proxy option (#62)
- Fix Vimeo download script
- Fix YouTube embeds failing to download due to YT changes
- API changes (non-breaking):
- Expose URLHelper, FetcherError
- Add
- / FileLogger: add getDefaultConfig()
- Required Node version bumped to v20.18.1 or higherv2.3.0
- Add
type to include.postsWithMediaType option
- Add include.comments option
- Fix videos not downloaded in podcast-type posts (#56)v2.2.0
- Widen scope of external downloaders to any type of embed (previously only works for video embeds) (#51)
- YouTube downloading now covers embedded YT links
- Fix attachment filenames sometimes have wrong extension
v2.1.1
- Fix multiple abort signal listeners triggering warning (#48)
- Fix YouTube embeds failing to download due to YT changes (#50)
- Fix inline images of posts sometimes missing from downloads
- Fix status cache: target marked as downloaded without errors despite having errors at task creation stage
v2.1.0
- Fix attachment downloads following API changes (#40)
- Add support for URL format:
https://www.patreon.com/c/
- Check and resolve conflicting destination paths (#38)
- Parse inline content media (#40)v2.0.0
- Replace node-fetch with Fetch API; required Node.js version bumped to v18 or higher.
- Update dependencies and libraries
- New
options:
- include.postsPublished (#29)
- include.mediaByFilename (#33)
- Bug fixes:
- 403 error when downloading YouTube embeds
- Only first of multiple targets downloaded (#26)v1.7.0
- Download next batch of posts before expiry of 'next' URL (fixes #22)
- Add
--dry-run / dryRun option
- Support URL format https://www.patreon.com/posts/v1.6.2
- Fix 'campaign ID not found' error due to Patreon changes
v1.6.1
- Fix file extension sometimes missing (#20)
v1.6.0
- Add external downloader support for embedded videos
v1.5.0
- Add support for fetching by user ID instead of creator vanity (#18):
- Support URL format
- Overload to take userId arg
- CLI: add --list-tiers-uidv1.4.0
- Add ability to filter posts by tier (#8)
- CLI:
- Add
- Add support for target-specific options
- Print summary at the end for multiple target URLs (#13)v1.3.0
- Add support for multiple target URLs
- Add
content.publishDate` field to the content dir name format (PR #12 by kazuoteramoto)- Bug fixes
v1.2.2
- Fix wrong file extension for some content types
- Fix YouTube API requests throwing errors due to YT changes
v1.2.1
- Bug fixes
v1.2.0
- Add support for granular control over:
- posts to include in download based on type of media contained
- the type of media to download
- Bug fixes
v1.1.1
- Fix initial data parsing following Patreon changes
v1.1.0
- Add support for downloading embedded YouTube videos
v1.0.1
- Fix missing types when importing as library
- Fix link in this README
v1.0.0
- Initial release
---
This project is licensed under the MIT License and includes third-party software—see the NOTICE file for attributions.