Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hashhar/xkcd-scraper
A python script to download xkcd comics.
https://github.com/hashhar/xkcd-scraper
comics xkcd-comics xkcd-scraper
Last synced: 24 days ago
JSON representation
A python script to download xkcd comics.
- Host: GitHub
- URL: https://github.com/hashhar/xkcd-scraper
- Owner: hashhar
- License: mit
- Created: 2015-11-01T14:15:13.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2021-08-02T06:11:37.000Z (over 3 years ago)
- Last Synced: 2024-04-28T07:24:00.244Z (6 months ago)
- Topics: comics, xkcd-comics, xkcd-scraper
- Language: Python
- Size: 42 KB
- Stars: 2
- Watchers: 3
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# XKCD Scraper
Let's download all the XKCD comics and their titles! Why not use a browser plugin? Because you are a geek (or just want to look cool among your friends :satisfied:)!!!
# NOTICE
**I'm not using this project anymore so some things might be broken from time to time but please file an issue and we can work together to make it work again and resolve the issues.**
## Setup Instructions
Why are you even reading this (unless you are somebody new to Python)???
```bash
# Clone the repository
git clone https://github.com/hashhar/xkcd-scraper.git
# Install dependencies
pip3 install -r requirements.txt
# Run the program
python3 xkcd-scraper.py --your-arguments
```
You can also install this within a Python virtual environment like so:
```bash
# Create a virtual env
python3 -m venv venv
# Activate the virtual env
source venv/bin/activate
# Install dependencies within the virtual env
pip3 install -r requirements.txt
# Run the program
python3 xkcd-scraper.py --your-arguments
```
## Command Line Options
Unfortunately, you will need to provide command line parameters everytime you run the script (because I am a bad, bad man :smiling_imp:)
- **`-o`** *`directory`*, **`--output-dir`** *`directory`*
Changes the output directory to `directory`.
The default output directory is the current working directory.
- *`N`*
This will fetch the comic number `N` from xkcd where `N` is an **integer or a set of integers greater than or equal to 0**.
Use 0 to fetch the latest comic.
- **`-r`** *`M N`*, **`--range`** *`M N`*
Fetches comics within the range `M` to `N`.
`-r 3 30`, `--range 3 30` will fetch the comics from 3 to 30.
- **`-a`**, **`--all`**
Fetches all the comics from the first one to the latest.
- **`-x`** *`N`*, **`--random`** *`N`*
Fetches `N` pseudo-random (because, well, the world is not fair) comics. You can specify how many you want to fetch as -x 10, --random 30. This will fetch 30 random comics.
- **`-t`**, **`--title`**
Appends the title of the comic to the filename of the downloaded comic
## Comments
I am still working on it so feel free to contribute code and file issues and feature requests.
## Food For Thought
[Is there anything that is totally random? - StackExchange](http://philosophy.stackexchange.com/questions/2439/is-there-anything-that-is-totally-random)
[Randomness vs Unpredictability - Wikipedia](https://en.wikipedia.org/wiki/Randomness#Randomness_versus_unpredictability)
[Can we sure that randomeness exists? - Quora](https://www.quora.com/Can-we-be-sure-that-true-randomness-exists-Can-it-be-proven-that-anything-is-truly-random)