{"id":23757146,"url":"https://github.com/mmitch/knittr","last_synced_at":"2026-03-16T22:30:14.803Z","repository":{"id":19784872,"uuid":"23043820","full_name":"mmitch/knittr","owner":"mmitch","description":"brush up knitting patterns for printing","archived":false,"fork":false,"pushed_at":"2021-06-19T19:00:29.000Z","size":7788,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-31T19:38:02.668Z","etag":null,"topics":["knitting-patterns","printing","svg"],"latest_commit_sha":null,"homepage":"","language":"Java","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/mmitch.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}},"created_at":"2014-08-17T15:44:14.000Z","updated_at":"2022-03-09T09:57:54.000Z","dependencies_parsed_at":"2022-09-01T01:13:18.172Z","dependency_job_id":null,"html_url":"https://github.com/mmitch/knittr","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmitch%2Fknittr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmitch%2Fknittr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmitch%2Fknittr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmitch%2Fknittr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mmitch","download_url":"https://codeload.github.com/mmitch/knittr/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239927821,"owners_count":19719835,"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":["knitting-patterns","printing","svg"],"created_at":"2024-12-31T19:38:13.722Z","updated_at":"2026-03-16T22:30:14.773Z","avatar_url":"https://github.com/mmitch.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"knittr\n======\n\n[![Build Status](https://travis-ci.org/mmitch/knittr.svg?branch=master)](https://travis-ci.org/mmitch/knittr)\n[![Coverage Status](https://codecov.io/github/mmitch/knittr/coverage.svg?branch=master)](https://codecov.io/github/mmitch/knittr?branch=master)\n[![Known Vulnerabilities](https://snyk.io/test/github/mmitch/knittr/badge.svg)](https://snyk.io/test/github/mmitch/knittr)\n[![GPL 3+](https://img.shields.io/badge/license-GPL%203%2B-blue.svg)](http://www.gnu.org/licenses/gpl-3.0-standalone.html)\n\n\nabout\n-----\n\nknittr is a tool to brush up knitting patterns for printing.  You can\nfor example start with a 16x16 pixel smilie icon and generate a\nfull-page knitting pattern from it.\n\nFeatures are:\n\n- scalable vector graphics output\n- multi-page output (eg. use full page width and generate multiple\n  pages vertically)\n- configurable grid, column and row numbers\n- mark every other row (distingish left and right rows)\n\nThe project homepage is at \u003chttps://github.com/mmitch/knittr/\u003e\n\n\nbut why\n-------\n\nMy wife wanted to create her own knitting patterns.  The internet is\nfull of instructions saying \"open Gimp, zoom in 1600%, activate the\ngrid, print a screenshot\", which from my nerd standpoint is totally\nlame and has certain drawbacks:\n\n- resolution is limited by your screen size\n- no row and column numbering\n- only square pixels (stitches are seldom square as I have learnt)\n\nSo I first wrote a [shell script][1] to overcome these limitations and\nmake my wife happy.  In the end, things escalated, the shell script\nturned into this Java application, I got My Little Pony themed\nsweaters and pillows out of it as well as my own [Java GUI library][2]\nand multiple nights of coding.  Yaaaay!\n\n   [1]: \u003chttps://github.com/mmitch/mitchscripts/blob/master/bash/knit.sh\u003e\n   [2]: \u003chttps://github.com/mmitch/cgarbs-javalib/\u003e\n\n\ndependencies\n------------\n\n- for running knittr:\n  - Java runtime (at least Java 6)\n\n- for building knittr:\n  - Gradle build environment\n  - bash, perl for extended build tools (both optional)\n\n\nusage\n-----\n\n\tusage: knittr.jar [options ...] [--] [\u003cinputfile\u003e]\n\t\n\tavailable options:\n\t  --layout=\u003clayout\u003e    - set layout\n\t  --style=\u003cstyle\u003e      - set look and feel\n\t  --help               - show this help text\n\t\n\tuse `help' for \u003clayout\u003e or \u003cstyle\u003e to a list available options\n\n\nquickstart guide\n----------------\n\n1. Run ``java -jar knittr.jar`` to start a new knittr project.\n\n2. Select a bitmap to be converted as ``source file``.\n   The bitmap will show up in the preview.  Small bitmaps with few\n   and different colors will work best.  The bitmap needs to be\n   preprocessed so that one pixel corresponds to one stitch.\n\n3. Select a ``target file`` to contain the result of the conversion.\n   Target file format is SVG.  This file will be overwritten!\n\n4. Go to the ``gauge swatch`` tab and enter the ``stitches`` and\n   ``rows`` values for your yarn.  ``stitches`` means the number of\n   horizontal stitches you need to knit 10cm (4in), while ``rows``\n   means the number of vertical rows you need to knit 10cm (4in).\n   Both values are used to provide proper scaling of your output.\n\n5. Select ``Render to SVG``.  Afterwards, open and print the generated\n   SVG with your favourite SVG editor or viewer.\n\n6. You can ``Save`` and ``Load`` knittr projects for later use or for\n   experimenting with different settings.\n\n7. Try out the settings in the other tabs!\n\n\nbuilding with Gradle\n--------------------\n\nBuilding via ``build.gradle`` should be straightforward.\n\nThere are some additional build targets available:\n\n* ``run`` directly starts the knittr UI\n\n* ``fullJar`` builds a jar containing all dependencies in\n  ``build/libs/knittr-full.jar``\n\n* ``fixit`` runs a bash script to fix line breaks and indentation on\n  empty lines\n\n* ``checkl10n`` checks the .property files for missing translations\n\n* ``publishDropbox`` and ``publishDropboxFull`` copy the generated jars\n  to my Dropbox to sync them to my wife's computer - this propably is of\n  no use to you :-)\n\n\ncopyright\n---------\n\nknittr - brush up knitting patterns for printing  \nCopyright (C) 2014  Christian Garbs \u003cmitch@cgarbs.de\u003e\nLicensed under GNU GPL v3 (or later)\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 \u003chttp://www.gnu.org/licenses/\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmitch%2Fknittr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmmitch%2Fknittr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmitch%2Fknittr/lists"}