Convert a print-and-play PDF deck into individual card images.
Import extracted cards into PlayingCards.io or Tabletop Simulator.
Batch process or automate card extraction using the command line tool.
| gwydione/cardlift | 0xallam/my-recipe | 0xhassaan/nn-from-scratch | |
|---|---|---|---|
| Stars | 0 | — | 0 |
| Language | Python | Python | Python |
| Last pushed | — | 2022-11-22 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 2/5 | 2/5 | 4/5 |
| Audience | general | general | developer |
Figures from each repo's GitHub metadata at analysis time.
Alpha software for Windows, running from source needs Python 3.10+ and GUI dependencies installed.
CardLift is a Windows desktop tool that turns a print and play PDF, the kind of file that lays out a card deck's fronts and backs on a page for home printing, into individual card image files. Those images can then be imported into virtual tabletop platforms like PlayingCards.io or Tabletop Simulator so the deck can be played digitally instead of printed. The tool is currently a Windows alpha release, actively being developed, but the core workflow of opening a PDF, calibrating its card grid, reviewing the results, and exporting images is complete and has been tested by hand against real decks. Alpha testers are meant to download the packaged Windows release rather than run the code directly, while the setup instructions in the README are aimed at developers who want to run it from source using Python 3.10 or newer. CardLift walks a user through six steps: opening a PDF, marking which pages contain card fronts and which contain a shared back design, calibrating the front grid by clicking two corners of a single card, calibrating the back the same way if there is one, reviewing thumbnails of every detected card before anything is saved, and finally exporting each card as its own PNG image file. Calibration is done manually on purpose, since print and play PDFs vary a lot in their margins and layout, and an automatic guess could silently produce bad crops. If a click could reasonably mean more than one grid size, the tool asks the user to confirm rather than guessing. The same processing engine that powers the graphical interface is also available as a command line tool, useful for batch processing or automation without opening the app window. The project is licensed under the GNU AGPLv3, with a separate document explaining in plain language what that license means, and includes documentation covering its privacy practices, design decisions, and developer setup. This tool is aimed at tabletop gamers and hobbyists who print and play card games and want an easier way to bring physical print and play decks into virtual tabletop software.
A Windows alpha tool that converts print-and-play card deck PDFs into individual card images for virtual tabletop platforms.
Mainly Python. The stack also includes Python, Windows.
Licensed under the GNU AGPLv3, a copyleft license, with a separate document explaining what it means in plain terms.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.