Skip to main content

This is a work in progress and sudden, dramatic changes are expected!

FreeLens tag generator

FreeLens

This project provides a reference implementation of NaviLens and ddTag for educational or personal use. Commercial use is at your own risk as NaviLens and ddTag may attempt to enforce their IP.

Documentation

Quickstart

Installation

pip install freelens

Generating Tags

FreeLens generates 5×5, 7×7, 9×9, and 11×11 tags. The 5×5 generator uses the CRC found in deployed NaviLens tags. Larger generators extend that calculation with the CRC width and polynomial for their size. Their CRCs are not validated because no deployed examples have been tested.

from freelens import Tag

message = "101010101011000000001011"

tag = Tag.from_message(message, n=5)

tag_img = tag.to_image()

tag_img.save("tag.png")

Generated tags larger than 5×5 report an unknown CRC status:

tag = Tag.from_message("0" * 64, n=7)
assert tag.crc_valid is None

Detecting Tags

from freelens import detect_tags
from PIL import Image

img = Image.open("dataset/positives/0001.jpg")

tags_list = detect_tags(
    img,
    n=5,
    validate_crc=True,
    require_valid_crc=True,
)

for tag in tags_list:
    print(tag.message)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

freelens-0.0.4.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

freelens-0.0.4-py3-none-any.whl (6.9 kB view details)

Uploaded Python 3

File details

Details for the file freelens-0.0.4.tar.gz.

File metadata

  • Download URL: freelens-0.0.4.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for freelens-0.0.4.tar.gz
Algorithm Hash digest
SHA256 d31b66e062d097fb4fae86af3be87162924af3de250ab5fffadfeb96e0d1db77
MD5 5f2e56f96c90716f6e8d1aac0b617129
BLAKE2b-256 672e2a58be81f48e81f8468412d684218a92a58c36fb6c4910191dbf5c0405e0

See more details on using hashes here.

Provenance

The following attestation bundles were made for freelens-0.0.4.tar.gz:

Publisher: release.yml on sjtrny/freelens

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file freelens-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: freelens-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 6.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for freelens-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 f90965470b883ff04997a6ae2a93a9e57af2ca5e71b0ce18dac287eb1a3437e4
MD5 b846e3919a8033fa8e82edddcf069435
BLAKE2b-256 5e77ccf888f1788869afcc55b231daacf8abc6f7c2655fa1c059a0f74590c3e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for freelens-0.0.4-py3-none-any.whl:

Publisher: release.yml on sjtrny/freelens

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.0.5

2 files

This release

0.0.4 This release

2 files

0.0.3

2 files

0.0.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page