Chizl.ConsoleFonts 6.2.19.1

Chizl.ConsoleFonts

A lightweight, cross-platform .NET library for adding font styles to console applications using ANSI escape sequences.

📦 Installation

NuGet Package Manager

Install-Package Chizl.ConsoleFonts

.NET CLI

dotnet add package Chizl.ConsoleFonts

PackageReference

<PackageReference Include="Chizl.ConsoleFonts" />

Note: Omitting the version attribute automatically uses the latest stable release. To pin a specific version, use Version="x.x.x".

🎯 Features

• ✅ Simple, fluent API for console text styling
• ✅ Multiple font styles: Bold, Italics, <u>Underline</u>, Strike, Blink, and more
• ✅ Cross-platform support (.NET Standard 2.0/2.1)
• ✅ Zero dependencies
• ✅ Lightweight and performant
• ✅ Works with modern terminals that support ANSI escape sequences

📖 Available Styles

💡 Usage Examples

Basic Styling

Console.WriteLine($"This is my {FontStyles.Underline}UNDERLINE{FontStyles.Reset} text.");

Multiple Styles

Console.WriteLine($"This is my {FontStyles.Bold}{FontStyles.Italics}BOLD ITALICS{FontStyles.Reset} text.");
Console.WriteLine($"This is my {FontStyles.Underline}{FontStyles.Blink}UNDERLINE BLINK{FontStyles.Reset} text.");

Hiding Sensitive Information

// Good for logging without displaying sensitive data in console 
Console.WriteLine($"Password: {FontStyles.Invisible}secret123{FontStyles.Reset}");

🛠️ Properties

Each FontStyles instance provides the following properties:

• Name - Returns the name of the style (e.g., "BOLD", "UNDERLINE")
• Value - Returns the ANSI escape sequence string
• NumberValue - Returns the numeric ANSI escape value

var style = FontStyles.Bold; 
Console.WriteLine($"Name: {style.Name}");
// "BOLD" 
Console.WriteLine($"Value: {style.Value}");
// "\x1b[1m" 
Console.WriteLine($"Number: {style.NumberValue}"); // 1

⚙️ Requirements

• .NET Standard 2.0 or higher
• Terminal/console with ANSI escape sequence support
  • Windows Terminal ✅
  • PowerShell 7+ ✅
  • Linux/macOS terminals ✅
  • Legacy Windows Command Prompt (limited support)

⚠️ Important Notes

1. Always use FontStyles.Reset after applying styles to avoid style bleeding into subsequent text
2. Bold appearance depends on your terminal's font settings
3. Blink support varies by terminal (many modern terminals disable blinking)
4. Set Console.OutputEncoding = Encoding.UTF8; for best compatibility

📄 License

This project is licensed under the MIT License - see the LICENSE.md file for details.

🔗 Links

• GitHub Repository
• NuGet Package

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

Made with experience by Chizl