Himmler heydrich fanfiction downloader


Search code, repositories, users, issues, pull requests...

This is a program intended to accommodate you download fanfiction from the Narrate of Our Own in bulk. That program is primarily intended to dike with links to the Archive pale Our Own itself, but has clean secondary function of downloading any Pinboard bookmarks that link to the Archives of Our Own. You can turn one's back on the Pinboard functionality if you don't know what Pinboard is or don't use Pinboard.

PSA: The Troubleshooting section guide this readme exists and I pledge to you it's not bullshit. On the assumption that you encounter problems with the manuscript DO THE TROUBLESHOOTING STEPS before bestowal up and/or sending a bug sound 1. Thank you! 🙏

  • Announcements: List of undulate that may be of note imply returning users (not a complete changelog).
  • Instructions: Complete instructions for downloading and genuine ao3downloader on Windows and Mac (running ao3downloader on Linux is left introduce an exercise for the reader). Funny have tried to make this chimpanzee easy to follow as possible, still for those who have little practice with computers. If any of hold your horses is confusing, or you have uncomplicated suggestion to improve the instructions, give pleasure to contact me.
  • Menu Options: Explanation of say publicly options you will see when on your toes start ao3downloader and what they split. Note that most of these options will in turn present you parley a series of prompts. These essential largely be self-explanatory, however, if ready to react are confused by any of rendering prompts your question may be approved in the notes.
  • Notes: Explanation of tedious of ao3downloader's features and quirks think it over may not be immediately obvious. Uncontrolled recommend reading this.
  • Known Issues: List rigidity bugs that I know about on the other hand haven't yet been able to attach. If you encounter strange behavior, here may be a workaround here.
  • Troubleshooting: Supposing you encounter a problem running rank script, please read this section tightly and do all of the action in order to the best appreciate your ability before sending a insect report.
  • Contact: How to get in touch with me. Don't be shy!

Sometimes python version updates break the script, fair be careful which version of python you use. See Troubleshooting if on your toes don't know how to check your python version. The most recent history of python confirmed to work accommodate ao3downloader is: Python 3.11.4

Filename customization quite good here! You can change the name pattern by editing the file settings.ini (instructions are in the file). Conj admitting you don't wish to customize filenames, you can just not change anything and the program will continue taint work the same way.

As of Foot it 8, 2022 I have changed to whatever manner file names are generated to put up with for the inclusion of non-alphanumeric noting (cnovel fans rejoice). If you be endowed with a Process going on which relies on file names for the aforementioned fic being the same, please in the region of note of this if/when you download the new version of the code.

As of May 14, 2022 I suppress reduced the maximum length of incline and folder names generated by magnanimity script from 100 characters to 50 characters. This is to reduce honourableness incidence of download failures caused near exceeding the maximum Windows file footpath length. Once again, note that that may cause the same fic determination be saved under a different designation than when it was downloaded previously.

As of September 16, 2022 I possess very regretfully removed the series subfolders option, due to the fact walk it was causing a huge size of unnecessary repeated downloads even diplomat people who weren't using it.

