All the characters that work on most terminals and most operating systems.

Background

While ASCII characters display correctly on all terminals, this is not the case of all characters. When building a terminal application or tool, it is common to experience cross-platform issues like:

The main reasons are:

The terminal font might not include this specific character.
The terminal encoding may not support Unicode. For example, cmd.exe on Windows often use specific encodings like CP437, CP850 or Windows-1252.
The application might not be properly converting encodings when reading or writing terminal characters.

The first two points can be solved by using characters known to display correctly on most terminals and environments.

This repository contains a list of those characters:

in this README.md
as a characters.txt file
as a binary printing the full list
as a Node.js module for programmatic usage

List of characters

The following characters work on most terminals. This was tested on:

Ubuntu 20.10, Gnome terminal 3.38.0
macOS 10.14, terminal.app 2.9
Windows 10.0.17763, cmd.exe (CP850)
VSCode 1.54.3 terminal (xterm.js)

Those terminals are sufficient to catch most cross-platform issues. However, if some characters listed below do not display correctly on your terminal, please submit an issue to add your terminal.

When the character is displayed, its Unicode codepoint is shown above it.

ASCII

Characters with Unicode codepoints 0020-007f work on all terminals.

Control characters 0000-001f and 0080-009f have varying levels of support. However, the most commonly used ones work on all terminals.

Western languages

Characters with Unicode codepoints 00a0-058f and 1d00-1fff work on most terminals. They include:

Box drawing

2588 2593 2592 2591
██   ▓▓   ▒▒   ░░
258c 2590 2580 2584
▌▌   ▐▐   ▀▀   ▄▄
25ac 25a0 25aa 25a1 25ab
▬▬   ■■   ▪▪   □□   ▫▫

2500 2012 2014 2015 2501 2550
─    ‒    —    ―    ━    ═
203e
‾
2504 2505 2508 2509 254c 254d
┄┄   ┅┅   ┈┈   ┉┉   ╌╌   ╍╍
2212 2574 2013 2010 2578 2576
−−   ╴╴   ––   ‐‐   ╸╸   ╶╶
2043 257a 257c 257e
⁃⁃   ╺╺   ╼╼   ╾╾

2502 2503 2551 2016 2506 2507
│    ┃    ║    ‖    ┆    ┇
250a 205e 250b 254e 254f 2575
┊    ⁞    ┋    ╎    ╏    ╵
2579 2577 257b 257d 257f
╹    ╷    ╻    ╽    ╿

250c 256d 250f 250d
┌    ╭    ┏    ┍
250e 2554 2552 2553
┎    ╔    ╒    ╓
2510 256e 2513 2511
┐    ╮    ┓    ┑
2512 2557 2555 2556
┒    ╗    ╕    ╖
2514 2570 2517 2515
└    ╰    ┗    ┕
2516 255a 2558 2559
┖    ╚    ╘    ╙
2518 256f 251b 2519
┘    ╯    ┛    ┙
251a 255d 255b 255c
┚    ╝    ╛    ╜
251c 2523 251d 251e 251f 2520
├    ┣    ┝    ┞    ┟    ┠
2521 2522 2560 255e 255f
┡    ┢    ╠    ╞    ╟
2524 252b 2525 2526 2527 2528
┤    ┫    ┥    ┦    ┧    ┨
2529 252a 2563 2561 2562
┩    ┪    ╣    ╡    ╢
252c 2533 252d 252e 252f 2530
┬    ┳    ┭    ┮    ┯    ┰
2531 2532 2566 2564 2565
┱    ┲    ╦    ╤    ╥
2534 253b 2535 2536 2537 2538
┴    ┻    ┵    ┶    ┷    ┸
2539 253a 2569 2567 2568
┹    ┺    ╩    ╧    ╨
253c 254b 253d 253e 253f 2540
┼    ╋    ┽    ┾    ┿    ╀
2541 2542 2543 2544 2545 2546
╁    ╂    ╃    ╄    ╅    ╆
2547 2548 2549 254a
╇    ╈    ╉    ╊
256c 256a 256b
╬    ╪    ╫

2573 2572 2571 2044 2215
╳    ╲     ╱    ⁄    ∕

Geometrical shapes

2024 2219 2022 25e6
․    ∙    •    ◦
25cb 25cc 25cf
○    ◌    ●
25b2 25bc 25c4 25ba
▲    ▼    ◄    ►
25b4 25be 25c2 25b8
▴    ▾    ◂    ▸
2190 2191 2192 2193 2194 2195
←    ↑    →    ↓    ↔    ↕
2302 25ca 25d8 25d9
⌂    ◊    ◘    ◙

Punctuation

2026 2030 203c 203d
…    ‰    ‼    ‽

2018 2019 201a 201b
‘    ’    ‚    ‛
201c 201d 201e 201f
“    ”    „    ‟
2032 2033 2e17 2039 203a
′    ″    ⸗    ‹    ›

Numbers and math

2248 2260 2261 2264 2265
≈    ≠    ≡    ≤    ≥

2202 2206 220f 2211 221a 221e
∂    ∆    ∏    ∑    √    ∞
221f 2229 222b 2310 2320 2321
∟    ∩    ∫    ⌐    ⌠    ⌡

2153 2154 2155 2156 2157 2158
⅓    ⅔    ⅕    ⅖    ⅗    ⅘
2159 215a 215b 215c 215d 215e
⅙    ⅚    ⅛    ⅜    ⅝    ⅞

