# Darkseid
[](https://pypi.org/project/darkseid/)
[](https://pypi.org/project/darkseid/)
[](https://github.com/charliermarsh/ruff)
[](https://github.com/pre-commit/pre-commit)
A [Python](https://www.python.org/) library to interact with comic archives.
## Installation
```bash
pip install darkseid
```
There are optional dependencies which can be installed by specifying one or more
of them in braces e.g. darkseid[7zip]
The optional dependencies are:
- **7zip**: Provides support for reading/writing to CB7 files.
- **pillow**: Provides support for getting page information that is used with
ComicInfo.xml metadata.
## Example
```python
from pathlib import Path
from darkseid.comic import Comic, MetadataFormat
comic = Comic(Path("my_comic.cbz"))
# Check if it's a valid comic
if comic.is_valid_comic():
print(f"Comic '{comic.name}' has {comic.get_number_of_pages()} pages")
# Read metadata
if comic.has_metadata(MetadataFormat.COMIC_INFO):
metadata = comic.read_metadata(MetadataFormat.COMIC_INFO)
print(f"Series: {metadata.series.name}")
# Get a page
page_data = comic.get_page(0) # First page
if page_data:
with open("cover.jpg", "wb") as f:
f.write(page_data)
```
## Documentation
[Read the project documentation](https://darkseid.readthedocs.io/en/stable/?badge=latest)
## Bugs/Requests
Please use the
[GitHub issue tracker](https://github.com/Metron-Project/darkseid/issues) to
submit bugs or request features.
Raw data
{
"_id": null,
"home_page": null,
"name": "darkseid",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Brian Pepple <bpepple@metron.cloud>",
"keywords": "cb7, cbr, cbt, cbz, comic, comicinfo, metadata, metroninfo",
"author": null,
"author_email": "Brian Pepple <bpepple@metron.cloud>",
"download_url": "https://files.pythonhosted.org/packages/c7/3b/6cadb249ec30aca2bde8d7bea5bb83fab3109e04c2d64db22032bef7f56d/darkseid-7.1.0.tar.gz",
"platform": null,
"description": "# Darkseid\n\n[](https://pypi.org/project/darkseid/)\n[](https://pypi.org/project/darkseid/)\n[](https://github.com/charliermarsh/ruff)\n[](https://github.com/pre-commit/pre-commit)\n\nA [Python](https://www.python.org/) library to interact with comic archives.\n\n## Installation\n\n```bash\npip install darkseid\n```\n\nThere are optional dependencies which can be installed by specifying one or more\nof them in braces e.g. darkseid[7zip]\n\nThe optional dependencies are:\n\n- **7zip**: Provides support for reading/writing to CB7 files.\n- **pillow**: Provides support for getting page information that is used with\n ComicInfo.xml metadata.\n\n## Example\n\n```python\nfrom pathlib import Path\nfrom darkseid.comic import Comic, MetadataFormat\n\ncomic = Comic(Path(\"my_comic.cbz\"))\n\n# Check if it's a valid comic\nif comic.is_valid_comic():\n print(f\"Comic '{comic.name}' has {comic.get_number_of_pages()} pages\")\n\n# Read metadata\nif comic.has_metadata(MetadataFormat.COMIC_INFO):\n metadata = comic.read_metadata(MetadataFormat.COMIC_INFO)\n print(f\"Series: {metadata.series.name}\")\n\n# Get a page\npage_data = comic.get_page(0) # First page\nif page_data:\n with open(\"cover.jpg\", \"wb\") as f:\n f.write(page_data)\n```\n\n## Documentation\n\n[Read the project documentation](https://darkseid.readthedocs.io/en/stable/?badge=latest)\n\n## Bugs/Requests\n\nPlease use the\n[GitHub issue tracker](https://github.com/Metron-Project/darkseid/issues) to\nsubmit bugs or request features.\n",
"bugtrack_url": null,
"license": null,
"summary": "A library to interact with comic archives",
"version": "7.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/Metron-Project/darkseid/issues",
"Homepage": "https://github.com/Metron-Project/darkseid"
},
"split_keywords": [
"cb7",
" cbr",
" cbt",
" cbz",
" comic",
" comicinfo",
" metadata",
" metroninfo"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "82dca97a2fbaeb861f314a11333db352c80aa41f7ea23504a0df8731eb9d3f15",
"md5": "aa60c951741ea9e229fcd1be360a73f0",
"sha256": "15a8f4644d3f62c3a42e0bc39ddb7269f4fc37763b52a347fe4177debe64b243"
},
"downloads": -1,
"filename": "darkseid-7.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aa60c951741ea9e229fcd1be360a73f0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 91604,
"upload_time": "2025-08-10T15:04:27",
"upload_time_iso_8601": "2025-08-10T15:04:27.229482Z",
"url": "https://files.pythonhosted.org/packages/82/dc/a97a2fbaeb861f314a11333db352c80aa41f7ea23504a0df8731eb9d3f15/darkseid-7.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c73b6cadb249ec30aca2bde8d7bea5bb83fab3109e04c2d64db22032bef7f56d",
"md5": "16fc69fb14268390d11e815095057a53",
"sha256": "883c90f399d027f8fd0f7c57029e697f906704d70eb8a54338834736c2d4fdbd"
},
"downloads": -1,
"filename": "darkseid-7.1.0.tar.gz",
"has_sig": false,
"md5_digest": "16fc69fb14268390d11e815095057a53",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 110568,
"upload_time": "2025-08-10T15:04:28",
"upload_time_iso_8601": "2025-08-10T15:04:28.734825Z",
"url": "https://files.pythonhosted.org/packages/c7/3b/6cadb249ec30aca2bde8d7bea5bb83fab3109e04c2d64db22032bef7f56d/darkseid-7.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-10 15:04:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Metron-Project",
"github_project": "darkseid",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "darkseid"
}