{"id":16982540,"url":"https://github.com/pablodiegoss/pymarker","last_synced_at":"2026-01-16T10:01:16.656Z","repository":{"id":46343122,"uuid":"252259291","full_name":"pablodiegoss/pymarker","owner":"pablodiegoss","description":"A python package to generate AR markers and patterns based on input images","archived":false,"fork":false,"pushed_at":"2026-01-12T18:42:58.000Z","size":180,"stargazers_count":8,"open_issues_count":1,"forks_count":6,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-01-12T23:55:31.308Z","etag":null,"topics":["ar-markers","hacktoberfest","markers","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pablodiegoss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-04-01T18:45:47.000Z","updated_at":"2026-01-12T18:42:22.000Z","dependencies_parsed_at":"2022-09-22T22:50:34.993Z","dependency_job_id":null,"html_url":"https://github.com/pablodiegoss/pymarker","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/pablodiegoss/pymarker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablodiegoss%2Fpymarker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablodiegoss%2Fpymarker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablodiegoss%2Fpymarker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablodiegoss%2Fpymarker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pablodiegoss","download_url":"https://codeload.github.com/pablodiegoss/pymarker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablodiegoss%2Fpymarker/sbom","scorecard":{"id":717167,"data":{"date":"2025-08-11","repo":{"name":"github.com/pablodiegoss/pymarker","commit":"affd22ee134bd9797a4eac71e455af9c3d17e563"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5,"checks":[{"name":"Code-Review","score":2,"reason":"Found 4/15 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":10,"reason":"17 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/python-app.yml:1","Warn: no topLevel permission defined: .github/workflows/python-publish.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-app.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/pablodiegoss/pymarker/python-app.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-app.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/pablodiegoss/pymarker/python-app.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-publish.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/pablodiegoss/pymarker/python-publish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-publish.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/pablodiegoss/pymarker/python-publish.yml/master?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/python-app.yml:25","Warn: pipCommand not pinned by hash: .github/workflows/python-app.yml:26","Warn: pipCommand not pinned by hash: .github/workflows/python-publish.yml:23","Warn: pipCommand not pinned by hash: .github/workflows/python-publish.yml:24","Info:   0 out of   4 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   4 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 21 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-22T10:03:39.984Z","repository_id":46343122,"created_at":"2025-08-22T10:03:39.984Z","updated_at":"2025-08-22T10:03:39.984Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ar-markers","hacktoberfest","markers","python"],"created_at":"2024-10-14T02:08:39.358Z","updated_at":"2026-01-16T10:01:16.053Z","avatar_url":"https://github.com/pablodiegoss.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PyMarker\n\nA python package to manage Augmented Reality markers and patterns based on input images. This package is capable of generating black borders around images to be used as AR markers and also removing them in cases where you need to automatize the process.\n\n## Installation\n\nPyMarker is available through pip and [Pypi](https://pypi.org/project/pymarker/).\n\n```bash\npython3 -m pip install pymarker --user\n// or\npip3 install pymarker --user\n```\n\n## Usage\n\nPymarker provides three features for a marker-based AR: generating Pattern files (.patt); Markers images (.png); Removing borders of existing Marker images. The marker will be used by the user to visualize some augmented reality, the pattern file for the system to be able to recognize the marker.\n\nAn example input image:\n\n![Example of an input image](images/hiro.jpg)\n\nExpected output patt:\n\n![Example output for pattern file](images/patt_example.png)\n\nExpected output marker:\n\n![Example of a generated marker](images/marker_example.png)\n\nUsing the remove feature, we can return this marker to the starter image back again:\n\n![Example of an input image](images/hiro.jpg)\n\n### Commands\n\nPyMarker now uses subcommands for its CLI interface.\n\n#### Generate markers and patt files\n\nBy default, the `generate` subcommand receives an image and generates both patt and marker files:\n\n```bash\n$ pymarker generate tests/input/hiro.jpg\n```\n\nTo generate only the patt file for the input, use the `-p` or `--patt` flag:\n\n```bash\n$ pymarker generate -p tests/input/hiro.jpg\n# or\n$ pymarker generate --patt tests/input/hiro.jpg\n```\n\nTo generate only the marker, use the `-m` or `--marker` flag:\n\n```bash\n$ pymarker generate -m tests/input/hiro.jpg\n# or\n$ pymarker generate --marker tests/input/hiro.jpg\n```\n\nYou can adjust the marker border size with `-b` (black border, default 20%) and `-w` (white border, default 3%):\n\n```bash\n$ pymarker generate -b 40 -w 5 tests/input/hiro.jpg\n```\n\nYou can also specify an output path with `-o` or `--output`:\n\n```bash\n$ pymarker generate -o output_dir/ tests/input/hiro.jpg\n```\n\n#### Remove borders from marker images\n\nTo remove borders from a marker image, use the `remove` subcommand:\n\n```bash\n$ pymarker remove tests/input/marker.png\n```\n\nYou can specify an output path for the result:\n\n```bash\n$ pymarker remove -o output_dir/ tests/input/marker.png\n```\n\n### Modules\n\nYou can use the functions directly from your python code to generate markers and patts.\n\n```python\nfrom pymarker.core import generate_patt, generate_marker\n\ndef main():\n    filename = \"tests/input/hiro.jpg\"\n    border_size = 50 // size in percentage\n\n    generate_patt(filename)\n    generate_marker(filename,border_size)\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpablodiegoss%2Fpymarker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpablodiegoss%2Fpymarker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpablodiegoss%2Fpymarker/lists"}