# 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"
}