https://github.com/jhviw/xml-to-zpl-converter
a Python-based GUI application that allows users to convert XML data to ZPL (Zebra Programming Language) and preview the output.
https://github.com/jhviw/xml-to-zpl-converter
converter python xml xml-converter zebra-printer zpl
Last synced: 3 months ago
JSON representation
a Python-based GUI application that allows users to convert XML data to ZPL (Zebra Programming Language) and preview the output.
- Host: GitHub
- URL: https://github.com/jhviw/xml-to-zpl-converter
- Owner: JHVIW
- Created: 2024-08-09T09:22:53.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-08-09T09:27:26.000Z (9 months ago)
- Last Synced: 2025-01-12T11:45:01.422Z (4 months ago)
- Topics: converter, python, xml, xml-converter, zebra-printer, zpl
- Language: Python
- Homepage:
- Size: 13.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# XML to ZPL Converter with Preview
This is a Python-based GUI application that allows users to convert XML data to ZPL (Zebra Programming Language) and preview the output. The application is built using Tkinter for the GUI, PIL (Pillow) for image handling, and requests for interacting with the Labelary API to render the ZPL preview.
## Features
- **XML to ZPL Conversion**: Parse XML input to generate corresponding ZPL commands.
- **ZPL Preview**: Visualize the generated ZPL as an image using the Labelary API.
- **Grid Overlay**: Toggle a red grid overlay on the ZPL preview for easier positioning.
- **Find and Highlight Text**: Search for specific text within the XML input and highlight occurrences.
- **Auto-Preview**: Automatically update the ZPL preview as you edit the XML.
- **Fullscreen Mode**: The application runs in fullscreen mode for better visibility and user experience.
- **Save and Load XML**: Save your XML input to a file and load it automatically on startup.
## Installation
1. **Clone the Repository**
```bash
git clone https://github.com/JHVIW/XML-TO-ZPL-Converter.git
```
2. **Install Dependencies**
Ensure you have Python 3.x installed. Install the required Python packages using `pip`:
```bash
pip install -r requirements.txt
```
The `requirements.txt` should contain:
```
requests
Pillow
```
3. **Run the Application**
```bash
python main.py
```
## Usage
- **XML Input**: Enter or paste your XML data into the left pane.
- **ZPL Preview**: The right pane displays the ZPL preview. The preview updates automatically as you edit the XML.
- **Save XML**: Save your current XML input by clicking the "Save" button or pressing `Ctrl+S`.
- **Toggle Grid**: Click the "Toggle Grid" button to overlay a red grid on the preview image.
- **Find Text**: Press `Ctrl+F` to search for text within the XML input.
- **Exit**: Exit the application by clicking the "Exit" button.
## XML Structure
The XML should follow a specific structure for the conversion to work correctly. Here is an example:
```xml
Sample Text
123456
```
- **TEXT**: Represents a text element.
- **BARCODE**: Represents a barcode element.
## API Integration
The application uses the [Labelary API](http://labelary.com/service.html) to convert ZPL into a preview image. Make sure you have an active internet connection when running the application.
## Notes
- The application automatically saves your XML input to a file (`saved_xml.txt`) upon exiting. This file is loaded back into the application when you start it again.
- The grid overlay is a helpful feature to assist in designing and aligning elements within the ZPL preview.
## Contributing
Contributions are welcome! Please fork the repository and create a pull request with your changes.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.