Shelf Label Generator

This project has been restructured into a proper Python package.

Please see the shelf_print directory for the application code and documentation.

Quick Start

# Install the package
pip install -e ./shelf_print

# Run the application
shelf-print

# For CLI mode
shelf-print cli --help

For more detailed instructions, see shelf_print/INSTALL.md.

Features

• Generate shelf labels with Code 128 barcodes
• Customizable aisle, bin, and shelf levels
• Flexible label layout options
• Save output to PDF

Building the Application

Prerequisites

• Python 3.13 or higher
• macOS 10.13 or higher

Setup

1. Clone this repository
2. Navigate to the project directory
3. Create a virtual environment:

python -m venv venv
source venv/bin/activate

4. Install dependencies:

pip install -r requirements.txt

Generate the Icon

Run the icon generation script:

python create_icon.py

Build the Application

Build using PyInstaller:

pyinstaller shelf_labels.spec

The packaged application will be created in the dist folder.

Running from Source

If you prefer to run the application without building:

python shelf_labels_gui.py

Usage

1. Launch the Shelf Label Generator application
2. Configure your label parameters:
   • Aisle range
   • Bin range
   • Shelf levels
   • Layout options
3. Set an output path for the PDF
4. Click "Generate Labels"

License

MIT