This is a tool to download and convert novels from popular sites to e-books.
Project description
NovelSave
This is a tool to download and convert novels from popular sites to e-books.
v0.7.+ is not compatible with previous versions
Install
pip install novelsave
or
pip install git+https://github.com/mensch272/novelsave.git
Usage
Basic
To download and package the novel in a single line use the following command:
novelsave process <id_or_url>
The most common commands you'll be using are:
update
The command requires the url of the id of the novel as an argument. When the novel has been identified it attempts to update the current novel information in the following steps:
- Download the novel webpage.
- Update the novel information. This includes title, author and pending chapters.
- Identify the chapters with no content and download and update them.
- Download any assets that require to be downloaded (assets are identified during chapter download).
Note that, if url is provided and the novel does not already exist in the database, a new novel entry will be created.
For more information, run
novelsave update --help
package
The command requires the url of the id of the novel as an argument. When novel is identified compiles the downloaded content into the specified formats.
Specify a compilation target using the --target
option. If option is not provided
compiles to only epub.
Or you may use --target-all
to package to all supported formats.
novelsave package <id_or_url> --target epub --target web
Supported compilation targets:
epub
html
|web
mobi
pdf
azw3
For more information, run
novelsave package --help
process
The command requires the url of the id of the novel as an argument. This is a combination of the above two commands, update
and package
.
This is a command of convenience, to update and package in a single command.
For more information, run
novelsave process --help
Configurations
Novel Directory
You can change your desired novels package's saving location using the following command. Novels are by default saved to folder novels
in user home.
novelsave config novel_dir set <dir>
And to reset to default, use the command shown below.
novelsave config novel_dir reset
For more information, run
novelsave config novel_dir --help
More
To find more information, use option --help
on groups and commands.
novelsave --help
novelsave novel --help
Cookies
Want to access authentication protected content, use browser cookies.
Browser cookies
This is an optional feature where you may use cookies from your browsers when sending requests. This effectively allows the script to pretend as the browser and thus allowing access to any content the browser would also be able to access.
You can use this in the following simple steps:
- Login to your source of choice with your browser of choice (though make sure the browser is supported).
- Use option
--browser <browser>
when updating novel (also available in process).
novelsave [update|process] <id_or_url> --browser <browser>
Supported
chrome
firefox
chromium
opera
edge
Sources
Sources have been moved to its own package. You can install and upgrade sources using the following command.
pip install novelsave-sources --upgrade
Disclaimer
We are not affiliated, associated, authorized, endorsed by, or in any way officially connected with the any of the sources mentioned above.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for novelsave-0.7.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7a9af4e2eb3b0ebba8d5f4c26ec8f11bf5cf509d9dbb2609bf6968f00544b78f |
|
MD5 | 66cc14edcf288120038846bac6d2ddac |
|
BLAKE2b-256 | ed4554aad90fb3a8a884a0eb77d08b011bc7f418c1b8c6848af653096e976a4e |