{"id":13493936,"url":"https://github.com/evilmartians/mono","last_synced_at":"2025-05-14T11:09:17.265Z","repository":{"id":37811547,"uuid":"474996294","full_name":"evilmartians/mono","owner":"evilmartians","description":"Free and open-source monospaced font from Evil Martians","archived":false,"fork":false,"pushed_at":"2025-04-14T10:45:05.000Z","size":9744,"stargazers_count":2385,"open_issues_count":6,"forks_count":20,"subscribers_count":29,"default_branch":"main","last_synced_at":"2025-05-07T23:54:32.783Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"ofl-1.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evilmartians.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","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":"AUTHORS.txt","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-03-28T12:40:17.000Z","updated_at":"2025-05-06T19:48:51.000Z","dependencies_parsed_at":"2024-01-13T19:42:17.443Z","dependency_job_id":"222bee40-16db-4fee-91fc-b2dc7a6e5c96","html_url":"https://github.com/evilmartians/mono","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilmartians%2Fmono","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilmartians%2Fmono/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilmartians%2Fmono/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilmartians%2Fmono/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evilmartians","download_url":"https://codeload.github.com/evilmartians/mono/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254129488,"owners_count":22019628,"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":[],"created_at":"2024-07-31T19:01:20.143Z","updated_at":"2025-05-14T11:09:17.258Z","avatar_url":"https://github.com/evilmartians.png","language":null,"funding_links":[],"categories":["Fonts","Others","Free fonts"],"sub_categories":["Monospaced"],"readme":"\u003cimg src=\"./documentation/icon.png\" width=\"208\" height=\"208\"\u003e\n\n# Martian Mono\n\nMartian Mono is a monospaced version of the Martian Grotesk font for code style design. It inherits Grotesk’s brutal and eye-catching aesthetics as well as all of its benefits—metrics equilibrium, readability and intelligibility, and convenience for web developers and designers who believe in a systematic approach to design.\n\n👉 **Get your [Martian Grotesk free trial](https://evilmartians.gumroad.com/l/martian-grotesk-font) on Gumroad or [buy it on MyFonts](https://www.myfonts.com/collections/martian-grotesk-font-martian-fonts) to support Mono development.**\n\n\u003cimg src=\"./documentation/martian-mono-character-set.png\" width=\"830\"\u003e\n\nThe typeface features a tall x-height, and it has vertical metrics which guarantee equal space is present above the cap height and under the baseline. The latter makes this typeface an on-screen workhorse: it is evenly placed on buttons, inputs, lists, and forms. When coupled together, all the above features make Martian Mono a reasonable choice for any user interface design.\n\nWhen choosing a font format, prefer `ttf` for variable and `otf` for static on macOS, and `ttf` for Windows.\n\n## Download\n\nDownload the latest package from the [releases page](https://github.com/evilmartians/mono/releases) or embed the font from [Google Fonts](https://fonts.google.com/specimen/Martian+Mono).\n\n## Styles\n\nMartian Mono consists of a variable font and 28 styles: Condensed to Semi Wide, Thin to Extra Bold.\n\n\u003cimg src=\"./documentation/martian-mono-font-styles.png\" width=\"830\"\u003e\n\nThe font has 4 styles on the width axis:\n\n| Short name | Full name | CSS percentage | CSS keyword |\n| --- | --- | ---: | --- |\n| sWd | Semi Wide | 112.5% | semi-expanded |\n| Std | Standard | 100% | normal |\n| Nr | Narrow | 87.5% | semi-condensed |\n| Cn | Condensed | 75% | condensed |\n\nAnd 7 weights:\n\n| Short name | Full name | CSS numeric | CSS keyword |\n| --- | --- | ---: | --- |\n| Th | Thin | 100 |  |\n| xLt | Extra Light | 200 |  |\n| Lt | Light | 300 |  |\n| Rg | Regular | 400 | normal |\n| Md | Medium | 500 |  |\n| Bd | Bold | 700 | bold |\n| xBd | Extra Bold | 800 |  |\n\n## Coding ligatures\n\nMartian Mono offers two sets of coding ligatures. The default set transforms sequences like `--\u003e` into a standard arrow for a cleaner look. For those who prefer unaltered symbols, the second set features spacing ligatures—where `--\u003e` remains two hyphens and a greater-than sign, with subtle spacing and vertical alignment tweaks for improved readability.\n\nRegular ligatures are enabled by default. To switch to spacing ligatures, activate the Stylistic Set #03 OpenType feature.\n\n\u003cimg src=\"./documentation/martian-mono-coding-ligatures.png\" width=\"830\"\u003e\n\n## OpenType features\n\n\u003cimg src=\"./documentation/martian-mono-opentype-features.png\" width=\"830\"\u003e\n\n## Font size and legibility\n\nOriginally designed for the screen, the glyph heights stick to the pixel grid on commonly used font sizes. In addition, it comes equipped with OpenType and TrueType hinting, and Martian Mono appears legible on most platforms, even when being rendered in small sizes.\n\nFor the best results, use the following pairs of size / line height:\n\n* 7.5 / 10 (or 14, 18, etc.) px\n* 10 / 12 (or 16, 20, etc.) px\n* 12.5 / 14 (or 18, 22, etc.) px\n* 15 / 20 (or 24, 28, etc.) px\n\n## Usage\n\n_You are welcome to add more hints on usage (especially on the desktop) via pull requests._\n\nFor user convenience, the static font version is named `Martian Mono`, while the variable font family is `Martian Mono VF`. This ensures both versions can be installed simultaneously without conflicts.\n\n### On the Web\n\nDownload the `woff2` package from the [releases page](https://github.com/evilmartians/mono/releases) to get the variable font in WOFF2 format ([see WOFF2 support matrix between browsers](https://caniuse.com/woff2)).\n\nConsult the following articles from Evil Martians' blog on how to use variable fonts:\n\n* [Variable fonts in real life: how to use and love them](https://evilmartians.com/chronicles/variable-fonts-in-real-life-how-to-use-and-love-them)\n* [The joy of Variable Fonts: getting started on the Frontend](https://evilmartians.com/chronicles/the-joy-of-variable-fonts-getting-started-on-the-frontend)\n\n### On the Desktop: choosing a variant\n\nFor better compatibility with various terminal emulators and text editors on the desktop, it is a good idea to install the font not as a single variable font but as several different fonts.\n\n- Manually\n  - See the [releases page](https://github.com/evilmartians/mono/releases), and download `otf` or `ttf` files.\n  - Install the fonts.\n- Windows\n  - See the [releases page](https://github.com/evilmartians/mono/releases), and download `ttf` files.\n  - Install the fonts.\n- macOS\n  - See the [releases page](https://github.com/evilmartians/mono/releases), and download `otf`. Install the fonts.\n  - Or, use [Homebrew](http://brew.sh/):\n    ```shell\n    brew install --cask font-martian-mono\n    ```\n\nNext, if your application has a font picker, just choose `Martian Mono` or `Martian Mono VF` and the variant you require.\n\nIf the configuration is done using a text file, use `Martian Mono` or `Martian Mono VF` for the default font variant (_Martian Mono Std Rg_), or try specifying the font name like `MartianMono-NrRg` for the _Nr Rg_ variant.\n\n#### Choosing a variant for a dark background\n\nWhen choosing a font variant for a darker (or pitch black) background for your terminal or text editor, consider choosing a \"lighter\" variant if the font looks \"too bold\" to you. White font on a dark background can have that effect, [see here for details](https://evilmartians.com/chronicles/variable-fonts-in-real-life-how-to-use-and-love-them#variable-fonts-in-practice).\n\nFor example, go for _Std Lt_ instead of _Std Rg_.\n\n### On the Desktop: line spacing\n\nOnce you install the font and start using it, you might notice that the picture might look quite confined:\n\n\u003cimg src=\"./documentation/line-spacing-1_0.png\"\u003e\n\nInstead, you might want to opt for something more readable and easy for the eyes if you like:\n\n\u003cimg src=\"./documentation/line-spacing-1_4.png\"\u003e\n\nThe difference is _line spacing_. Learn how to set it up below, and consult the _Font size and legibility_ chapter to learn about the best setting. Or, experiment yourself by setting different percentages (`120%`, `140%`) or paddings in pixels (`1`, `2`, `4`, and so on).\n\n#### Terminal emulators\n\n##### Terminal (macOS)\n\nPreferences → Profiles → (choose a profile) → Text → Font → [Change]. You will be met with a font picker dialog that has the _Line Spacing_ property.\n\n##### iTerm 2 (macOS)\n\nPreferences → Profiles → (choose a profile) → Text. Look for the `n/n` symbol that looks like a fraction. That's your line spacing, in percentage (100% is the default).\n\n##### Ghostty\n\nOpen or create a configuration file at `~/.config/ghostty/config`. Try the following settings (be sure to set the font size you like):\n\n```\nfont-family = \"Martian Mono\" /* or \"Martian Mono VF\" */\nfont-size = 14\nadjust-cell-height = 20%\n```\n\nRelaunch the terminal, or reload the configuration with `cmd+shift+,` (macOS) or `ctrl+shift+,` (Linux).\n\nConsult the official documentation on font rendering and options here: https://ghostty.org/docs/config\n\n##### kitty\n\nOpen the config file (`~/.config/kitty/kitty.conf`). Look for the `adjust_line_height` property and see the documentation.\n\n#### Text editors\n\n##### VS Code\n\nUse `\"editor.fontVariations\"` to define variable axis values for `Martian Mono VF`. For the static version (`Martian Mono`), use `\"editor.fontWeight\"`.\n\n```jsonc\n// settings.json\n{\n    \"editor.fontFamily\": \"'Martian Mono VF', 'Martian Mono', Menlo, monospace\",\n    \"editor.fontVariations\": \"'wdth' 100, 'wght' 350\",\n    /*\"editor.fontWeight\": \"350\",*/\n    \"editor.fontLigatures\": true, /*or use \"'ss03'\" for spacing ligatures*/\n    \"editor.fontSize\": 12.5,\n    \"editor.lineHeight\": 20,\n    \"workbench.fontAliasing\": \"auto\",\n}\n```\n\nThe `'wdth'` property can be set to any value between 75 and 112.5, while the `'wght'` property ranges from 100 to 800. For more details, refer to the [Styles](#styles) section.\n\nTo disable coding ligatures, set `\"editor.fontLigatures\"` to `false`. To enable spacing ligatures, use `\"editor.fontLigatures\"` with `\"'ss03'\"`.\n\nFor better rendering on high-DPI displays, I recommend setting the font aliasing method to `\"auto\"`.\n\n```jsonc\n// settings.json\n{\n    \"workbench.fontAliasing\": \"auto\",\n}\n```\n\n##### vim\n\nFor setting line spacing in GUI versions of vim, see [`linespace`/`lsp`](https://vimhelp.org/options.txt.html#%27linespace%27).\n\n##### Sublime Text\n\nOpen your preferences. Add the `line_padding_top` and `line_padding_bottom` parameters. Both set the padding for a line of text in pixels.\n\n## Roadmap\n\n* Cyrillic script for Bulgarian, Serbian, and Macedonian (work in progress)\n* Powerline symbols (not sure)\n* Italics (not sure)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevilmartians%2Fmono","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevilmartians%2Fmono","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevilmartians%2Fmono/lists"}