{"id":16027017,"url":"https://github.com/alexpdev/ebookatty","last_synced_at":"2025-03-17T16:30:51.714Z","repository":{"id":39654413,"uuid":"347549989","full_name":"alexpdev/ebookatty","owner":"alexpdev","description":"Tools for extracting Metadata from EPUB MOBI and other kindle formats","archived":false,"fork":false,"pushed_at":"2024-06-17T04:13:05.000Z","size":55981,"stargazers_count":13,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-13T05:16:22.110Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexpdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-14T05:13:31.000Z","updated_at":"2025-01-03T09:33:48.000Z","dependencies_parsed_at":"2024-06-17T05:52:43.376Z","dependency_job_id":null,"html_url":"https://github.com/alexpdev/ebookatty","commit_stats":{"total_commits":48,"total_committers":1,"mean_commits":48.0,"dds":0.0,"last_synced_commit":"17e509283c8c70fc33ed56cd98c4866e2130cc4d"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpdev%2Febookatty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpdev%2Febookatty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpdev%2Febookatty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpdev%2Febookatty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexpdev","download_url":"https://codeload.github.com/alexpdev/ebookatty/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243871359,"owners_count":20361338,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-08T20:04:36.435Z","updated_at":"2025-03-17T16:30:47.920Z","avatar_url":"https://github.com/alexpdev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![EbookAtty](./ebookatty.png)\n\n# ebookatty\n\n![License](https://img.shields.io/badge/License-LGPL-blue?style=for-the-badge\u0026logo=appveyor)\n![Testing](https://img.shields.io/badge/Testing-Pytest-orange?style=for-the-badge\u0026logo=appveyor)\n![Python](https://img.shields.io/badge/Python-3.0%2B-red?style=for-the-badge\u0026logo=appveyor)\n\n-------------------------\n\nSimple utility that extracts embedded metadata in common ebook formats. Works on mobi epub and most amazon kindle filetypes.\nWorks as a CLI or can be used as a library. Usage details and examples provided below.\n\n## Features\n\n* Succesfully extracts metadata from .mobi .kfx .epub .azw .azw3 file formats\n* No external dependencies\n* Displays every bit of metadata information it finds and leaves out blh\n\n## Requirements\n\n* Python 3.3+\n* Tested on Windows and Linux\n\n## Installing\n\n```Linux\npip install ebookatty\n```\n\n## Instructions\n\nUsing as a command line interface is super easy:\n\n```Linux\nebookatty path/to/ebook.epub\n```\n\nor import into your project...\n\n```python\nfrom ebookatty import MetadataFetcher\n```\n\n## License / EULA\n\nGNU LGPL v3.0\n[LICENSE FILE](./LICENSE.md)\n\n## Usage\n\n### Example API Use\n\n__example 1__\n```py\n\u003e\u003e\u003e from pprint import pprint\n\u003e\u003e\u003e from ebookatty import fetch_metadata\n\u003e\u003e\u003e file_path = \"Romeo and Juliet - William Shakespeare.mobi\"\n\u003e\u003e\u003e data = fetch_metadata(file_path)\n\u003e\u003e\u003e pprint(data)\n{'author': 'William Shakespeare',\n 'codec': 'utf-8',\n 'codepage': '65001',\n 'contributor': 'calibre (0.7.23) [http://calibre-ebook.com]',\n 'description': 'SUMMARY: These violent delights have violent ends And in '\n                'their triumph die, like fire and powder, Which, as they kiss, '\n                'consume. When Romeo first lays eyes on the bewitching Juliet, '\n                \"it's love at first sight. But though their love runs true and \"\n                'deep, it is also completely forbidden. With family and fate '\n                'determined to keep them apart, will Romeo and Juliet find a '\n                \"way to be together? William Shakespeare's masterpiece is one \"\n                'of the most enduring stories of star-crossed love of all '\n                'time. Beautifully presented for a modern teen audience with '\n                'both the original play and a prose retelling of the beloved '\n                'story, this is the must-have edition of a timeless classic.',\n 'doctype': 'EXTH; MOBI',\n 'filetype': '.mobi',\n 'identity': 'BOOKMOBI',\n 'isbn': '9780061965494',\n 'langid': '9',\n 'name': 'Romeo and Juliet - William Shakespeare',\n 'published': '2009-08-15T07:00:00+00:00',\n 'publisher': 'HarperCollins',\n 'rights': 'NONE',\n 'subject': 'William; Renaissance; Vendetta; Juvenile Nonfiction; Historical; '\n            \"Children's Books; Man-woman relationships; Historical - \"\n            \"Renaissance; Love \u0026 Romance; Playscripts (Children's; Shakespeare \"\n            'plays; Shakespeare; Irish; 1564-1616; YA); General; Young Adult '\n            'Graphic Novels; Classics; Young Adult General Interest \u0026 Leisure; '\n            \"Children's Books - Young Adult Fiction; Welsh; Juliet (Fictitious \"\n            'character); Children: Young Adult (Gr. 7-9); Conflict of '\n            'generations; Verona (Italy); Romeo (Fictitious character); '\n            'Juvenile Fiction; Scottish; Drama; English',\n 'title': 'Romeo and Juliet',\n 'type': '2',\n 'unique_id': '1974853891',\n 'updatedtitle': 'Romeo and Juliet',\n 'version': '0; 6'}\n```\n\n### Example CLI Use\n\n__example 1__\n```bash\nebookatty /path/to/ebooks/*.epub\n```\n\n__example 2__\n```\nebookatty **/**/*.mobi\n```\n\n__example 3__\n```\nebookatty /path/to/specific/ebook.azw3\n```\n\n\n__example output__\n```\n---------------------------------------------------------------------------------------------------------------------------------------------\nTitle           A Philosophy of Software Design\nPublisher       Yaknyam Press, Palo Alto, CA\nCreator         John Ousterhout\nLanguage        en\nContributor     calibre (3.33.1) [https://calibre-ebook.com]\nDate            2019-01-22T08:00:00+00:00\nRights          Copyright 2018 John K. Ousterhout\nSubject         modular decomposition; interface vs. implementation; computer programming; abstraction; software design; software complexity\nIdentifier      B07N1XLQ7D; urn:uuid:19682118-2a9c-49ed-b1e9-1ceb58110b6f\n---------------------------------------------------------------------------------------------------------------------------------------------\n\n--------------------------------------------------------------------\nAuthor          Friedrich Wilhelm Nietzsche\nTitle           Beyond Good and Evil\nRights          Public domain in the USA.\nTags            Philosophy; Ethics; German\nPubdate         2003-08-01T04:00:00+00:00\nBook_Producer   calibre (4.17.0) [http://calibre-ebook.com]\nUuid            3f455008-90c8-40e8-8366-69b599b36a9a\nCodec           utf-8\nDoctype         MOBI; EXTH\nUnique_Id       1417459778\nIdentity        BOOKMOBI\nType            2\nVersion         6\nName            Beyond Good and Evil by Friedrich Wilhelm Nietzsche\n--------------------------------------------------------------------\n\n--------------------------------------------------------------\nTitle           The First Six Books of the Elements of Euclid\nCreator         John Casey; Euclid\nLanguage        en\nDate            2022-08-10T09:11:00.913013+00:00; 2007-04-14\nRights          Public domain in the USA.\nSubject         Mathematics, Greek; Euclid's Elements\nIdentifier      http://www.gutenberg.org/21076\n--------------------------------------------------------------\n\n----------------------------------------------------------------------------------------------------------------------------------------------------------\nAuthor          William Shakespeare\nTitle           Romeo and Juliet\nPublisher       HarperCollins\nRights          NONE\nIsbn            9780061965494\nPubdate         2009-08-15T07:00:00+00:00\nBook_Producer   calibre (0.7.23) [http://calibre-ebook.com]\nCodec           utf-8\nDoctype         MOBI; EXTH\nUnique_Id       1974853891\nIdentity        BOOKMOBI\nType            2\nVersion         6\nName            Romeo and Juliet - William Shakespeare\nTags            Renaissance; Shakespeare plays; Love \u0026 Romance; Classics; Welsh; Historical; Man-woman relationships; 1564-1616; Shakespeare;\n                Children's Books - Young Adult Fiction; Juliet (Fictitious character); Verona (Italy); Playscripts (Children's; Historical -\n                Renaissance; YA); Conflict of generations; English; Young Adult Graphic Novels; Drama; General; Children: Young Adult (Gr. 7-9);\n                Scottish; Juvenile Fiction; Irish; William; Children's Books; Romeo (Fictitious character); Vendetta; Young Adult General Interest \u0026\n                Leisure; Juvenile Nonfiction\nComments        SUMMARY: These violent delights have violent ends And in their triumph die, like fire and powder, Which, as they kiss, consume. When\n                Romeo first lays eyes on the bewitching Juliet, it's love at first sight. But though their love runs true and deep, it is also completely\n                forbidden. With family and fate determined to keep them apart, will Romeo and Juliet find a way to be together? William Shakespeare's\n                masterpiece is one of the most enduring stories of star-crossed love of all time. Beautifully presented for a modern teen audience with\n                both the original play and a prose retelling of the beloved story, this is the must-have edition of a timeless classic.\n----------------------------------------------------------------------------------------------------------------------------------------------------------\n\n-------------------------------------------------------------------------------------------------------------------------------------------------\nAuthor          Margaret Mitchell\nTitle           Gone with the wind\nPublisher       Avon Books\nTags            Unread; Fiction\nComments        SUMMARY:  The turbulent romance of Scarlett O'Hara and Rhett Butler is shaped by the ravages of the Civil War and Reconstruction\nIsbn            9780380001095\nPubdate         1973-10-14T22:00:00+00:00\nBook_Producer   calibre (0.8.46) [http://calibre-ebook.com]\nCodec           utf-8\nDoctype         MOBI; EXTH\nUnique_Id       2030054980\nIdentity        BOOKMOBI\nType            2\nVersion         6\n-------------------------------------------------------------------------------------------------------------------------------------------------\n\n-----------------------------------------------------------------------------------------------------------------------------------------------\nAuthor          Plato\nTitle           The Republic\nRights          Public domain in the USA.\nTags            Utopias -- Early works to 1800; Justice -- Early works to 1800; Classical literature; Political science -- Early works to 1800\nPubdate         1998-10-01T04:00:00+00:00\nBook_Producer   calibre (4.17.0) [http://calibre-ebook.com]\nUuid            7422f1b5-a40a-4579-8945-def5c386c88e\nCodec           utf-8\nDoctype         MOBI; EXTH\nUnique_Id       2377915433\nIdentity        BOOKMOBI\nType            2\nVersion         6\nName            The Republic - Plato\n-----------------------------------------------------------------------------------------------------------------------------------------------\n\n---------------------------------------------------------------------------------------------------------------------------\nAuthor          Unknown\nTitle           The Jargon File, Version 2.9.10, 01 Jul 1992\nRights          Public domain in the USA.\nTags            Computers -- Slang -- Dictionaries; Electronic data processing -- Terminology -- Humor; Computers -- Humor\nPubdate         1992-08-01T00:00:00+00:00\nBook_Producer   calibre (3.14.0) [https://calibre-ebook.com]\nUuid            fbd99707-2c14-44b9-99c3-09d444860816\nCodec           utf-8\nDoctype         MOBI; EXTH\nUnique_Id       2480398827\nIdentity        BOOKMOBI\nType            2\nVersion         8\nName            The-Hacker's-Dictionary\n---------------------------------------------------------------------------------------------------------------------------\n\n-----------------------------------------------------\nTitle           The Kama Sutra of Vatsayayana\nCreator         Unknown\nLanguage        en\nIdentifier      80e2d8c5-6ced-4337-9300-92ab5bd9d311\n-----------------------------------------------------\n\n------------------------------------------------------------\nTitle           The New Hacker\"s Dictionary\nPubdate         2017-12-25T18:05:35.914130+00:00\nBook_Producer   calibre (3.14.0) [http://calibre-ebook.com]\nUuid            2ea796bd-f62a-48b8-be48-83ae9606f757\nCodec           utf-8\nDoctype         MOBI; EXTH\nUnique_Id       2418361619\nIdentity        BOOKMOBI\nType            2\nVersion         8\nName            The-New-Hacker's-Dictionary\n------------------------------------------------------------\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpdev%2Febookatty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexpdev%2Febookatty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpdev%2Febookatty/lists"}