mirror of https://github.com/Radiquum/furaffinity-dl.git synced 2025-04-04 23:34:37 +00:00

FurAffinity Downloader, now with 100% more Python

Find a file

Liam 253cc74f7d Merge pull request #69 from an0nusr/add_name_to_download_fail When a download fails, include filename in output.		2022-03-27 15:32:10 +01:00
.gitignore	Minor README fixes	2020-04-20 16:35:33 +01:00
furaffinity-dl.py	When a download fails, include filename in output.	2022-03-26 14:44:22 -07:00
LICENSE	First public release of the python rewrite	2020-04-06 23:27:20 +01:00
README.md	Add note about folder downloading, close #60	2021-07-20 18:49:10 +01:00
requirements.txt	Swtich to `requests`, tidy up README, add requirements.txt	2020-07-17 18:51:34 +01:00

README.md

This branch is the development version of furaffinity-dl rewritten in python.

FurAffinity Downloader

furaffinity-dl is a python script for batch downloading of galleries (and scraps/favourites) from furaffinity users. It was written for preservation of culture, to counter the people nuking their galleries every once a while.

Supports all known submission types: images, text, flash and audio.

Requirements

pip3 install -r requirements.txt

The script currently only works with the "Modern" theme

furaffinity-dl has only been tested only on Linux, however it should also work on Mac, Windows or any other platform that supports python.

Usage

When downloading a folder make sure to put everything after /folder/, for example 123456/Folder-Name-Here instead of just 123456 (ref #60).

usage: furaffinity-dl.py [-h] [--output OUTPUT] [--cookies COOKIES] [--ua UA] [--start START] [--dont-redownload] [--interval INTERVAL] [--metadir METADIR]
                         [category] [username] [folder]

Downloads the entire gallery/scraps/favorites of a furaffinity user

positional arguments:
  category              the category to download, gallery/scraps/favorites
  username              username of the furaffinity user
  folder                name of the folder (full path, for instance 123456/Folder-Name-Here)

optional arguments:
  -h, --help            show this help message and exit
  --output OUTPUT, -o OUTPUT
                        output directory
  --cookies COOKIES, -c COOKIES
                        path to a NetScape cookies file
  --ua UA, -u UA        Your browser's useragent, may be required, depending on your luck
  --start START, -s START
                        page number to start from
  --dont-redownload, -d
                        Don't redownload files that have already been downloaded
  --interval INTERVAL, -i INTERVAL
                        delay between downloading pages
  --metadir METADIR, -m METADIR
                        directory to put meta files in

Examples:
 python3 furaffinity-dl.py gallery koul
 python3 furaffinity-dl.py -o koulsArt gallery koul
 python3 furaffinity-dl.py -o mylasFavs favorites mylafox

You can also log in to FurAffinity in a web browser and load cookies to download restricted content:
 python3 furaffinity-dl.py -c cookies.txt gallery letodoesart

DISCLAIMER: It is your own responsibility to check whether batch downloading is allowed by FurAffinity terms of service and to abide by them.

You can also log in to download restricted content. To do that, log in to FurAffinity in your web browser, export cookies to a file from your web browser in Netscape format (there are extensions to do that for Firefox and for Chrome based browsers), you can then pass them to the script with the -c flag, like this (you may also have to provide your user agent):

python3 furaffinity-dl.py -c cookies.txt -u 'Mozilla/5.0 ....' gallery letodoesart

TODO

Download user profile information.
"Classic" theme support
Login without having to export cookies

Disclaimer

It is your own responsibility to check whether batch downloading is allowed by FurAffinity's terms of service and to abide by them. For further disclaimers see LICENSE.