Skip to main content

Archidekt to TableTop export cli

Project description

archiTop

Archidekt to TableTop export cli

This project aims to smoothen the export process from a constructed Magic the Gathering card deck in Archidekt to the game TableTop Simulator.

Motivation

Currently, third third party tools do exist to aid with this process, but these are neither smooth to use nor do they fulfill all the features that would smoothen the magic experience.

The two most noteworthy alternatives are:

  1. Frogtown

    • Doesn't allow to import directly from tabletop, requiring user to export and import
    • Doesn't keep track of the card versions used in the deck (basic lands will update to the most recent)
    • Usage is slow, two step process required to generate and download deck
    • Doesn't separate commander cards from main deck
  2. Tabletop scryfall importer

    • Unexpected behaviour when multiple people import at the same time
    • Doesn't include tokens in the exported deck
    • Doesn't separate commander cards from main deck

What does this tool do?

This tool converts an Archidekt deck into Tabletop Simulator json format, able to be imported onto any tabletop board. The cards contained, deck-name and thumbnail will be extracted for given Archidekt deck-id.

Installation

The package is being hosted in PyPy, install using pip install architop

Usage

The tool is used via the commandline, runnable with architop <deckID>

Additional usage information can be acquired via the help command architop -h

Example Usage

Let's take one of my decks as example. Exporting the deck https://archidekt.com/decks/94674#Maximum_Borkdrive is as simple as copying the deck-id 94674.

By running the tool with the given deck-id:
archiDekt 94674, archiTop will export the deck as TableTop Simulator compatible file, alongside the thumbnail used for the deck in Archidekt.

Both files created will be named accordingly to the deck name in Archidekt: Output Example

Now all that's left to do is to move the two files into the TableTop Objects folder. The directory can vary for your Tabletop installation, based on OS.

You can find the path via the Tabletop Simulator game configurations: Tabletop Objects

Use of altered cards

You can optionally configure the tool to load alternate art versions of cards, by executing architop with the -a option:
architop <deckId> -a <path to .json file>

The altered art json file, follows the format below:

example_altered_cards.json
{
  "Pyroblast": "https://architop-altered.s3.eu-west-2.amazonaws.com/Pyroblast.png",
  "Red Elemental Blast": "https://architop-altered.s3.eu-west-2.amazonaws.com/Red+Elemental+Blast.png",
  "Aetherflux Reservoir": "https://architop-altered.s3.eu-west-2.amazonaws.com/Aetherflux+Reservoir.png",
  "Chaos Warp": "https://architop-altered.s3.eu-west-2.amazonaws.com/Chaos+Warp.png",
  "Dockside Extortionist": "https://architop-altered.s3.eu-west-2.amazonaws.com/Dockside+Extortionist.png",
  "Sol Ring": "https://architop-altered.s3.eu-west-2.amazonaws.com/Sol+Ring.png"
}

Have fun playing 🎉

Roadmap

The current plans for the repository are being tracked via github issues.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ArchiTop-0.3.1.tar.gz (13.4 kB view details)

Uploaded Source

Built Distribution

ArchiTop-0.3.1-py3-none-any.whl (20.6 kB view details)

Uploaded Python 3

File details

Details for the file ArchiTop-0.3.1.tar.gz.

File metadata

  • Download URL: ArchiTop-0.3.1.tar.gz
  • Upload date:
  • Size: 13.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.50.0 CPython/3.8.7

File hashes

Hashes for ArchiTop-0.3.1.tar.gz
Algorithm Hash digest
SHA256 19cc5d95ffbd49b66de362a5fd85d3045eba46880566770b480cffdebee145f9
MD5 846008484982c2cee70c90f648a21aaf
BLAKE2b-256 7d6936a81728537e92c6474e7c2cc1fb6a2b2107b02fdd4e4e01880fa35c3526

See more details on using hashes here.

File details

Details for the file ArchiTop-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: ArchiTop-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 20.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.50.0 CPython/3.8.7

File hashes

Hashes for ArchiTop-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d8a13e54569682381561cf4e1cd1aedcdbf0acfe9282b817f99fe832edcc728b
MD5 9d2ac435f0ee54212c5180fa35131e90
BLAKE2b-256 77edcdd133bbe6273fd94a26eabcf9086336fbf590eb1eb07d44c665c126c6d3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page