This release is a pre-release and may not be stable for production use.
castletool
Images, vector graphics, videos, audio. You name it, castletool (probably) supports it.
Castletool is a custom tool that lets you import things to castle more easily.
Installation
pip install castletool
Requires Python and the Castle CLI
Usage
Run castletool inside a folder containing your Castle deck(s).
You may also use castletool --cli for the legacy interface.
castletool --version (or -v) prints the installed version.
Capabilities
- Add image — bitmap images, animated GIF/WEBP/APNG, video (with sound), and SVG are all supported.
- Add MIDI — converts a MIDI file into a Castle
Musiccomponent. - Add Font — renders a font's characters as vectors.
- Edit Background Color — sets the card's background color.
- Upload Deck — strips whitespace from every JSON file in the deck, then runs
castle save-deck. - Settings — toggle options. Note length: Add MIDI splits notes into separate instruments by length (same length + same MIDI instrument share one).
Add Font: Basic
Choose from preset unicode ranges and select as many as you want:
- Standard (0-255, excluding control characters)
- ASCII
- Alphanumeric
- Numeric
- Currency Symbols
- Greek Characters
- Fraction Symbols
- Arrows
- Mathematical Operators
- Miscellaneous Technical
- Box Drawing
- Block Elements
- Dingbats
- Braille Patterns
- Musical Symbols
Add Font: Advanced
Choose all characters/codepoints yourself:
- Plain characters are typed as-is:
0123456789ABCDEF. - A specific codepoint is written
U+XXXX(hex):U+03A9is Ω. - Separate every codepoint with a space: Something like
U+03A9U+0021is invalid. - Any character or codepoint used twice is rejected.
Loading from a file uses the same rules, plus -- starts a comment that runs to the end of the line.
Star History
1 maintainer
Metadata
1 maintainer
Release files for castletool 0.5.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| castletool-0.5.0a1.tar.gz | 34.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| castletool-0.5.0a1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 69.0 kB
Release files / castletool-0.5.0a1.tar.gz
| Download URL | castletool-0.5.0a1.tar.gz |
|---|---|
| Size | 34.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
de9d4b51a100a8ffbb0ca159eda90bc7fbbe79cbe4c4a47246c0ff204b05a808
|
|
BLAKE2b-256 checksum How to use checksums |
f6b17ea455954f1ceeb3ae9aa6fd0776f65b25370bbb1c9fe668ae08e2316131
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / castletool-0.5.0a1-py3-none-any.whl
| Download URL | castletool-0.5.0a1-py3-none-any.whl |
|---|---|
| Size | 34.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
45d0f00e429d1a761951af9bb9b75e41cce918049921fc5c03227eccd7013c2b
|
|
BLAKE2b-256 checksum How to use checksums |
f16fb1372a7318772d5e42dbd664f0b1c550cb2168fd903aa21be3ab6a2b38a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency log
