Data

Tools

Indexes

Applications

Experiments

Open Source Science

mobi

python based software to unpack kindlegen generated ebooks

https://github.com/iscc/mobi

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ○
    .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (14.3%) to scientific vocabulary

Keywords

kindle mobi text-extraction
Last synced: 6 months ago · JSON representation

Repository

python based software to unpack kindlegen generated ebooks

Basic Info
  • Host: GitHub
  • Owner: iscc
  • License: gpl-3.0
  • Language: Python
  • Default Branch: master
  • Size: 926 KB
Statistics
  • Stars: 64
  • Watchers: 1
  • Forks: 10
  • Open Issues: 0
  • Releases: 0
Topics
kindle mobi text-extraction
Created almost 6 years ago · Last pushed 6 months ago
Metadata Files
Readme Funding License

README.md

mobi - library for unpacking unencrypted mobi files

Version Downloads

A fork of KindleUnpack which removes the GUI part and makes it available as a python library via PyPi for easy unpacking of mobi files.

Installation

```bash

Using uv (recommended)

uv add mobi

Using pip

pip install mobi ```

Usage

As library

```python import mobi import tempfile import shutil

Extract the mobi file

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

Use the extracted file

with open(filepath, 'r') as f: content = f.read() # Process the content...

Clean up the temporary directory

shutil.rmtree(tempdir) ```

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

⚠️ Important: You are responsible for deleting the temporary directory after use to avoid filling up disk space.

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 --epubversion= 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) --epubversion= 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.4.0] - 2025-08-26

  • BREAKING: Drop Python 2 support, modernize codebase
  • BREAKING: Bump minimum Python version to 3.9
  • Replace deprecated imghdr module with standard-imghdr for Python 3.11+ compatibility
  • Update loguru dependency to v0.7+ for Python 3.11 support
  • Migrate build system from Poetry to uv/hatchling
  • Add Python 3.10 and 3.11 to CI testing
  • Add pre-commit hooks for code quality
  • Code formatting updates with latest black

[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

Owner

  • Name: ISCC Foundation
  • Login: iscc
  • Kind: organization
  • Email: info@iscc.foundation
  • Location: Netherlands

International Standard Content Code

GitHub Events

Total
  • Issues event: 3
  • Watch event: 7
  • Issue comment event: 5
  • Push event: 3
  • Pull request event: 2
Last Year
  • Issues event: 3
  • Watch event: 7
  • Issue comment event: 5
  • Push event: 3
  • Pull request event: 2

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 26
  • Total Committers: 3
  • Avg Commits per committer: 8.667
  • Development Distribution Score (DDS): 0.077
Past Year
  • Commits: 5
  • Committers: 1
  • Avg Commits per committer: 5.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Titusz Pan t****n@g****m 24
Ryan Delaney r****y@g****m 1
dm9pZCAq 4****q 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 12
  • Total pull requests: 4
  • Average time to close issues: 4 months
  • Average time to close pull requests: 10 days
  • Total issue authors: 11
  • Total pull request authors: 3
  • Average comments per issue: 0.67
  • Average comments per pull request: 0.75
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 2
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • YangMingJerry (2)
  • gerritzen (1)
  • titusz (1)
  • tjkuson (1)
  • julie777 (1)
  • 1over137 (1)
  • Lucidiot (1)
  • CyberTailor (1)
  • wustho (1)
  • WilliamSoCreat (1)
  • silum (1)
Pull Request Authors
  • BoboTiG (2)
  • rpdelaney (1)
  • dm9pZCAq (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 2,519 last-month
  • Total docker downloads: 43
  • Total dependent packages: 8
  • Total dependent repositories: 13
  • Total versions: 7
  • Total maintainers: 1
pypi.org: mobi

unpack unencrypted mobi files

  • Versions: 7
  • Dependent Packages: 8
  • Dependent Repositories: 13
  • Downloads: 2,519 Last month
  • Docker Downloads: 43
Rankings
Dependent packages count: 1.1%
Downloads: 3.8%
Dependent repos count: 4.0%
Average: 6.5%
Stargazers count: 9.6%
Forks count: 14.2%
Maintainers (1)
titusz
Last synced: 6 months ago

Dependencies

poetry.lock pypi
  • atomicwrites 1.4.0 develop
  • attrs 21.4.0 develop
  • black 22.1.0 develop
  • click 8.0.4 develop
  • importlib-metadata 4.11.2 develop
  • iniconfig 1.1.1 develop
  • mypy-extensions 0.4.3 develop
  • packaging 21.3 develop
  • pathspec 0.9.0 develop
  • platformdirs 2.5.1 develop
  • pluggy 1.0.0 develop
  • py 1.11.0 develop
  • pyparsing 3.0.7 develop
  • pytest 6.2.5 develop
  • toml 0.10.2 develop
  • tomli 2.0.1 develop
  • typed-ast 1.5.2 develop
  • typing-extensions 4.1.1 develop
  • zipp 3.7.0 develop
  • colorama 0.4.4
  • loguru 0.6.0
  • win32-setctime 1.1.0
pyproject.toml pypi
  • black ^22.1 develop
  • pytest <7.0 develop
  • loguru ^0.6
  • python >=3.7
.github/workflows/build.yml actions
  • Gr1N/setup-poetry v8 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite