kindle-periodical (beta)

This is a fork from vncprado/kindle-periodical for Python 2.

kindle-periodical (kp3) is a util in Python 3 for generating kindle .mobi files in periodical style. The script require KindleGen software in 'kindle/bin' folder. KindleGen is a software develop by Amazon. For download, go to KindleGen page.

You can run a simple test with just:

pip install .

---

# For HTML content use json.dumps() method.
import json
from kp3 import Periodical

metadata = {
    "title": "KindlePeriodical Title",
    "creator": "Creator Name",
    "publisher": "Publisher Name",
    "subject": "KindlePeriodical",
    "description": "Set of news articles in one .mobi file",
    # after make .mobi periodical, the filename will be: Periodical_yyyy-mm-dd
    "filename": "KindlePeriodical"
}

content = [
    {
        "title": "Subscription title 1",
        "items": [
            {
                # Optional.
                "author": "Author Name",
                # Unix timestamp.
                "published": 1507343103,
                # For HTML, use json.dumps() encoding.
                "content": "<b>Insert HTML here.</b>",
                "title": "Content Title 1"
            },
            {
                "author": "Author Name",
                "published": 1507343103,
                "content": "<b>Insert HTML here.</b>",
                "title": "Content Title 2"
            },
            {
                "author": "Author Name",
                "published": 1507343103,
                "content": "<b>Insert HTML here.</b>",
                "title": "Content Title 3"
            }
        ]
    },
    {

        "title": "Another subscription title 1",
        "items": [
            {
                "author": "Author Name",
                "published": 1507343103,
                "content": "<b>Insert HTML here.</b>",
                "title": "Another content title 1"
            },
            {
                "author": "Author Name",
                "published": 1507343103,
                "content": "<b>Insert HTML here.</b>",
                "title": "Another content title 2"
            },
            {
                "author": "Author Name",
                "published": 1507343103,
                "content": "<b>Insert HTML here.</b>",
                "title": "Another content title 3"
            }
        ]
    }
]

per = Periodical()

# Optional, default use cover.jpg in kindle-periodiacal/kindle/images folder
per.IMAGE_COVER = 'FULLPATH/filename.jpg'

# Optional, default use masthead.jpg in kindle-periodiacal/kindle/images folder
per.IMAGE_MASTHEAD = 'FULLPATH/filename.jpg'

# Optional, default ~/temp folder
per.BOOK_DIR_TEMP = 'FULLPATH'

# Example: /bin
per.KINDLEGEN_PATH = 'FULLPATH'

per.set_metadata(metadata)
per.set_content(content)

# make .mobi periodical and return the full path file
print(per.make_periodical())

---

Note: For better results, use the old KindleGen 1.1 (search on internet):

This is a periodical generated with the current (2017-07-01) KindleGen 2.9:

TODO

• Testing for Windows and GNU-Linux machines.