Image generated with the use of DALL·E
This is a flask app to generate EPUB files for J-Novel Club pre-pub novels by providing an interface to jncep.
I find myself using this when a new prepub drops, as I prefer to read on an e-reader, but I may not able to access a computer immediately after the prepub part comes out.
If this app is running on a server, you can download pre-pubs to your phone then copy them to your e-reader with a USB OTG cable.
This tool only works with J-Novel Club novels, not manga.
jncep_webui is completely unaffiliated with J-Novel Club and jncep.
If you have an issue with the tool, please file a bug report on this project, not jncep.
To get a local copy up and running there are two options, native or docker.
- J-Novel Club account and membership
- Set the following environment variables:
| Name | Required | Description |
|---|---|---|
JNCEP_EMAIL |
Yes | Login email for J-Novel Club account |
JNCEP_PASSWORD |
Yes | Login password for J-Novel Club account |
JNCEP_OUTPUT |
No | Folder to save the generated files before sending Default: /output |
- Install Python 3 (tested with 3.10)
- Clone the repo
git clone https://github.com/NaruZosa/jncep_webui.git
- Install python requirements with
python -m pip install requirements.txt - Installation complete. Run
app.py.
- Install the naruzosa/jncep_webui docker container
- A docker-compose.yml is provided in this project for your convenience.
- It is strongly recommended (but not required) to mount the container path
/logs.- Logs will automatically be compressed once they reach 50MB, and old logs will be deleted once they are a week old, when a new message is logged.
- Installation completed, start the container
This uses jncep to create the epub. If you want to know more about how the part specification works, check out the documentation for it here.
Once started, jncep_webui will be available at port 5000.
This page has two fields for input:
| Name | Required | Description |
|---|---|---|
| J-Novel Club URL | Yes | The J-Novel Club URL for the series, volume or part |
| Prepub parts | No | Range of parts to download in the form of [.part]:[.part] Default: All content linked to J-Novel Club URL] |
Once the J-Novel Club URL, and (optionally) the Prepub parts field have been filled, click submit to generate your epub.
If the parts go over one volume, each volume will have its own epub, and these will be added to a zip.
Once the epub or zip has been generated, this will be served to the user. The process of generating and sending the epub usually takes a few seconds.
Following the same rules as As an application above, it is possible to use jncep_webui as a web API by sending either a GET or POST request to ip-address:5000/epub on the host machine, with the following request headers:
| Name | Required | Description |
|---|---|---|
jnovelclub_url |
Yes | Maps to J-Novel Club URL above |
prepub_parts |
No | Maps to Prepub parts above |
JNCEP_EMAIL |
No | Overrides JNCEP_EMAIL environment variable |
JNCEP_PASSWORD |
No | Overrides JNCEP_PASSWORD environment variable |
Examples:
- With parts specified:
- Grab all parts
Once received, the app will process your request and respond with your epub/zip.
- Create documentation
- Push the Docker image to Docker Hub
- Automatically build and push docker image with GitHub Actions
- Create an Unraid Community Applications template with the Docker image
- Provide as an installable program (using PyInstaller and Inno Setup)
See the open issues for a full list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
jncep_webui is distributed under the GNU General Public License (GPL) version 3. See LICENSE.txt for more information.
Project Link: https://github.com/NaruZosa/jncep_webui
This would not have been possible without the hard work of gvellut in creating jncep, which does all the heavy lifting, thank you!
Thank you to Delgan for Loguru, it made logging dead-simple
Thank you to othneildrew for the readme.md template
And a final thank you to J-Novel Club for your translations and public API!