Skip to main content

Shoggoth

Card creation software for Arkham Horror: The Card Game

Status

Under development. We're getting close to a 1.0.0 release though. Most things work, many advanced features has been implemented, and many nice-to-have's are coming together.

Shoggoth allows you to create homebrew cards for Arkham Horror: The Card Game. It features a sensible templating system with inheritance, that makes it easy to define new cards in very few rules.

Shoggoth has been translated into multiple languages by the community.

Installation:

The easiest way is to head to releases and grab the file for your system.

If you're on linux, or are comfortable around python, you can install Shoggoth as a python tool, using pipx install shoggoth (or uvx shoggoth if you use uv).

Security and false positives in virus detection Windows defender has on occasionally reported Shoggoth as being harmful. Shoggoth is not malware, but it does a lot of the same things as malware - it downloads files from the internet without asking you (asset files), unpacks them, and parse arbitrary files (projects/cards) on your system. All of this is intended and expected. That being said, Shoggoth is not reviewed for security, and you shouldn't try to run files from people you don't trust. I can't give you any guarantee that the standard python json module doesn't have some exploit that will allow someone take over your system. Most software can't make that guarantee.

Usage

Simply start Shoggothe. You'll be presented with an experience similar to other card designers, where the UI will help guide you along to create cards similar to official cards. If you installed Shoggoth via Python you can also use shoggoth as a cli tool. Run shoggoth --help for more information.

See also the documentation

Development

Application development

Install python and uv. Clone this repo. Then you should be good to go.

To run Shoggoth in dev mode:

uv run shoggoth

but I personally prefer to use jurigged

uv run jurigged ./shoggoth/tool.py

this will reload all non-UI changes on the fly, as you change them.

To build a standalone .app (macOS) or executable (Windows/Linux):

uv run pyinstaller ShoggothStandalone.spec

The built app will be in dist/Shoggoth.app (macOS) or dist/Shoggoth (Windows/Linux).

Asset development

(Changes to card layouts, font sizes, etc.)

While not technically this repo, the asset repo is best tested running Shoggoth. To avoid overwriting your local changes, place a .env file in the shoggoth directory or set them as environment variables.

SHOGGOTH_ASSET_DIR="/path/to/shoggoth_assets/"
SHOGGOTH_UNMANAGED_ASSETS=1

This will make it so Shoggoth doesn't try to download the newest updates automatically, and will point it towards your cloned asset repo, instead of using the default location for installed applications.

You can incentivise the further development of Shoggoth (and other AH:TCG software and content) by donating on Patreon or Ko-Fi.

Metadata

Release files for shoggoth 0.10.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for shoggoth 0.10.11
File Size Uploaded
shoggoth-0.10.11.tar.gz 4.6 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for shoggoth 0.10.11
File Interpreter ABI Platform
shoggoth-0.10.11-py3-none-any.whl Python 3 none any Details

Total release size: 5.2 MB

Release files / shoggoth-0.10.11.tar.gz

Download URL shoggoth-0.10.11.tar.gz
Size 4.6 MB
Tags Source
SHA-256 checksum
How to use checksums
5e0c5f38fe18707b285e3dcc83c6c27d675d95dd162d6ce9c7378faecff3187f
BLAKE2b-256 checksum
How to use checksums
fc3abede8d08c88bf12c16ab2907d62d1c9a97dc0d0ef93bca17a036c49e6ed8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.11

Release files / shoggoth-0.10.11-py3-none-any.whl

Download URL shoggoth-0.10.11-py3-none-any.whl
Size 581.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
43aa958c8881106fc6cf75cf0e2724afb9fa12e456862fbc87a8525d4d2f1b72
BLAKE2b-256 checksum
How to use checksums
33f8557b9219ae016f80e7c8ab61ad2a195cc7e544ec17c97cf144a557494f2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.11

Release history Release notifications | RSS feed

This release

0.10.11 This release

2 release files

0.10.7

2 release files

0.10.6

2 release files

0.10.5

2 release files

0.10.4

2 release files

0.10.3

2 release files

0.10.2

2 release files

0.10.1

2 release files

0.9.6

2 release files

0.9.5

2 release files

0.9.4

2 release files

0.9.3

2 release files

0.9.1

2 release files

0.8.13

2 release files

0.8.12

2 release files

0.8.9

2 release files

0.8.8

2 release files

0.8.7

2 release files

0.8.6

2 release files

0.8.5

2 release files

0.8.4

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.16

2 release files

0.7.14

2 release files

0.7.13

2 release files

0.7.12

2 release files

0.7.9

2 release files

0.7.8

2 release files

0.7.7

2 release files

0.7.6

2 release files

0.7.5

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.21

2 release files

0.5.19

2 release files

0.5.18

2 release files

0.5.17

2 release files

0.5.16

2 release files

0.5.15

2 release files

0.5.13

2 release files

0.5.9

2 release files

0.5.8

2 release files

0.5.7

2 release files

0.5.6

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.15

2 release files

0.4.12

2 release files

0.4.11

2 release files

0.4.10

2 release files

0.4.9

2 release files

0.4.8

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.0

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.1.9

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.30

2 release files

0.0.29

2 release files

0.0.28

2 release files

0.0.27

2 release files

0.0.26

2 release files

0.0.23

2 release files

0.0.22

2 release files

0.0.20

2 release files

0.0.19

2 release files

0.0.18

2 release files

0.0.16

2 release files

0.0.15

2 release files

0.0.14

2 release files

0.0.13

2 release files

0.0.12

2 release files

0.0.11

2 release files

0.0.10

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page