BigLog is a flexible logging library for C#. It supports output to console and file, with configurable prefixes, timestamps, log levels, and optional colors.

ℹ️ Colors are only applied to console output. When logging to a file or using the cache, colored output is disabled. If cache logging is flushed to the terminal, Color_fallback is used.

ℹ️ By default, all log levels are enabled. You can set minimum log levels for both terminal and file outputs to filter messages.

ℹ️ Logging to services like Azure Application Insights or Seq is not supported in this version but it is under development.

using BigLog;

class Program
{
    static void Main()
    {
        Logger logger = new Logger()
        {
            LogToFile = true,
            UseShortPrefix = true
        };

        logger.Inf("Program started");
        logger.Suc("Operation successful");
        logger.War("Low memory warning");
        logger.Err("Failed to open file");
        logger.Ctm("Custom log message");
    }
}

All methods accept either a string or an Exception.

Example:

try
{
    throw new Exception("File read error");
}
catch (Exception ex)
{
    logger.Err(ex);
}

ℹ️ Log levels in increasing order are: Trace < Debug < Info < Success < Warning < Error < Critical < Fatal < Custom

ℹ️ Changing MinLogLevel sets both MinLogLevelTerminal and MinLogLevelFile to the same value.

Example:

logger.PrefixInf = "[INFO] ";
logger.PrefixErr = "[ERROR] ";

Default colors per level (console only):

Note: Colors cannot be used when logging to a file or when messages are cached. When cached messages are flushed to the terminal, Color_fallback is applied.

Example:

logger.ColorWar = ConsoleColor.Magenta;
logger.ColorErr = ConsoleColor.DarkRed;

If AutoFlush = false, messages are cached instead of being written immediately.

Logger logger = new Logger()
{
    AutoFlush = false,
    LogToFile = true
};

logger.Inf("Batch started...");
logger.War("Minor warning...");
logger.flushCache(); // writes all cached logs and clears cache afterwards

Additional cache commands:

logger.ClearCache(); // clears the cache without writing

Console output with colors

Logger logger = new Logger()
{
    LogToFile = false,
    ColorAll = true
};

File logging

Logger logger = new Logger()
{
    LogToTerminal = false,
    LogToFile = true,
};

Minimal output

Logger logger = new Logger()
{
    PrintTimeStamp = false,
    UseShortPrefix = true
};

This project is licensed under the GNU Affero General Public License (AGPL). See LICENSE for details.

Copyright © 2025 by Carl Öttinger

You can contact me via email at carl@oettinger.cloud or visit my website at bigvault.cloud.

Contributions are welcome! Please open issues or pull requests on the GitHub repository.