{"id":23359987,"url":"https://github.com/matanabc/path-generator-app","last_synced_at":"2026-05-02T03:31:18.406Z","repository":{"id":140583389,"uuid":"304087036","full_name":"matanabc/path-generator-app","owner":"matanabc","description":"A easy motion profile generator","archived":false,"fork":false,"pushed_at":"2022-02-22T13:52:27.000Z","size":22088,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-07T20:54:37.527Z","etag":null,"topics":["frc","pathgenerator"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matanabc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2020-10-14T17:25:01.000Z","updated_at":"2021-10-15T09:09:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"cd016b9c-bc63-4296-aea7-93f3fa1ba86f","html_url":"https://github.com/matanabc/path-generator-app","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/matanabc/path-generator-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matanabc%2Fpath-generator-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matanabc%2Fpath-generator-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matanabc%2Fpath-generator-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matanabc%2Fpath-generator-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matanabc","download_url":"https://codeload.github.com/matanabc/path-generator-app/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matanabc%2Fpath-generator-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32522223,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["frc","pathgenerator"],"created_at":"2024-12-21T11:12:45.561Z","updated_at":"2026-05-02T03:31:18.398Z","avatar_url":"https://github.com/matanabc.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![GitHub all releases](https://img.shields.io/github/downloads/matanabc/path-generator-app/total?logo=github)](https://github.com/matanabc/path-generator-app/releases)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/matanabc/path-generator-app?logo=github)](https://github.com/matanabc/path-generator-app/releases)\n\n# PathGenerator\n\n![App view](./app.png)\n**PathGenerator** is a motion profile path generator, which you can easily use to draw a path for your robot to follow. \u003cbr/\u003e\nWhen you finish setting up the path for your robot to follow, just press on the export button and use the CSV files on your robot to follow the path.\n\n**PathGenerator** is based on [PathGenerator](https://www.npmjs.com/package/path-generator) package.\n\n## Setup Instructions:\n\n### Release:\n\n-   Web latest version [here](https://matanabc.github.io/path-generator-app/)\n-   Download desktop latest version [here](https://github.com/matanabc/path-generator-app/releases)\n\n### Source:\n\n1. Install [Node.js](https://nodejs.org)\n1. Clone this repository\n1. Install all project dependencies: `npm i`\n\n-   npm commands:\n    -   Development:\n        -   `npm run start-web` to run in web mode\n        -   `npm run start-app` to run in desktop mode\n    -   Build:\n        -   `npm run build-web` to build for web, Build files will located in `/build` folder\n        -   `npm run build-app` to build for desktop, Build files will located in `/dist` folder\n\n## Usage Instructions:\n\n### Setup project:\n\nBefore you start planning your path you will need to setup your project in settings.\u003cbr/\u003e\nThis is all you need to know for your project setup (settings):\n\n1. **Folders Config** - All the folders for your project\n    - **_Project folder_** - Where the project setting, paths and groups will be saved\n    - **_Path CSV folder_** - Where to export path CSV for your robot to use\n2. **Path Config** - All the information needed for calculating robot path\n    - **_Tank or Holonomic_** - Robot drive type\n    - **_Width and Length_** - Robot size in meters\n    - **_Max V and Acc_** - Robot max Velocity and acceleration in meters\n    - **_Loop time_** - Robot loop time in sec\n3. **Filed Config**\n    - **_Width and Height_** - Field size in meters\n    - **_Image_** - Field image to use, it can be image name in project folder or URL\n    - **_Top Left X and Y, Width and Height_** - Filed position in the field image\n4. **Robot Draw Config** - All the information needed for drawing your robot\n    - **_Width and Length_** - Robot full size with bumper in meters\n    - **_Center_** - Robot center in meters\n\n### Path Planning Usage:\n\nAfter you finish setting up your project, all you need to do is create a path and start planning it.\u003cbr/\u003e\nThis is all you need to know for planning your path:\n\n1. **Create A New Path**\n    - Click on `select path` button and then `new path`\n    - Choose the name for your path\n2. **Add Waypoint**\n    - Hold ctrl button and drag a waypoint\n3. **Config Waypoint**\n    - Drag a waypoint to move it on the filed\n    - Double click a waypoint to open waypoint info\n    - Click on a waypoint and then scroll for changing waypoint angle\n    - Click on a waypoint and then hold ctrl and scroll for changing waypoint robot angle (only for Holonomic)\n4. **Play Path Preview**\n    - Click on the `play` button to see how the robot will follow the path\n    - Move the slider to the part in the path you want to see how your robot will be positioned\n    - Click on the filed and then scroll to see your robot following the path\n5. **Export The Path**\n    - Click on the `download` button to export the path as CSV file\n\n### Group Planning Usage\n\nAfter you finish creating the paths, you can create groups with those paths to see a preview off all the paths together.\u003cbr/\u003e\nThis is all you need to know for planning your group:\n\n1. **Create A Group**\n    - Click on `select group` button and then `new group`\n    - Choose the name for your group\n2. **Set Group Paths**\n    - Click on `add path to group` button\n    - Drag path name from _paths to use_ to _paths in group_\n        - To change paths order in group drag the path name from _paths in group_ to the position you want\n3. **Play The Group**\n    - Click on the `play` button to see how the robot will follow the path\n    - Move the slider to the part in the path you want to see how your robot will be positioned\n    - Click on the filed and then scroll to see your robot following the path\n4. **Export Group Paths**\n    - Click on the `download` button to export the path as CSV file\n\n### Shortcuts:\n\n|   Action    |         Description          |\n| :---------: | :--------------------------: |\n| ⌘ / alt + s | export path for robot to use |\n| ⌘ / alt + f |    change direction path     |\n| ⌘ / alt + n |     create path / group      |\n| ⌘ / alt + r |     rename path / group      |\n| ⌘ / alt + d |     delete path / group      |\n| ⌘ / alt + p |        open settings         |\n| ⌘ / alt + m |         change mode          |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatanabc%2Fpath-generator-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatanabc%2Fpath-generator-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatanabc%2Fpath-generator-app/lists"}