{"id":38656609,"url":"https://github.com/erbsland-dev/erbsland-maze","last_synced_at":"2026-01-17T09:28:34.782Z","repository":{"id":225563205,"uuid":"766282509","full_name":"erbsland-dev/erbsland-maze","owner":"erbsland-dev","description":"Erbsland Maze is a sophisticated, open-source maze generator designed for creating complex, rectangular mazes. ","archived":false,"fork":false,"pushed_at":"2025-04-16T09:03:49.000Z","size":5637,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-30T21:44:51.831Z","etag":null,"topics":["labyrinth","labyrinth-generation","maze","maze-algorithms","maze-generator"],"latest_commit_sha":null,"homepage":"https://erbsland-dev.github.io/erbsland-maze/","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/erbsland-dev.png","metadata":{"files":{"readme":"README.rst","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},"funding":{"ko_fi":"erbslanddev"}},"created_at":"2024-03-02T20:38:47.000Z","updated_at":"2025-06-03T00:30:43.000Z","dependencies_parsed_at":"2024-03-02T22:32:29.551Z","dependency_job_id":"9912c369-bee1-4879-99fd-154411a8f75e","html_url":"https://github.com/erbsland-dev/erbsland-maze","commit_stats":null,"previous_names":["erbsland-dev/erbsland-maze"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/erbsland-dev/erbsland-maze","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erbsland-dev%2Ferbsland-maze","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erbsland-dev%2Ferbsland-maze/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erbsland-dev%2Ferbsland-maze/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erbsland-dev%2Ferbsland-maze/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erbsland-dev","download_url":"https://codeload.github.com/erbsland-dev/erbsland-maze/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erbsland-dev%2Ferbsland-maze/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28505560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"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":["labyrinth","labyrinth-generation","maze","maze-algorithms","maze-generator"],"created_at":"2026-01-17T09:28:34.681Z","updated_at":"2026-01-17T09:28:34.766Z","avatar_url":"https://github.com/erbsland-dev.png","language":"Python","funding_links":["https://ko-fi.com/erbslanddev"],"categories":[],"sub_categories":[],"readme":"Welcome to Erbsland Maze\n========================\n\nErbsland Maze is a sophisticated, open-source maze generator designed for creating complex, rectangular mazes. It exports mazes as SVG files, making them perfect for graphic design applications or even for 3D modeling. This tool stands out for its customization capabilities; it supports various endpoint configurations, allowing for connected or dead-end designs.\n\n.. image:: docs/images/example_2.svg\n    :width: 100%\n\nFeatures\n--------\n\n- **Modular and Flexible**: Tailor your maze to fit any project requirement, from simple puzzles to complex labyrinth designs.\n- **Customizable Endpoints**: Specify any number of endpoints, deciding whether they're interconnected or serve as individual dead-ends.\n- **Design Freedom**: Freely position endpoints, incorporate blank areas for shaping the maze, and merge smaller rooms into larger spaces for aesthetic or functional purposes.\n- **Path Customization**: Adjust room connections to guide the maze's pathways or to craft a unique template for your designs.\n\nRequirements\n------------\n\nTo use Erbsland Maze, you'll need:\n\n- Python 3.12 or higher.\n- The `pycairo` library for rendering SVG files.\n\nQuickstart Guide\n----------------\n\nFollow these steps to get started with Erbsland Maze:\n\n#.  Clone the repository and navigate into it:\n\n    .. code-block:: console\n\n        git clone https://github.com/erbsland-dev/erbsland-maze/\n        cd erbsland-maze\n\n#.  Create and activate a new Python virtual environment:\n\n    .. code-block:: console\n\n        python3.12 -m venv venv\n        source venv/bin/activate\n\n#.  Install `pycairo`:\n\n    .. code-block:: console\n\n        pip install pycairo\n\n#.  Generate your first maze:\n\n    .. code-block:: console\n\n        cd src\n        python generate_maze.py -x 100 -y 100 -o maze.svg\n\n    This command creates a `maze.svg` file in the `src` directory with your newly generated maze.\n\n#.  For additional command-line options and configurations:\n\n    .. code-block:: console\n\n        python generate_maze.py --help\n\nDocumentation\n-------------\n\nYou find all details about the library, it's design and file format in the `documentation`_.\n\n\nExamples\n--------\n\n.. code-block:: console\n\n    generate_maze.py -x 300 -y 300 -t 0.5 -e nw -e se -m w/3/1 -m nw/5 -m n/3/1 -m ne/5 -m e/3/1 -m se/5 -m s/3/1 -m sw/5 -b c/5 -b c/3/-6,0 -b c/3/6,0 -b c/3/0,-6 -b c/3/0,6 -f 2 -c ^m/w/3/1 -c ^m/nw/5 -c ^m/n/3/1 -c ^m/ne/5 -c ^m/e/3/1 -c ^m/se/5 -c ^m/s/3/1 -c ^m/sw/5\n\n.. image:: docs/images/example_1.svg\n    :width: 100%\n\n.. code-block:: console\n\n    generate_maze.py -x 300 -y 100 -l 4 -t 2.5 -e w/10 -e e/10 -m w/3/10 -m e/3/10 -b nw/5 -b ne/5 -b se/5 -b sw/5\n\n.. image:: docs/images/example_2.svg\n    :width: 100%\n\n.. code-block:: console\n\n    generate_maze.py -x 200 -y 300 --height-parity=none --width-parity=none -l 4 -t 0.5 -e nw -e n/0/x -e ne/0/x -e e/20/x -e se -e s/0/x -e sw/1/x -m sw/2/1 -b w/2x67 -b ne/30x20/-4,12 -b se/30x20/-4,-12 -b e/20x43\n\n.. image:: docs/images/example_3.svg\n    :width: 100%\n\n\nLicense\n-------\n\nCopyright © 2003-2024 Tobias Erbsland https://erbsland.dev/\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\n\n.. _`documentation`: https://erbsland-dev.github.io/erbsland-maze/\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferbsland-dev%2Ferbsland-maze","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferbsland-dev%2Ferbsland-maze","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferbsland-dev%2Ferbsland-maze/lists"}