Skip to content

Latest commit

 

History

History

mtg-labels

README.md

Magic The Gathering - Cards Label generator

Docker Maintainer Website mtglabels.wogon.cz

1. Description

Available Label Examples:

Small Label (Default) - Common Small Label (Default) - Uncommon Small Label (Default) - Mountain + Rare
Small Label (No-date) - Common Small Label (No-date) - Forest + Uncommon Small Label (No-date) - Swamp + Mythic
Large Label (Default) - Common Large Label (Switched) - Rare Large Label (Switched) - Mythic

Recommended print settings

  • Ctrl + P to print into PDF or print directly.
  • Scale: 100% (instead of "fit to page width")
  • Margins: Minimal
  • Print backgrounds ON

2. How to use it

Example input: DMU,NCC,NEO,VOC,VOW,TSR,RNA

2.1 Just pull and run the container from hub.docker.com (simplest)

(sudo) docker run -it --rm valgrut/mtg-labels

Link: https://hub.docker.com/r/valgrut/mtg-labels

2.2 Online on my server

This website will be online on mtglabels.wogon.cz webpage.

2.3 Run app Locally

Clone this repository and run server locally:

    export FLASK_ENV=development
    export FLASK_APP=app
    pip3 install -r requirements.txt
    flask run

and now open http://localhost:5000 in your browser.

2.4 In self-built Container

Build the image:

docker build --tag valgrut/mtg-labels .

and run the app in the container:

docker run -d -p 5000:5000 valgrut/mtg-labels

Finally cleanup the mess:

docker ps
docker stop valgrut/mtg-labels
docker container prune

If this tool has been useful for you, leave a ⭐ star ⭐ please and come back again for new labels!

3. Create your own template

3.1 Using prepared bash script

  1. You can use this bash script to create template, style and add ref to the code.
./create-new-label-template.sh new-template-name

  1. Now just edit generated template and stylesheet and enjoy new label!

  2. Optional: Create a merge request to extend the template pool for others!

3.2 [Not recommended] Manually

Show manual steps to add new Template 

Important note 1: Keep an eye on the naming of the files and of the added lines in the code!
- 'label\_type' in app.py must match the html form '\

  • Copy and modify your copy of the template file in templates/
    • 


    cp templates/small-labels-default-template.html templates/NEW-LABEL-OPTION-STYLE-NAME-template.html
vim templates/NEW-LABEL-OPTION-STYLE-NAME-template.html
    

      

    1. Copy and modify your copy of the stylesheet file in static/
      2. 

    

    cp static/small-labels-default.css static/NEW-LABEL-OPTION-STYLE-NAME.css
vim static/NEW-LABEL-OPTION-STYLE-NAME.css
    

      

    1. Add option into the html form in the 'index.html' file
      2. 

    

    <option value="NEW_LABEL_OPTION_STYLE">New label style name</option>
    

      

    1. Add 'elif' lines into the 'app.py'
      2. 

    

    elif label_type == "NEW_LABEL_OPTION_STYLE_NAME":
    label_type_name = "NEW-LABEL-OPTION-STYLE-NAME"
    

    Which is passed into the files path later in the code.
    

        html_label_template = label_type_name+"-template.html"
    css_label_style = "static/"+label_type_name+".css

    4. Useful stuff:

    4.1. 3D printed card Dividers

    5. Tool Development - Convert excell table to csv file

    • Convert excell ods file into csv for future processing
    soffice --convert-to csv --outdir /tmp/ sets-list.ods
libreoffice --convert-to csv --outdir /tmp/ sets-list.ods
    • Push updated docker image into dockerhub
    docker login
docker push valgrut/mtg-labels
    • README.md live preview
    pipx run grip

    There is limit 60 requests/hour. This will be solved with offline renderer someday.