2070 2074 2075 2076 2077 2078
⁰    ⁴    ⁵    ⁶    ⁷    ⁸
2079 2071 207f
⁹    ⁱ    ⁿ
207a 207b 207c 207d 207e
⁺    ⁻    ⁼    ⁽    ⁾
2080 2081 2082 2083 2084 2085
₀    ₁    ₂    ₃    ₄    ₅
2086 2087 2088 2089
₆    ₇    ₈    ₉
2090 2091 2092 2093 2094
ₐ    ₑ    ₒ    ₓ    ₔ
208a 208b 208c 208d 208e
₊    ₋    ₌    ₍    ₎

24ea 2460 2461 2462 2463 2464
⓪   ①   ②    ③    ④    ⑤
2465 2466 2467 2468 2469 246a
⑥   ⑦    ⑧   ⑨    ⑩    ⑪
246b 246c 246d 246e 246f 2470
⑫   ⑬   ⑭   ⑮   ⑯   ⑰
2471 2472 2473
⑱   ⑲   ⑳
24ff 2776 2777 2778 2779 277a
⓿   ❶    ❷   ❸    ❹    ❺
277b 277c 277d 277e 277f 24ef
❻   ❼    ❽    ❾    ❿   ⓯
24f0 24f1 24f2 24f3 24f4
⓰   ⓱   ⓲    ⓳   ⓴

Other symbols

2020 2021 263a 263b 263c 2736
†    ‡    ☺    ☻    ☼    ✶
2640 2642 2660 2663 2665 2666
♀    ♂    ♠    ♣    ♥    ♦
266a 266b 266f
♪    ♫    ♯

2105 2113 2116 2117 2122 2126
℅    ℓ    №    ℗    ™    Ω
212e 2132 214d 214e 2183 2184
℮    Ⅎ    ⅍    ⅎ    Ↄ    ↄ

20a0 20a1 20a2 20a3 20a4 20a5
₠    ₡    ₢    ₣    ₤    ₥
20a6 20a7 20a8 20a9 20aa 20ab
₦    ₧    ₨    ₩    ₪    ₫
20ac 20ad 20ae 20af 20b0 20b1
€    ₭    ₮    ₯    ₰    ₱
20b2 20b3 20b4 20b5 20b6 20b7
₲    ₳    ₴    ₵    ₶    ₷
20b8 20b9 20ba 20bd 20bf 0e3f
₸    ₹    ₺    ₽    ₿    ฿

Miscellaneous

2c60 2c61 2c62 2c63 2c64 2c65
Ⱡ    ⱡ    Ɫ    Ᵽ    Ɽ    ⱥ
2c66 2c67 2c68 2c69 2c6a 2c6b
ⱦ    Ⱨ    ⱨ    Ⱪ    ⱪ    Ⱬ
2c6c 2c6d 2c6e 2c6f 2c70 2c71
ⱬ    Ɑ    Ɱ    Ɐ    Ɒ    ⱱ
2c72 2c73 2c74 2c7e 2c7f
Ⱳ    ⱳ    ⱴ   Ȿ    Ɀ
2c75 2c76 2c77 2c78 2c79 2c7a
Ⱶ    ⱶ    ⱷ    ⱸ    ⱹ    ⱺ
2c7b 2c7c 2c7d
ⱻ    ⱼ    ⱽ

a717 a718 a719 a71a a71b a71c
ꜗ     ꜘ     ꜙ     ꜚ     ꜛ    ꜜ
a71d a71e a71f a720 a721
ꜝ    ꜞ    ꜟ    ꜠     ꜡
a788 a789 a78a a78b a78c
ꞈ    ꞉    ꞊    Ꞌ    ꞌ

fb00 fb01 fb02 fb03 fb04 fb05
ﬀ    ﬁ    ﬂ    ﬃ   ﬄ    ﬅ
fb06
ﬆ

fb13 fb14 fb15 fb16 fb17
ﬓ   ﬔ    ﬕ   ﬖ    ﬗ

API

A Node module is available to retrieve the list of characters above or test specific characters.

Install

npm install cross-platform-terminal-characters

Usage

const {
  regex,
  codepoints,
  characters,
} = require('cross-platform-terminal-characters')

// false, i.e. cross-platform
console.log(regex.test('≈'))
// true, i.e. not cross-platform
console.log(regex.test('≐'))
// Remove not cross-platform characters, i.e. print `example ≈ test  text`
console.log('example ≈ test ≐ text'.replace(regex, ''))

// Array of codepoint integers: [0x0000, 0x0001, ..., 0xfb17]
console.log(codepoints)
// Array of single-character strings: ['\x00', '\x01', ..., 'ﬗ']
console.log(characters)

CLI

The following command prints the full list of characters and their codepoints.

npx cross-platform-terminal-characters

If you don't have npm installed, the full list is available in characters.txt

Support

For any question, don't hesitate to submit an issue on GitHub.

Everyone is welcome regardless of personal background. We enforce a Code of conduct in order to promote a positive and inclusive environment.

Contributing

This project was made with ❤️. The simplest way to give back is by starring and sharing it online.

If the documentation is unclear or has a typo, please click on the page's Edit button (pencil icon) and suggest a correction.

If you would like to help us fix an error or add more information, please check our guidelines. Pull requests are welcome!

bshanks / cross-platform-terminal-characters Goto Github PK

cross-platform-terminal-characters's Introduction