{"id":49118093,"url":"https://github.com/ricebean-net/zplbox","last_synced_at":"2026-04-21T09:00:50.876Z","repository":{"id":253453691,"uuid":"843553583","full_name":"ricebean-net/zplbox","owner":"ricebean-net","description":"Use your favorite web framework to design ZPL Labels far simpler and more sophisticated as native ZPL will ever can do!","archived":false,"fork":false,"pushed_at":"2026-02-24T22:53:28.000Z","size":3101,"stargazers_count":23,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-25T03:41:45.646Z","etag":null,"topics":["zebra","zpl","zpl-programming-language"],"latest_commit_sha":null,"homepage":"http://zplbox.org/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ricebean-net.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"buy_me_a_coffee":"meixxi"}},"created_at":"2024-08-16T19:15:50.000Z","updated_at":"2026-02-24T22:46:06.000Z","dependencies_parsed_at":"2024-08-19T22:58:43.043Z","dependency_job_id":"5936ff9f-2979-4bdb-9777-0bf0671daf1e","html_url":"https://github.com/ricebean-net/zplbox","commit_stats":null,"previous_names":["meixxi/html2zpl","meixxi/zplbox","zplbox/zplbox","ricebean-net/zplbox"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/ricebean-net/zplbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricebean-net%2Fzplbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricebean-net%2Fzplbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricebean-net%2Fzplbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricebean-net%2Fzplbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ricebean-net","download_url":"https://codeload.github.com/ricebean-net/zplbox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricebean-net%2Fzplbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32084721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T06:27:27.065Z","status":"ssl_error","status_checked_at":"2026-04-21T06:27:21.250Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["zebra","zpl","zpl-programming-language"],"created_at":"2026-04-21T09:00:40.277Z","updated_at":"2026-04-21T09:00:50.871Z","avatar_url":"https://github.com/ricebean-net.png","language":"Java","funding_links":["https://buymeacoffee.com/meixxi"],"categories":[],"sub_categories":[],"readme":"ZplBox revolutionizes ZPL label creation by allowing you to use the full web technology stack. Design your labels with \n**HTML, CSS, and JavaScript**, and let ZplBox handle the conversion. Your web content is rendered as a PNG and then transformed \ninto a ZPL graphic, giving you the freedom to incorporate **images, custom fonts, rich typography, and special characters** with ease.\n\nBeyond web content, ZplBox also features robust **PDF support**. It can convert any PDF document into a high-quality PNG using \nApache PDFBox, which is then seamlessly integrated into your ZPL label. This allows you to leverage existing PDF designs and \ndocuments for your labels, simplifying your workflow and expanding your design possibilities.\n\nWhether you submit your content as a web file, a URL, or a PDF, ZplBox provides a straightforward way to generate ZPL code \nas a string or send it directly to your printer. This unique approach leverages modern web and document technologies to create\ndynamic and complex labels that are nearly impossible to achieve with native ZPL alone.\n\nZplBox offers a flexible and powerful solution for generating ZPL labels, whether you use our [**Cloud-Hosted Service**](https://rapidapi.com/ricebean-ricebean-default/api/zplbox2) or our convenient [**Self-Hosted ZPL Print Server**](https://zplbox.org/#zpl-print-server).\n\n## Cloud-Hosted Service (*hosted*)\nOur cloud-hosted ZplBox API, available on RapidAPI, provides a seamless, serverless experience for your label generation needs.\n\n[**ZplBox at RapidAPI \u003e\u003e**](https://rapidapi.com/ricebean-ricebean-default/api/zplbox2)\n\n### Quick Start\nCreate a ZPL label of test label https://zplbox.org/test-labels/test-label-2.pdf:\n```shell\n$ curl --request POST \n    --url https://zplbox2.p.rapidapi.com/v1/pdf2zpl \n    --header 'Accept: text/plain' \n    --header 'Content-Type: application/json' \n    --header 'x-rapidapi-host: zplbox2.p.rapidapi.com' \n    --header 'x-rapidapi-key: [YOUR_API_KEY]' \n    --data '{\"url\":\"https://zplbox.org/test-labels/test-label-2.pdf\",\"dotsPerInch\":203,\"orientation\":\"Rotate0\"}'\n    --output my-zpl-label.txt\n```\n\nTo print a file containing ZPL code (_e. g. my-zpl-label.txt_), use the `netcat` (`nc`) command-line utility, available on **macOS** and **Linux**. Zebra printers are listening on port 9100 by default:\n```shell\n$ nc -N 192.168.100.42 9100 \u003c my-zpl-label.txt\n```\nIf you are using **Windows**, the official replacement for Netcat is Ncat, which is included with the popular Nmap network utility.\n\n## Community Edition *(self-hosted)*\nZplBox is designed as a Docker container what can be started using this command:\n```shell\n$ docker run -p 8080:8080 ghcr.io/ricebean-net/zplbox:latest\n```\nZplBox comes with an intuitive user interface (UI) designed to help you get started with ZplBox and its API \neffortlessly. The UI allows you to manually convert HTML and PDF files to ZPL (Zebra Programming Language) and\nsend the generated ZPL labels directly to a printer. \n\nOnce the docker container is started, you can access the interface at http://localhost:8080.\n\n## Documentation and Examples \nFor a complete guide, technical documentation, and additional code examples, please visit **https://zplbox.org**.\n\n* **Extended Quick Start:** Get up and running fast with our step-by-step guide.\n* **API Reference:** Explore the full API with our visual Swagger documentation.\n* **Test Labels:** View and run examples for both HTML and PDF labels.\n* **Code Examples:** Find code snippets for common use cases.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fricebean-net%2Fzplbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fricebean-net%2Fzplbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fricebean-net%2Fzplbox/lists"}