mobi


Namemobi JSON
Version 0.3.3 PyPI version JSON
download
home_pagehttps://github.com/iscc/mobi
Summaryunpack unencrypted mobi files
upload_time2022-03-03 12:03:55
maintainer
docs_urlNone
authorTitusz Pan
requires_python>=3.7
licenseGPL-3.0-only
keywords mobi mobipocket unpack extract text
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # mobi - library for unpacking unencrypted mobi files

[![Version](https://img.shields.io/pypi/v/mobi.svg)](https://pypi.python.org/pypi/mobi/)
[![Downloads](https://pepy.tech/badge/mobi)](https://pepy.tech/project/mobi)

> A fork of [KindleUnpack](https://github.com/kevinhendricks/KindleUnpack) which removes the GUI part and makes it available as a python library via [PyPi](https://pypi.org/project/mobi/) for easy unpacking of mobi files.

## Usage

### As library

```python
import mobi

tempdir, filepath = mobi.extract("mybook.mobi")
```

'tempdir' is the path where the mobi is unpacked
'filepath' is the path to either an epub, html or pdf file depending on the mobi type 

| NOTE: You are responsible to delete the generated tempdir! |
| --- |

### From the command line

The installer also creates a console script entrypoint that wraps the original KindleUnpack

```console
$ mobiunpack
KindleUnpack v0.82
   Based on initial mobipocket version Copyright © 2009 Charles M. Hannum <root@ihack.net>
   Extensive Extensions and Improvements Copyright © 2009-2014
       by:  P. Durrant, K. Hendricks, S. Siebert, fandrieu, DiapDealer, nickredding, tkeo.
   This program is free software: you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation, version 3.

Description:
  Unpacks an unencrypted Kindle/MobiPocket ebook to html and images
  or an unencrypted Kindle/Print Replica ebook to PDF and images
  into the specified output folder.
Usage:
  mobiunpack -r -s -p apnxfile -d -h --epub_version= infile [outdir]
Options:
    -h                 print this help message
    -i                 use HD Images, if present, to overwrite reduced resolution images
    -s                 split combination mobis into mobi7 and mobi8 ebooks
    -p APNXFILE        path to an .apnx file associated with the azw3 input (optional)
    --epub_version=    specify epub version to unpack to: 2, 3, A (for automatic) or
                         F (force to fit to epub2 definitions), default is 2
    -d                 dump headers and other info to output and extra files
    -r                 write raw data to the output folder
```

### [0.3.3] - 2022-03-03
- Add GitHub build workfow
- Updated dependencies
- Rmoved python 3.6 support (EOL)

### [0.3.2] - 2021-10-14
- Update dependencies

### [0.3.1] - 2020-06-27
- Fix pypi link
- Update dependencies

### [0.3.0] - 2020-03-02

- Add support for mobi7 only files
- Add experimental support for mobi print replica files
- Add support for file-like objects


### [0.2.0] - 2020-03-02

- Minimal working 'extract' function and 'mobiunpack' console wrapper
- Replace most print calls with logging

### [0.1.0] - 2020-03-02

- Empty package registered on pypi

## License

GPL-3.0-only

All credits for the hard work go to https://github.com/kevinhendricks/KindleUnpack

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/iscc/mobi",
    "name": "mobi",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "mobi,mobipocket,unpack,extract,text",
    "author": "Titusz Pan",
    "author_email": "tp@py7.de",
    "download_url": "https://files.pythonhosted.org/packages/9a/a3/598cbedb115c555c34a5fa3172bc5a300ef9005485dda294fece76023beb/mobi-0.3.3.tar.gz",
    "platform": "",
    "description": "# mobi - library for unpacking unencrypted mobi files\n\n[![Version](https://img.shields.io/pypi/v/mobi.svg)](https://pypi.python.org/pypi/mobi/)\n[![Downloads](https://pepy.tech/badge/mobi)](https://pepy.tech/project/mobi)\n\n> A fork of [KindleUnpack](https://github.com/kevinhendricks/KindleUnpack) which removes the GUI part and makes it available as a python library via [PyPi](https://pypi.org/project/mobi/) for easy unpacking of mobi files.\n\n## Usage\n\n### As library\n\n```python\nimport mobi\n\ntempdir, filepath = mobi.extract(\"mybook.mobi\")\n```\n\n'tempdir' is the path where the mobi is unpacked\n'filepath' is the path to either an epub, html or pdf file depending on the mobi type \n\n| NOTE: You are responsible to delete the generated tempdir! |\n| --- |\n\n### From the command line\n\nThe installer also creates a console script entrypoint that wraps the original KindleUnpack\n\n```console\n$ mobiunpack\nKindleUnpack v0.82\n   Based on initial mobipocket version Copyright \u00a9 2009 Charles M. Hannum <root@ihack.net>\n   Extensive Extensions and Improvements Copyright \u00a9 2009-2014\n       by:  P. Durrant, K. Hendricks, S. Siebert, fandrieu, DiapDealer, nickredding, tkeo.\n   This program is free software: you can redistribute it and/or modify\n   it under the terms of the GNU General Public License as published by\n   the Free Software Foundation, version 3.\n\nDescription:\n  Unpacks an unencrypted Kindle/MobiPocket ebook to html and images\n  or an unencrypted Kindle/Print Replica ebook to PDF and images\n  into the specified output folder.\nUsage:\n  mobiunpack -r -s -p apnxfile -d -h --epub_version= infile [outdir]\nOptions:\n    -h                 print this help message\n    -i                 use HD Images, if present, to overwrite reduced resolution images\n    -s                 split combination mobis into mobi7 and mobi8 ebooks\n    -p APNXFILE        path to an .apnx file associated with the azw3 input (optional)\n    --epub_version=    specify epub version to unpack to: 2, 3, A (for automatic) or\n                         F (force to fit to epub2 definitions), default is 2\n    -d                 dump headers and other info to output and extra files\n    -r                 write raw data to the output folder\n```\n\n### [0.3.3] - 2022-03-03\n- Add GitHub build workfow\n- Updated dependencies\n- Rmoved python 3.6 support (EOL)\n\n### [0.3.2] - 2021-10-14\n- Update dependencies\n\n### [0.3.1] - 2020-06-27\n- Fix pypi link\n- Update dependencies\n\n### [0.3.0] - 2020-03-02\n\n- Add support for mobi7 only files\n- Add experimental support for mobi print replica files\n- Add support for file-like objects\n\n\n### [0.2.0] - 2020-03-02\n\n- Minimal working 'extract' function and 'mobiunpack' console wrapper\n- Replace most print calls with logging\n\n### [0.1.0] - 2020-03-02\n\n- Empty package registered on pypi\n\n## License\n\nGPL-3.0-only\n\nAll credits for the hard work go to https://github.com/kevinhendricks/KindleUnpack\n",
    "bugtrack_url": null,
    "license": "GPL-3.0-only",
    "summary": "unpack unencrypted mobi files",
    "version": "0.3.3",
    "split_keywords": [
        "mobi",
        "mobipocket",
        "unpack",
        "extract",
        "text"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "6e72c67639c5b29a72a5549cbcea14bd",
                "sha256": "919f60c3834c5885012210afc84a03a457fb8e58587037060a095b63ac832524"
            },
            "downloads": -1,
            "filename": "mobi-0.3.3.tar.gz",
            "has_sig": false,
            "md5_digest": "6e72c67639c5b29a72a5549cbcea14bd",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 90864,
            "upload_time": "2022-03-03T12:03:55",
            "upload_time_iso_8601": "2022-03-03T12:03:55.051857Z",
            "url": "https://files.pythonhosted.org/packages/9a/a3/598cbedb115c555c34a5fa3172bc5a300ef9005485dda294fece76023beb/mobi-0.3.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-03-03 12:03:55",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "iscc",
    "github_project": "mobi",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "mobi"
}
        
Elapsed time: 0.01814s