humbertovarona/bqgencode repository overview

⁠BQGenCode: Barcode and QR Code Generator

⁠Description

This website is an interactive tool designed to easily create QR codes and barcodes in different standards from any text, URL, number, or content you wish to encode. The interface is elegant, modern, and fully responsive, ensuring a comfortable experience on any device.

The generator allows you to view and download the generated codes as images, making it easy to integrate them into documents, presentations, labels, or any practical application.

⁠Features

⁠1. Flexible Data Input

• Text field: Enter any content to encode (text, numbers, links, etc.).
• Multi-format support: Content can be of any type, with no specific restrictions.

⁠2. Code Type Selection

• Type selector: Choose from several code formats:

  • QR Code
  • Barcodes: Code128, EAN-13, Code39, UPC-A, EAN-8, ITF, MSI, Codabar

• Clear interface: The selector displays descriptive names so users know exactly which format they are choosing.

⁠3. Instant Code Generation

• "Generate Code" button: Creates the corresponding code according to the content and format selected.
• Visual generation: The code appears on the screen in a dedicated section.
• Error handling: If the data is invalid for the chosen format, a clear and visually highlighted error message is shown.

⁠4. Display and Download

• Preview: The generated code is displayed, centered and adapted to the space.
• Direct download: A button allows downloading the generated code image for immediate use.
• Download format: The code is downloaded as an image (depending on the type of code and browser support).

⁠Running the Application with Docker

⁠Quick Start (HTTP):

docker run -d --name test-bqgencode -p 7173:80 -v $(pwd)/data:/config/www/data humbertovarona/bqgencode

Then, open in your browser:

http://ccc.nnn.sss.xxx:7173/

⁠First Time Setup (HTTPS with Autocert):

docker run -d --name test-bqgencode -e REDIRECT_TO_HTTPS=yes -e AUTOCERT=yes -p 7443:443 -v $(pwd)/data:/config/www/data -v $(pwd)/ssl:/config/ssl humbertovarona/bqgencode

⁠Subsequent Runs (with saved SSL certs):

docker run -d --name test-bqgencode -e REDIRECT_TO_HTTPS=yes -p 7443:443 -v $(pwd)/data:/config/www/data -v $(pwd)/ssl:/config/ssl humbertovarona/bqgencode

Then, open in your browser:

https://192.168.1.4:ccc.nnn.sss.xxx:7443/

⁠Stopping the Container

docker stop test-bqgencode

⁠Removing the Container

docker rm test-bqgencode

⁠Removing the Docker Image

docker rmi -f humbertovarona/bqgencode

⁠Running with docker-compose

You can also use docker-compose for easier multi-run setup. Create a file named docker-compose.yml in your project directory with the following contents:

version: "3"
services:
  bqgencode:
    image: humbertovarona/bqgencode
    container_name: test-bqgencode
    ports:
      - "7173:80"
      # Uncomment for HTTPS:
      # - "7443:443"
    environment:
      # Uncomment these for HTTPS
      # REDIRECT_TO_HTTPS: "yes"
      # AUTOCERT: "yes"     # Only needed first run to auto-generate certs
    volumes:
      - ./data:/config/www/data
      # Uncomment for HTTPS certificate persistence:
      # - ./ssl:/config/ssl
    restart: unless-stopped

⁠Start the service:

docker-compose up -d

⁠Stop the service:

docker-compose down

• For HTTPS, uncomment the relevant ports, environment, and volume sections in the compose file and follow the same logic as the manual Docker commands.

⁠Checking Container Health

To ensure the container is healthy and working correctly, use these commands:

• Check container health status:

  docker inspect --format='{{json .State.Health}}' test-bqgencode | jq
  

  Copy

  (If you don't have jq, simply omit it.)

• View container logs:

  docker logs test-bqgencode
  

  Copy

• Access container shell:

  docker exec -it test-bqgencode /bin/sh
  

  Copy

📦 Software License

This software is published under the Creative Commons Attribution 4.0 International License (CC0 1.0 Universal). You are free to use, modify, and distribute this code for any purpose, provided that proper credit is given to the original author.

⁠👤 Author

HL Varona 📧 [email protected]⁠ 🔧 Project: VaronaTech