Compare commits

...

3 Commits

Author SHA1 Message Date
Gavin McDonald
41f1499d40 Merge branch 'trunk' of https://gitea.mcmorgans.us/gavin/labelmaker into trunk 2025-05-17 16:16:55 -04:00
Gavin McDonald
4f554e9c07 updated readme 2025-05-17 16:16:39 -04:00
Gavin McDonald
6c203f0f06 updated social share images 2025-05-17 15:49:01 -04:00
4 changed files with 45 additions and 19 deletions

View File

@@ -1,6 +1,8 @@
# Labelmaker # Labelmaker
[Labelmaker](https://labelmaker.xyz) is a simple web tool for generating text-based images, perfect for creating decals in [Tabletop Simulator](https://www.tabletopsimulator.com/). Just append your desired text to the URL and Labelmaker will return an image, no design tools required. [Labelmaker](https://labelmaker.xyz) is a simple web tool for generating text-based images, perfect for creating [decals](https://kb.tabletopsimulator.com/game-tools/decal-tool/) in [Tabletop Simulator](https://www.tabletopsimulator.com/). Just append your desired text to the URL and Labelmaker will return an image, no design tools required. A few options are available via query string parameters: font, color, outline, and size. The homepage offers a form to make things a bit easier.
![Risky business](/images/ukraine_1024x512.png)
## ✨ Features ## ✨ Features
@@ -15,7 +17,7 @@
[https://labelmaker.xyz/Hello World](https://labelmaker.xyz/Hello%20World) [https://labelmaker.xyz/Hello World](https://labelmaker.xyz/Hello%20World)
Generates an image of "Hello World" in the default style. (I'm actually cheating here and appended `?outline=white` so that the image is visible on dark backgrounds)
![Hello World](https://labelmaker.xyz/Hello%20World?outline=white) ![Hello World](https://labelmaker.xyz/Hello%20World?outline=white)
@@ -23,24 +25,18 @@ Generates an image of "Hello World" in the default style.
[https://labelmaker.xyz/Hello?color=yellow](https://labelmaker.xyz/Hello?color=yellow) [https://labelmaker.xyz/Hello?color=yellow](https://labelmaker.xyz/Hello?color=yellow)
Renders "Hello" in yellow text.
![Yellow Hello](https://labelmaker.xyz/Hello?color=yellow) ![Yellow Hello](https://labelmaker.xyz/Hello?color=yellow)
### Add Outline ### Add Outline
[https://labelmaker.xyz/Hello?color=yellow&outline=black](https://labelmaker.xyz/Hello?color=yellow&outline=black) [https://labelmaker.xyz/Hello?color=yellow&outline=black](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](https://labelmaker.xyz/Hello?color=yellow&outline=black) ![Outlined yellow Hello](https://labelmaker.xyz/Hello?color=yellow&outline=black)
### Customize Font and Size ### Customize Font and Size
[https://labelmaker.xyz/Courier?font=Courier&size=96&color=CornFlowerBlue&outline=white](https://labelmaker.xyz/Courier?font=Courier&size=96&color=CornFlowerBlue&outline=white) [https://labelmaker.xyz/Courier?font=Courier&size=96&color=CornFlowerBlue&outline=white](https://labelmaker.xyz/Courier?font=Courier&size=96&color=CornFlowerBlue&outline=white)
Uses the `Courier` font at 96px size.
![CornflowerBlue Courier](https://labelmaker.xyz/Courier?font=Courier&size=72&color=CornflowerBlue&outline=white) ![CornflowerBlue Courier](https://labelmaker.xyz/Courier?font=Courier&size=72&color=CornflowerBlue&outline=white)
### Multiple Lines ### Multiple Lines
@@ -51,15 +47,6 @@ Use `\n` to insert line breaks.
![Multiple\nLines](https://labelmaker.xyz/Multiple\nLines?font=DejaVu-Sans-Oblique&size=72&color=orange) ![Multiple\nLines](https://labelmaker.xyz/Multiple\nLines?font=DejaVu-Sans-Oblique&size=72&color=orange)
## ⚙️ 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 ## 🧪 Try It Live
Visit the [Labelmaker homepage](https://labelmaker.xyz/) to: Visit the [Labelmaker homepage](https://labelmaker.xyz/) to:
@@ -68,6 +55,45 @@ Visit the [Labelmaker homepage](https://labelmaker.xyz/) to:
- Test out combinations - Test out combinations
- Copy generated URLs for use in Tabletop Simulator or elsewhere - Copy generated URLs for use in Tabletop Simulator or elsewhere
## ⚙️ Query Parameters
| Parameter | Description | Values |
| --------- | ------------------- | ----------------- |
| `color` | Text color | `black` |
| | | `blue` |
| | | `brown` |
| | | `gray` |
| | | `green` |
| | | `orange` |
| | | `pink` |
| | | `purple` |
| | | `red` |
| | | `white` |
| | | `yellow` |
| `outline` | Outline color | `none` |
| | | `blue` |
| | | `brown` |
| | | `gray` |
| | | `green` |
| | | `orange` |
| | | `pink` |
| | | `purple` |
| | | `red` |
| | | `white` |
| | | `yellow` |
| `font` | Font name | `Comic Sans (cs)` |
| | | `Courier (cr)` |
| | | `Georgia (g)` |
| | | `Helvetica (h)` |
| | | `Impact (i)` |
| | | `Verdana (v)` |
| `size` | Font size in pixels | `16` |
| | | `24` |
| | | `32` |
| | | `...` |
| | | `120` |
| | | `128` |
## 🧰 Development ## 🧰 Development
This project is powered by Elixir + Phoenix, employs ImageMagick to create the images, and uses Docker for deployment. This project is powered by Elixir + Phoenix, employs ImageMagick to create the images, and uses Docker for deployment.

View File

@@ -21,7 +21,7 @@
<meta property="og:image:type" content="image/png" /> <meta property="og:image:type" content="image/png" />
<meta property="og:image:width" content="1200" /> <meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" /> <meta property="og:image:height" content="630" />
<meta property="og:image" content="https://labelmaker.xyz/labelmaker_1200x630.png" /> <meta property="og:image" content="https://labelmaker.xyz/images/ukraine_1200x630.png" />
<meta name="twitter:card" content="summary_large_image" /> <meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Labelmaker" /> <meta name="twitter:title" content="Labelmaker" />
<meta <meta
@@ -31,7 +31,7 @@
<meta name="twitter:image:type" content="image/png" /> <meta name="twitter:image:type" content="image/png" />
<meta name="twitter:image:width" content="1024" /> <meta name="twitter:image:width" content="1024" />
<meta name="twitter:image:height" content="512" /> <meta name="twitter:image:height" content="512" />
<meta name="twitter:image" content="https://labelmaker.xyz/labelmaker_1024x512.png" /> <meta name="twitter:image" content="https://labelmaker.xyz/images/ukraine_1024x512.png" />
<link rel="manifest" href="/site.webmanifest" /> <link rel="manifest" href="/site.webmanifest" />
<link phx-track-static rel="stylesheet" href={~p"/assets/app.css"} /> <link phx-track-static rel="stylesheet" href={~p"/assets/app.css"} />
<script defer phx-track-static type="text/javascript" src={~p"/assets/app.js"}> <script defer phx-track-static type="text/javascript" src={~p"/assets/app.js"}>

Binary file not shown.

After

Width:  |  Height:  |  Size: 467 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 679 KiB