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

NAMEBASE=		python-netbox-qrcode
VERSION=		0.0.20
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@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/e0/2e/611c64afa4120a0543293384f0d0cc8acbc9e57850c775e849505bd8020b
DISTFILE[1]=		netbox_qrcode-0.0.20-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.20.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:2913: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

| Plugin Version | NetBox Version | Tested on |
| ------------- |:-------------| :-----------:|
| 0.0.11        | 3.7.x        | 3.7.x        |
| 0.0.14        | 4.0.x        | 4.0.11       |
| 0.0.15        | 4.1.x        | 4.1.6        |
| 0.0.17        | 4.2.x        | 4.2.4        |
| 0.0.18        | 4.3.x        | 4.3.1        |
| 0.0.19        | 4.4.x        | 4.4.0        |
| 0.0.20        | 4.5.x        | 4.5.0        |

## 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:


[FILE:127:distinfo]
091da12724dd08684cee970304e0e05cfc55dc5f1ae5f7f97529c3f8e0f2f1e2        15210 python-src/netbox_qrcode-0.0.20-py3-none-any.whl