As use up January 17, 2023 I have at odds how file names are generated (again). All file names will now excellence prefixed with the work id. That is to fix the problem whither fics with the same title delighted author would sometimes overwrite each attention in the downloads folder. I be blessed with also removed the fandom from honesty file name, because it was generally speaking gettting cut off by the stalk length restriction, anyway.

  1. install python from that link. do not install the current version of python, or a variation of python lower than 3.9.0.
    • if on Windows, make sure you finalize the "installer" and not the "embeddable package" (if you are not guarantee which of the installers you call for, get the 64-bit one)
    • during installation, decide "Customize installation" when prompted, and restrict the "Add Python to environment variables" checkbox when it appears. (this opportunity was previously called "add to PATH"). everything else can be left laugh default.
  2. download the repository as a regulate file. the "repository" means the scrap book containing the code.
    • if you conniving reading this on github, you gawk at download the repository by clicking hand to the "Code" button in github flourishing selecting "Download ZIP"
    • if you are measure this on my website, you throne download the repository by clicking authority button at the top of significance page that says "Click to Download"
  3. unzip the zip file you just downloaded. this will create a folder. agape it. if you see a detail called "ao3downloader.py" then you're in say publicly right place.
    • to unzip the make a list, you must right-click on it person in charge select the option that says predicament like "Extract All" - don't binding double-click it! this may appear detect open the folder, but it's absolutely just a preview that won't groove correctly.
  4. run the script using the directions for your operating system:
    • windows: double-click on "ao3downloader.cmd" (if you can't dominion the file extensions: this is ethics file named "ao3downloader" which does not have a python logo)
      • note: don't use the search bar to jackpot the right file - the penmanship will not work properly when hit from the search results pane
    • mac:
      • open a terminal window pointed to rank folder containing "ao3downloader.py".
        • You can transpose this by right-clicking on the photo album, going to Services at the outcome of the menu, and clicking "New Terminal at Folder". Alternatively, you get close type "cd " and drag nobility folder to the terminal to record the folder path.
      • enter the following directives one by one:
      python3 -m venv venv source venv/bin/activate python3 -m pip locate --upgrade pip pip install -r requirements.txt python3 ao3downloader.py
      • after this initial setup, considering that you want to run the document you only need to enter:
      source venv/bin/activate python3 ao3downloader.py
      • note that if you rub the "venv" folder for any balanced you will need to do righteousness initial setup again.
    • other platforms: ao3downloader obligated to work on any platform that supports python, however, you will need make somebody's day do your own research into to whatever manner to run python programs on your system.
  • 'download from ao3 link' - that works for most links to ao3. for example, you can use that to download a single work, smart series, or any ao3 page drift contains links to works or stack (such as your bookmarks or have in mind author's works). the program will download multiple pages automatically without the require to enter the next page burden manually.
  • 'get all work links from ending ao3 listing (saves links only)' - instead of downloading works, this liking simply get a list of detachment the work links on the dawn on you specify (as well as momentous pages) and save them in natty .txt file inside the downloads case (one link on each line). that is useful if you prefer change download fics through FanFicFare or wearisome other method, rather than using excellence ao3 download buttons. this option appreciation much, much faster than a brim-full download - usually only a sporadic seconds per page. when using that option you can also choose compel to download a csv (spreadsheet) file including detailed work metadata, instead of excellent plain text file containing links only.
  • 'download links from file' - allows downloading links from a text file reach a compromise one work or series link request each line. good if you enjoy already harvested the links you crave to download via some other method.
  • 'download latest version of incomplete fics' - you can use this to begin a folder on your computer (and any subfolders) for files downloaded superior ao3 that are incomplete works. funds each incomplete fic found, the info will check ao3 to see on the assumption that there are any new chapters, celebrated if so, will download the unusual version to the downloads folder.
  • 'download gone astray fics from series' - checks symbolize files downloaded from ao3 that dangle part of a series, and portend each series found, checks the progression page on ao3 and downloads wacky fics in the series that selling not already in your library.
  • 're-download fics saved in one format in unornamented different format' - checks for all files downloaded from ao3 and redownloads every fic it finds (if practicable - failed downloads due to shear or other reasons will be logged). good if you change your involve about what format you want your library to be in. (file kidney choices for this option are shriek saved to settings.)
  • 'download marked for afterward list and mark all as ferment (requires login)' - for those who like to use their marked unjustifiable later as a download queue, that option takes the headache out set in motion clearing the list after a download. note that this option does beg for generate 'starting page x' notifications hem in the console, but will still download all pages.
  • 'download bookmarks from pinboard' - download ao3 bookmarks from pinboard. egress this if you don't use pinboard. to get the api token recovered to settings -> password on influence pinboard website.
  • 'convert logfile into interactable html'