# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-netbox-qrcode
VERSION=		0.0.21
KEYWORDS=		python
VARIANTS=		v13 v14
SDESC[v13]=		QR Code generation for netbox objects (3.13)
SDESC[v14]=		QR Code generation for netbox objects (3.14)
HOMEPAGE=		https://github.com/netbox-community/netbox-qrcode
CONTACT=		Python_Automaton[python@ravenports.com]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/19/a5/560cc5f6fb798b38fca7a5c4ab86650f0ff9567a0696738811096838d3b0
DISTFILE[1]=		netbox_qrcode-0.0.21-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v13]=		single
SPKGS[v14]=		single

OPTIONS_AVAILABLE=	PY313 PY314
OPTIONS_STANDARD=	none
VOPTS[v13]=		PY313=ON PY314=OFF
VOPTS[v14]=		PY313=OFF PY314=ON

DISTNAME=		netbox_qrcode-0.0.21.dist-info

GENERATED=		yes

[PY313].RUN_DEPENDS_ON=			python-qrcode:single:v13
					python-Pillow:single:v13
[PY313].USES_ON=			python:v13,wheel

[PY314].RUN_DEPENDS_ON=			python-qrcode:single:v14
					python-Pillow:single:v14
[PY314].USES_ON=			python:v14,wheel

[FILE:2894:descriptions/desc.single]
# Netbox QR Code Plugin

A [NetBox] plugin used to generate QR codes for objects: Device, Module,
Cable, Powerfeed, Powerpanel, Location 

This plugin depends on [qrcode] and [Pillow] python library

[Downloads]
[Downloads]
[Downloads]

## Compatibility

See the [compatibility matrix] for supported NetBox versions.

## Installation

If Netbox was installed according to the standard installation
instructions. It may be necessary to activate the virtual environment.

```
source /opt/netbox/venv/bin/activate
`

The plugin is available as a Python package in pypi and can be installed
with pip

`
pip install netbox-qrcode
```
Enable the plugin in /opt/netbox/netbox/netbox/configuration.py:
```
PLUGINS = ['netbox_qrcode']
```
Restart NetBox and add `netbox-qrcode` to your local_requirements.txt

## Configuration

### Label Design

Extensive label customisation is possible, it's also possible to include
different labels for each object type, for example 2 labels for the Device
view.

For advice on configuration please see the two links below:

- [General Configuration >>]
- [Configuration Examples  >>]

![Cable QR Code]

### Printing

#### Setting the label printer 

If the print does not look like the preview in the Netbox, first try to get
a perfect print using Word. As many printer settings also have an influence
on the print result. Borderless printing is possible if the printer (e.g.
thermal transfer printer) supports this.

![ShowImage]

Here is an example of what needs to be considered to print borderless from
a Word document. [Go to: Example Zebra ZM400 300dpi label printer and a
label 56x32mm. >>]

#### Setting Browser Print Settings

When you press the “Print” button, there are some print properties that
are added by the browser. However, these interfere with the print result.
They should therefore be deactivated.

##### Firefox:

| Parameter                                      | Value                   
    |
| ---------------------------------------------  |
---------------------------  |
| Orientation                                    | Portrait                
    |  
| Paper size                                     | User defined            
    |
| Margins                                        | none                    
    |
| Scale                                          | Fit to page width or
100%    |
| Options --> Print headers and footers          | disable                 
    |
| Options --> Print backgrounds                  | disable                 
    |

##### Chrome:
Chrome can alter settings between printing and the print preview, therefore
the below settings are recomended

| Parameter                                      | Value                   
    |
| ---------------------------------------------  |
---------------------------  |
| Layout                                         | Portrait                


[FILE:127:distinfo]
f4a861fb912a457ea4ce4de672a434d3c3cb249e43936bb6dcd2c1298fc9d361        15292 python-src/netbox_qrcode-0.0.21-py3-none-any.whl