{"id":17911269,"url":"https://github.com/petethepig/marmot","last_synced_at":"2025-10-19T18:13:29.476Z","repository":{"id":7410827,"uuid":"8742545","full_name":"petethepig/marmot","owner":"petethepig","description":"Font Squirrel CLI","archived":false,"fork":false,"pushed_at":"2019-07-31T07:01:00.000Z","size":108,"stargazers_count":40,"open_issues_count":2,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-17T10:06:09.278Z","etag":null,"topics":["fontsquirrel","ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/petethepig.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":"2013-03-13T01:32:34.000Z","updated_at":"2023-06-30T01:31:37.000Z","dependencies_parsed_at":"2022-08-20T13:10:49.224Z","dependency_job_id":null,"html_url":"https://github.com/petethepig/marmot","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/petethepig%2Fmarmot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petethepig%2Fmarmot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petethepig%2Fmarmot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petethepig%2Fmarmot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/petethepig","download_url":"https://codeload.github.com/petethepig/marmot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221919917,"owners_count":16901866,"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":["fontsquirrel","ruby"],"created_at":"2024-10-28T19:37:33.319Z","updated_at":"2025-10-19T18:13:29.421Z","avatar_url":"https://github.com/petethepig.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Marmot — Unofficial [Font Squirrel Webfont Generator](http://www.fontsquirrel.com/tools/webfont-generator/) Client \n\nMarmot automates font-face generation, making it easier and faster:\n\n    marmot Averia-Regular.ttf         # ls .   =\u003e   webfontkit.zip\n\nMarmot supports Font Squirrel configuration files:\n\n    marmot  -c generator-config.txt  font.otf\n\nIt is especially useful when it comes to your own icon fonts:\n\n    marmot  -c config.txt  my-icon-font.otf  my-icon-font.zip\n\n### Great, how do I install Marmot?\n\nMarmot is a ruby gem:\n\n    gem install marmot\n\n### Okay, how do I configure it?\n\nFont Squirrel Webfont Generator has **a lot of** options and by default Marmot will use default ones.\n\nEvery Font Squirrel webfont kit comes with a text file called **generator_config.txt**. Marmot can read it:\n\n    marmot  -c generator-config.txt  font.otf\n\nSince the config is actually just a JSON file, you can write your own configs. I use this one for my icons:\n```json\n{\n  \"formats\":[\"ttf\", \"woff\", \"svg\"],\n  \"fallback\":\"none\",\n  \"subset_custom_range\":\"E000-F8FF\",\n  \"emsquare\":\"1000\"\n}\n```\n\nYou can do the same thing from the command line:\n\n    marmot  --no-add-hyphens  --formats=ttf,woff  font.otf\n\nHere is a full list of options:\n\n```bash\n                         --mode \u003cs\u003e\n                      --formats \u003cs\u003e \n                --tt-instructor \u003cs\u003e \n             --fix-vertical-metrics\n                         --fix-gasp\n                   --remove-kerning\n                       --add-spaces\n                      --add-hyphens\n                     --fallback \u003cs\u003e\n              --fallback-custom \u003ci\u003e\n                          --webonly\n               --options-subset \u003cs\u003e\n                 --subset-range \u003cs\u003e\n                --subset-custom \u003cs\u003e\n          --subset-custom-range \u003cs\u003e\n                           --base64\n                       --style-link\n               --css-stylesheet \u003cs\u003e\n                  --ot-features \u003cs\u003e\n              --filename-suffix \u003cs\u003e\n                     --emsquare \u003ci\u003e\n           --spacing-adjustment \u003ci\u003e\n                        --agreement\n```\n\n### Oh, this is great, but what is \"tt-instuctor\" or \"subset-custom\"?\n\nSome option names can be confusing. Go to [generator's page](http://www.fontsquirrel.com/tools/webfont-generator) and run this in the console:\n\n```js\n  $(\"input[value='expert'], input[value='advanced']\").click();\n  $(\"table input\").each(function(){\n    $(this).after($(\"\u003cdiv style='color:red;'\u003e\"+$(this).attr(\"name\")+\" : \"+$(this).attr(\"value\")+\"\u003c/div\u003e\"));\n  });\n```\n![Options](https://raw.github.com/petethepig/marmot/master/doc/js-snippet.png)\n\n### What else?\nSince Marmot is a ruby gem, you can use it in your ruby projects:\n```ruby\nrequire 'marmot'\n\nclient = Marmot::Client.new\nclient.convert File.new(\"font.ttf\"), { \n  formats: [\"ttf\", \"woff\"] \n}\n```\n\n### I found a lousy bug, what do I do?\n\nPlease, report it on the [Issues page](https://github.com/petethepig/marmot/issues).\n\nOr [contact me on Twitter](https://twitter.com/dmi3f)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetethepig%2Fmarmot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpetethepig%2Fmarmot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetethepig%2Fmarmot/lists"}