Paranoid-Dev / ParanoidFFD

Undetectable fanfiction.net Downloader with Parallel Downloading
Apache License 2.0
10 stars 1 forks source link
downloader ebook ebook-downloader epub epub3 fanfiction fanfictiondotnet paranoidffd

ParanoidFFD

Undetectable FanFiction Downloader with Parallel Downloading

The program I was using to download my fanfics broke when fanfiction.net implemented cloudflare which blocks automated downloader scripts.

So I made my own "undetectable" downloader, ParanoidFFD.

Dependency

Python3 dev package (with Python.h header)

Usage

$ ./ParanoidFFD --help

 ________________________________________________________________________________________ 

 Usage    : ParanoidFFD <options>                                                         

 Options  :                                                                               
   -u <fanfiction url> : download from <fanfiction url>                                   
   -f <FORMAT>         : save fanfiction as <FORMAT>                                      
                         currently supported format : txt, epub                           
                         default : txt                                                    
   -o <FILE_NAME>      : save fanfiction as <FILE_NAME>.<FORMAT>                          
                         default : fanfiction_title.<FORMAT>                              
   -t <n>              : numder of parallel download threads, use a positive integer      
                         default : 2                                                      
                         WARNING; high threadcount use for long fics may trigger captchas 
   --version           : show ParanoidFFD version                                         
   --check-update      : check for new updates                                            
   -h , --help         : show this page                                                   

 Examples :                                                                               
   ParanoidFFD -u "my/fan/fiction/url"                                                    
   ParanoidFFD -f epub -t 4 -o "my fanfiction save" -u "my/fan/fiction/url"               
   ParanoidFFD --check-update                                                             
 ________________________________________________________________________________________ 

Using ParanoidFFD may get you (temporarily) banned. Use with caution, especially with parallel downloading. High parallel download threadcount is okay to use for short periods of time, but not for long periods of time. For example, 6 threads is probably okay for a 30 chapter fic, but downloading a 90 chapter fic with 4 threads will probably lead to a captcha and ParanoidFFD failing to download.

Installation (Linux)

git clone https://github.com/Paranoid-Dev/ParanoidFFD.git
cd ParanoidFFD
pip3 install selenium joblib psutil

# do these to use "Chromium appimage and chromedriver for ParanoidFFD". 
# If you choose not to do this, you have to manually download chromedriver from https://chromedriver.chromium.org/downloads
wget https://github.com/Paranoid-Dev/ParanoidFFD/releases/download/v1.3.0.0/ParanoidFFD_chrome.zip
unzip ParanoidFFD_chrome.zip
rm ParanoidFFD_chrome.zip

# change python version and Python.h include path to match your system
gcc parallel-downloader.c -o ParanoidFFD -I/usr/include/python3.9 -lpython3.9

How to find Python.h include path and Python version

$ sudo find / -iname "Python.h"
/usr/include/python3.9/Python.h
/usr/include/python2.7/Python.h

So in my case, my Python version is 3.9, and the Python.h include path is /usr/include/python3.9

WARNING; if you have multiple versions of Python 3 installed, you must compile with your system's default version or it will fail to import

Installation (Windows)

Installation for Windows should be the same as for Linux, except you have to use system installed Google Chrome / Chromium and download Chromedriver yourself.

And in parallel-downloader.c, you have to change ./chromedriver to .\chromedriver.exe (I'll fix this in the coming updates)

I'm working on building a single exe file, but for now, you'll have to compile it yourselves.

Installation (MacOS)

Installation for MacOS should be the same as for Linux, except you have to use system installed Google Chrome / Chromium and download Chromedriver yourself.

For "brew installed Python" users

brew install python@3.9
pip3 install selenium joblib psutil

# for apple silicon
clang parallel-downloader.c -o ParanoidFFD -I/opt/homebrew/Frameworks/Python.framework/Versions/3.9/include/python3.9 -L/opt/homebrew/Frameworks/Python.framework/Versions/3.9/lib -lpython3.9

# for intel
clang parallel-downloader.c -o ParanoidFFD -I/usr/local/homebrew/Frameworks/Python.framework/Versions/3.9/include/python3.9 -L/usr/local/homebrew/Frameworks/Python.framework/Versions/3.9/lib -lpython3.9

For "non-brew installed Python" users

sudo find / -iname "Python.h" : Find Python.h include path and Python version

Change Python version and Python.h include path, and Python library path to match your system and apply to above.

Discord

discord.gg/vuyt6HSSFb Get the Paranoid Programmer role to join the (yet small) ParanoidFFD community