This is a work in progress and sudden, dramatic changes are expected!
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
- NaviLens
- ddTag specification
- ddTag detection
- CRCs in ddTags
- Testing NaviLens code PDFs
- Tag editor
- Development
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/images/0001.jpg")
tags_list = detect_tags(
img,
n=5,
validate_crc=True,
require_valid_crc=True,
)
for tag in tags_list:
print(tag.message)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file freelens-0.0.5.tar.gz.
File metadata
- Download URL: freelens-0.0.5.tar.gz
- Upload date:
- Size: 7.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
85fc705f0fde9c0dd20efd3d3017270ecb09da5bb70fe54ad5d52ef2f9771b26
|
|
| MD5 |
dc6a4bec4f1eddb6b8235de14586fb97
|
|
| BLAKE2b-256 |
3a82fee47a11e8dff7a96012b45a1933253562a2b1f6d01104dd6c740ce00e03
|
Provenance
The following attestation bundles were made for freelens-0.0.5.tar.gz:
Publisher:
release.yml on sjtrny/freelens
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
freelens-0.0.5.tar.gz -
Subject digest:
85fc705f0fde9c0dd20efd3d3017270ecb09da5bb70fe54ad5d52ef2f9771b26 - Sigstore transparency entry: 2579612248
- Sigstore integration time:
-
Permalink:
sjtrny/freelens@99e345aa5728db254d29c07d8960f16aa1174f69 -
Branch / Tag:
refs/tags/v0.0.5 - Owner: https://github.com/sjtrny
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@99e345aa5728db254d29c07d8960f16aa1174f69 -
Trigger Event:
release
-
Statement type:
File details
Details for the file freelens-0.0.5-py3-none-any.whl.
File metadata
- Download URL: freelens-0.0.5-py3-none-any.whl
- Upload date:
- Size: 7.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
946c614636ba1dafc93af5362dff5f12b9e8d85b33ec6b4b942fce7cdf46eb4a
|
|
| MD5 |
77e25a94152ba4147f3a653a11a14a3b
|
|
| BLAKE2b-256 |
48859ee30fef797cebaa95bcd5cd553d3d09f83a59805288e19bd1f58a23347f
|
Provenance
The following attestation bundles were made for freelens-0.0.5-py3-none-any.whl:
Publisher:
release.yml on sjtrny/freelens
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
freelens-0.0.5-py3-none-any.whl -
Subject digest:
946c614636ba1dafc93af5362dff5f12b9e8d85b33ec6b4b942fce7cdf46eb4a - Sigstore transparency entry: 2579612253
- Sigstore integration time:
-
Permalink:
sjtrny/freelens@99e345aa5728db254d29c07d8960f16aa1174f69 -
Branch / Tag:
refs/tags/v0.0.5 - Owner: https://github.com/sjtrny
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@99e345aa5728db254d29c07d8960f16aa1174f69 -
Trigger Event:
release
-
Statement type:
