A set of useful utils for dumping and and wiping your gumroad.com library.
Table of contents (generated with markdown-toc)
This tool started out of desire to download products that don't provide "Download as ZIP" button. Nothing more, nothing else.
Download this repository either by this link or by simply cloning this repo:
git clone --depth 1 https://github.com/obsessedcake/gumroad-utils.git
Then install all required python packages:
python3 -m venv .venv # optional step
source .venv/bin/activate # optional step
pip install -e .
You need to rename config.tmpl.ini into config.ini
and put a correct data there.
app_session
->_gumroad_app_session
cookie value,guid
->_gumroad_guid
cookie value,user_agent
-> your user agent.
Please take into account that _gumroad_app_session
changes quite often so don't be afraid that suddenly nothing works.
You can customize product folder name by altering product_folder_tmpl
.
product_folder_tmpl
follow the general rules of str.format()
(PEP 3101).
Following values currently can be used in template:
purchase_at
: datetime.date,uploaded_at
: datetime.date - only available when downloading library,product_name
: str,price
: str.
This project is exposed in two ways: as a package and as a command line tool.
This project exposes a gumroad_utils
package that exposes gumroad.com API and can be used as shown below.
from pathlib import Path
from gumroad_utils import GumroadScrapper, GumroadSession
session = GumroadSession(
app_session="MyAppSession",
guid="MyGuid",
user_agent="MyUserAgent",
)
scrapper = GumroadScrapper(
session,
root_folder=Path.cwd(),
product_folder_tmpl="{product_name}",
)
scrapper.scrape_library()
It's also worth to mention that GumroadScrapper
uses it's own logger instance.
Therefore if you want to configure it, you need to call logging.basicConfig before making a new instance of the GumroadScrapper
class.
This project also exposes a simple gumroad-utils
command that can either download your whole library or a single product.
To download all products in your library, run one of below command:
gumroad-utils
gumroad-utils -c path/to/my-config.ini -o path/to/output/directory
To download a single product, run one of below command:
gumroad-utils https://app.gumroad.com/d/f0000000000000000000000000000000
gumroad-utils f0000000000000000000000000000000
(-c
and -o
flags works the same way here.)
- Improve caching.
- Implement automatic wiping of all library products.
- Implement payments statistic.
All code is licensed under the GPL-3.0 license.
This project currently scraps gumroad.com directly without using their internal API. It may not work tomorrow, it may not work in a month, gumroad.com could break it at any moment. It works now, though.
Taking into an account what has been said, please, be a decent person, don't re-scrape your library and bought products too much. Using this tool once a day is probably a reasonable maximum. Abuse of their site will likely lead to their reasonable reaction, and being able to programmatically fetch all your accounts data is too nice of a facility to lose to assholes abusing things.