fa-fave-downloader 0.3.0

A tool to download your favorites from Fur Affinity

fa-fave-downloader

A utility to download your favourites from FurAffinity

Installation

From Source

1. Clone the repository:

   git clone https://github.com/yourusername/fa-fave-downloader.git
   cd fa-fave-downloader
   

2. Install the package:

   pip install .
   

For Development

pip install -e .

Development

• Run tests: python -m pytest
• Lint code: flake8 ./src
• Build: python -m build

Usage

Note you will need python 3.10 or higher to run the tool.

To install the tool from PyPI:

pip install fa-fave-downloader

After installation, run the tool:

fa-fave-downloader -h
usage: fa-fave-downloader [-h] --username USERNAME [--save-path SAVE_PATH] [--cookie COOKIE] [--version]

FurAffinity favourite downloader

options:
  -h, --help            show this help message and exit
  --username, -u USERNAME
                        REQUIRED: Fur Affinity username to download favorites from
  --save-path, -p SAVE_PATH
                        Directory to save images (default: ./save)
  --cookie, -c COOKIE   Optional: path to your FA cookie file for authenticated access
  --version             show program's version number and exit

Authenticated Sessions

Some images require an authenticated session to download. To use an authenticated session, you will need to export your FurAffinity session cookies as Netscape formatted cookies file. There are plugins for:

• Chrome
• Firefox
• Edge

Once you have the cookies file, you can include it with the download command:

fa-fave-downloader -u yourusername -c /path/to/cookies.txt