Darkseid
A Python library to interact with comic archives.
Installation
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.
-
pdf: Provides support for reading/writing metadata in PDF comics and exporting them to CBZ format.
The pymupdf dependency includes pre-built wheels for most platforms. On some platforms (e.g., Linux ARM, Windows), installation may require libstdc++ and C/C++ build tools to compile libmupdf. See the pymupdf documentation for details.
Example
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
Bugs/Requests
Please use the GitHub issue tracker to submit bugs or request features.
Metadata
Release files for darkseid 9.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| darkseid-9.0.0.tar.gz | 125.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| darkseid-9.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 225.8 kB
Release files / darkseid-9.0.0.tar.gz
| Download URL | darkseid-9.0.0.tar.gz |
|---|---|
| Size | 125.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b56093e59e1d49ba7816642dad4c1da1522da329838c59dcdad8b146c3b997a5
|
|
BLAKE2b-256 checksum How to use checksums |
a7c3b089485704e9da4a99085f48f6c9aed59ee628225c5695b8da465dbb3281
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / darkseid-9.0.0-py3-none-any.whl
| Download URL | darkseid-9.0.0-py3-none-any.whl |
|---|---|
| Size | 100.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4e56488eca7f2e867a9075dcb3b75d7f4e382a4f5065ec2dc23951f2074bf384
|
|
BLAKE2b-256 checksum How to use checksums |
06bc9c040b45e94784ed75323df36904b0230866864d0093a038524fda93c4bb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|