Files
labelmaker/README.md
Gavin McDonald 9e2d7b2624 readme tweaks
2025-05-14 16:21:06 -04:00

2.3 KiB

Labelmaker

Labelmaker is a simple web tool for generating text-based images, perfect for creating decals in Tabletop Simulator. Just append your desired text to the URL and Labelmaker will return an image, no design tools required.

Features

  • 📦 Instant text-to-image conversion via URL
  • 🎨 Customizable color, outline, font, and size via query string
  • 🧩 Designed for ease of use with Tabletop Simulator
  • 🧭 Interactive homepage to preview available options

🚀 Usage

Basic Label

https://labelmaker.xyz/Hello World

Generates an image of "Hello World" in the default style.

![Hello World](https://labelmaker.xyz/Hello World)

Set Text Color

https://labelmaker.xyz/Hello?color=yellow

Renders "Hello" in yellow text.

Yellow Hello

Add Outline

https://labelmaker.xyz/Hello?color=yellow&outline=black

Renders "Hello" in yellow with a black outline, perfect for contrast on similar backgrounds.

Outlined yellow Hello

Customize Font and Size

https://labelmaker.xyz/Courier?font=Courier&size=72&color=CornFlowerBlue&outline=white

Uses the Courier font at 72px size.

CornFlowerBlue Courier

⚙️ Query Parameters

Parameter Description Example Value
color Text color red, CornFlowerBlue
outline Outline color black, white
font Font name Courier, Helvetica
size Font size in pixels 24, 48

🧪 Try It Live

Visit the Labelmaker homepage to:

  • Preview fonts and colors
  • Test out combinations
  • Copy generated URLs for use in Tabletop Simulator or elsewhere

🧰 Development

This project is powered by Elixir + Phoenix, employs ImageMagick to create the images, and uses Docker for deployment.

Build & Run Locally

mix setup
mix phx.server

Or use Docker:

docker build -t labelmaker .
docker run -p 4000:4000 labelmaker