Skip to main content

Simple command-line tool to generate EPUB files for J-Novel Club pre-pub novels

Project description

jncep

Simple tool to generate EPUB files for J-Novel Club pre-pub novels

Install

The tool is compatible with Python 3.6+.

To install, launch :

pip install jncep

Usage

The jncep tool must be launched on the command-line.

Example

The following command will create a single EPUB file with Parts 5 to 10 of Volume 1 of the 'Tearmoon Empire' novel (as long as the pre-pubs have not expired):

jncep --email "user@example.com" --password "foo%bar666!" --parts 1.5:1.10 https://j-novel.club/c/tearmoon-empire-volume-1-part-1

Account credentials must be passed, as well as a URL link to a part or volume or series on the J-Novel Club website. Optionnally, a range of parts / volumes can be specified, in which case the URL simply indicates the series (even if it links to a part or volume). If no range is specified, whatever the URL links to is downloaded (single part or whole volume or whole series).

The tool will then communicate with the J-Novel Club API using the permissions of the specified account and download the requested texts and images.

Optionnally, the JNCEP_EMAIL and JNCEP_PASSWORD env vars can be set instead of passing the --email and --password arguments when launching the tool.

Help

To get some help about the arguments, just launch with the --help option:

~$ jncep --help
Usage: jncep.py [OPTIONS] JNOVEL_CLUB_URL

  Generate EPUB files for the J-Novel Club pre-pubs

Options:
  -l, --email TEXT     Login email for J-Novel Club account  [required]
  -p, --password TEXT  Login password for J-Novel Club account  [required]
  -o, --output PATH    Output EPUB file or folder (must exist)
  -s, --parts TEXT     Specification of a range of parts to download in the
                       shape of <vol>[.part]:<vol>[.part]
  -a, --absolute       Indicates that the --parts option specifies part
                       numbers globally, instead of relative to a volume i.e.
                       <part>:<part>
  --help               Show this message and exit.

Limitations

This tool only works with the J-Novel novels, not manga.

Issues

Report issues at https://github.com/gvellut/jncep/issues

TODO (maybe)

  • split EPUBs by volume
  • self-contained executable for macOS and Windows with PyInstaller
  • config file for account
  • keep track of past downloads for a series and automatically download new parts

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jncep-0.2.tar.gz (10.0 kB view hashes)

Uploaded Source

Built Distribution

jncep-0.2-py3-none-any.whl (12.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page