unicode-show

From Kicksecure
Jump to navigation Jump to search

Detect and annotate non-ASCII or suspicious Unicode characters in text or files.

SYNOPSIS[edit]

unicode-show [FILE]...

DESCRIPTION[edit]

unicode-show is a utility that reads text input (from standard input or files) and highlights suspicious Unicode characters, such as those outside the safe ASCII range. This tool is useful for identifying potentially malicious or misleading Unicode characters in source code, logs, or user input.

For each suspicious character, unicode-show prints:

  • The line it appears on, annotated with [U+XXXX] markers
  • A description including the character (if visible), Unicode codepoint, character name, and category

What is considered suspicious:

  • Characters outside the printable ASCII range (0x200x7E)
  • Control characters (excluding \n, \r, \t)
  • Any character not in the standard set of ASCII letters, digits, punctuation, and trailing whitespace

Output formatting:

  • Annotations are colorized using ANSI escape codes if stdout is a terminal and the environment is color-friendly
  • Red for inline [U+XXXX] markers
  • Cyan for character metadata descriptions

COLOR OUTPUT DISABLED IF[edit]

  • The environment variable NOCOLOR is set
  • TERM is set to dumb
  • Output is redirected (non-interactive terminal)

OPTIONS[edit]

This tool takes no options. Any arguments are treated as file paths. If no arguments are given, input is read from standard input.

EXIT STATUS[edit]

  • 0 No suspicious Unicode characters found
  • 1 Suspicious characters were detected
  • 2 An error occurred (e.g., file I/O or decoding failure)

EXAMPLES[edit]

Scan a file for suspicious characters:

unicode-show suspicious.txt

Scan multiple files:

unicode-show file1.txt file2.md

Scan input from a pipeline:

cat file1.txt

Disable color output:

NOCOLOR=1 unicode-show example.txt

ENVIRONMENT[edit]

  • NOCOLOR - disables color output if set
  • TERM - if set to dumb, disables color output


Notification image

We believe security software like Kicksecure needs to remain Open Source and independent. Would you help sustain and grow the project? Learn more about our 13 year success story and maybe DONATE!