{"id":27055116,"url":"https://github.com/cadin/axi-control","last_synced_at":"2025-04-05T09:18:59.604Z","repository":{"id":192643168,"uuid":"662260554","full_name":"cadin/axi-control","owner":"cadin","description":"A Mac GUI for the AxiDraw CLI","archived":false,"fork":false,"pushed_at":"2024-12-16T23:34:45.000Z","size":1682,"stargazers_count":29,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-17T00:46:08.805Z","etag":null,"topics":["axidraw","creative-coding","plotter-art"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cadin.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}},"created_at":"2023-07-04T18:04:19.000Z","updated_at":"2024-12-16T23:34:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"970f9faa-3e32-4fcc-acef-e1cd4b47c3b6","html_url":"https://github.com/cadin/axi-control","commit_stats":null,"previous_names":["cadin/axi-control"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cadin%2Faxi-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cadin%2Faxi-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cadin%2Faxi-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cadin%2Faxi-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cadin","download_url":"https://codeload.github.com/cadin/axi-control/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247312276,"owners_count":20918401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["axidraw","creative-coding","plotter-art"],"created_at":"2025-04-05T09:18:59.114Z","updated_at":"2025-04-05T09:18:59.589Z","avatar_url":"https://github.com/cadin.png","language":"Swift","readme":"# AxiControl\n\nA Mac GUI for the [AxiDraw Command Line Interface](https://axidraw.com/doc/cli_api/).\n\n![AxiControl screenshot](img/Screenshot.png)\n\n## Installation\n\n### 1. Install the AxiDraw CLI\n\nThis app sends commands to AxiDraw through the AxiDraw CLI, so the CLI must be installed in order for the app to work.\n\nThe app expects the CLI to be installed at `/usr/local/bin/`.\n\nOne line install:  \n`python -m pip install https://cdn.evilmadscientist.com/dl/ad/public/AxiDraw_API.zip`\n\nSee the full installation instructions on [AxiDraw.com](https://www.axidraw.com/doc/cli_api/#installation).\n\n### 2. Download AxiControl\n\nDownload the [`AxiControl.zip`](https://github.com/cadin/axi-control/releases/latest/download/AxiControl.zip) file from the [Releases](https://github.com/cadin/axi-control/releases/) page.\n\nUnzip and move the app to your Applications folder.\n\n### 3. Authorize the app\n\nThis app isn't currently being notarized by Apple. This means you'll get a security warning when trying to launch the app for the first time ([more info here](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac)).\n\nTo launch the app, Control-click (or right-click) the app and choose **Open**. Choose **Open** again from the dialog.\n\n#### Sequoia\n\nIn Sequoia this process is even more restrictive.\n\nWhen you launch the app you'll see a dialog that says '\"AxiControl\" Not Opened', with no option to open it anyway.\n\nGo to **Settings \u003e Privacy and Security** and you should see a message that says \"AxiControl\" was blocked to protect your Mac'. Click **Open Anyway**, then choose **Open Anyway** from the dialog.\n\nYou can open the app normally by double-clicking after completing this process.\n\n## Features\n\n### Plot \u0026 Resume\n\nDrag an SVG onto the app window and choose **Start plot** to start plotting.\n\nA temp file will be created to save plot progress. Pause the plot with the hardware button, and choose **Resume** to continue plotting where you left off.\n\nYou can also choose **Save home** when paused. This will move the carriage to the home position and save the move to the temp file. Choosing **Resume** after **Save home** will resume the plot from the home position.\n\n### Walk the carriage\n\n**Home** moves the carriage to the home position.\n\n**Max X** and **Max Y** moves the carriage to the maximum plot dimensions. This can be useful to ensure your paper is squarely aligned before beginning a plot.\n\n**Be sure you have your correct AxiDraw model selected**. Otherwise you may damage your device by walking it outside the maximum range.\n\n### Speed control\n\nThe Speed slider controls the speed limit for the XY carriage when the pen is down. This value is expressed as a percentage of maximum travel speed.\n\n### Layers control\n\nSpecify a number which indicates which layer (or layers) will be plotted when plotting in layers mode. See the [AxiDraw CLI docs](https://www.axidraw.com/doc/cli_api/#layer) for more info.\n\nNote: Layers are not a native feature of SVG. You probably have to create your SVGs in Inkscape to create files with usable layer numbers.  \nSee _[Adding layers outside of Inkscape](https://wiki.evilmadscientist.com/AxiDraw_Layer_Control#Adding_layers_outside_of_Inkscape)_ on the EMS wiki.\n\n### Webhooks\n\nRun a webhook when your plot completes. You can easily set up a webhook at [IFTTT](https://ifttt.com/maker_webhooks) to send you a notification when your plot completes.\n\nClick the gear to enter the URL for your webhook.\n\n## Support\n\nIf you encounter a problem please file an issue.  \nThis is a small personal project that is mostly unsupported.\n\n### Troubleshooting\n\n#### Error: \"Error sending command\"\n\nThis most likely means you haven't installed the AxiDraw CLI properly. Try sending a command from the terminal to verify the installation.\n\nThe app expects the CLI to be installed at `/usr/local/bin/`.\n\n#### Error: \"Failed to connect to AxiDraw.\"\n\nThe CLI couldn't connect to your AxiDraw.  \nMake sure the USB cable is connected to the AxiDraw and your Mac.\n\n#### AxiDraw makes a horrible grinding noise\n\nThis happens when a command tells the AxiDraw to move outside of its maximum plot area.  \nMake sure you have the correct AxiDraw model selected.\n\nYou may also run outside the maximum bounds by invoking Walk Max X or Y from an offset starting location.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcadin%2Faxi-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcadin%2Faxi-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcadin%2Faxi-control/lists"}