Trivial.Console 2.1.0

.NET Standard 2.0
Suggested Alternatives

Trivial.Console 6.0.0

Additional Details

Please update to the latest version.

There is a newer version of this package available.
See the version list below for details.
Install-Package Trivial.Console -Version 2.1.0
dotnet add package Trivial.Console --version 2.1.0
<PackageReference Include="Trivial.Console" Version="2.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Trivial.Console --version 2.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Trivial.Console, 2.1.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Trivial.Console as a Cake Addin
#addin nuget:?package=Trivial.Console&version=2.1.0

// Install Trivial.Console as a Cake Tool
#tool nuget:?package=Trivial.Console&version=2.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.


You can use the library for your console application to parse the arguments, write the selection, dispatch verbs, etc.


Just add following namespace to your code file to use.

using Trivial.Console;


You can parse the arguments which is in string array or just in string to a readable object by programming.

// Suppose the arguments is:
// a.exe --name Kingcean Tuan --say Hello

void Main(string[] args)
    var arguments = new Arguments(args);
    Console.WriteLine("{0} {1}", arguments["say"], arguments["name"]);

    // Console -> Hello Kingcean Tuan

It still work well when the arguments is from a string.

void Main(string[] args)
    var str = Console.ReadLine();

    // Suppose the str is:
    // hijklmn abcdefg

    var arguments = new Arguments(str);
    Console.WriteLine("{0} {1}", arguments[1], arguments[0]);

    // Console -> abcdefg hijklmn


If your application contains a set of functionalities, you may need verbs to help you to build a more flexible console application. Each verb can has its own business logic. The arguments will be filled into the property with attribute ArgumentAttribute.

class FirstVerb: Verb
    public string Name { get; set; }

    public override string Description => "Test 1";

    public override void Process()
        Console.WriteLine("This is the verb handler 1.");
        Console.WriteLine("Name is {0}.", Name);
        Console.WriteLine("Name is {0}.", Arguments["name"]);

And you can also define a verb handler with async process method.

class SecondVerb: AsyncVerb
    public override string Description => "Test 2";

    public override async Task Process()
        Console.WriteLine("This is the verb handler 2. Step 1.");
        await Task.Run(() => {
            Console.WriteLine("This is the verb handler 2. Step 2.");

Then you can use dispatcher to dispatch the correct verb handler to process.

static async Task Main(string[] args)
    var dispatcher = new Dispatcher();

    await dispatcher.ProcessAsync(args);

    // a.exe one --name Test
    // Console -> This is the verb handler 1.
    // Console -> Name is Test.
    // Console -> Name is Test.

    // a.ext two
    // Console -> This is the verb handler 2. Step 1.
    // Console -> This is the verb handler 2. Step 2.


You can write a specified string value to the standard output stream and then change it. Following is a sample.

var Main(string[] args)
    var line = new Line();
    // Write something.
    line.Write("Loading {0}......", "something");

    // Remove some charactors and add other string with color.
    line.Write(ConsoleColor.Green, "  Done!");

    // And you can append other string following above in the same line and in the default color.
    line.Write(" This is only for test.");

    // Add terminator.

    // You cannot add further terminator if there is no any string output.

    // So following will be in a new line.
    line.Write("Next line. ");

    // We can turn off the auto flush so that all strings write later will be in an output queue.
    line.AutoFlush = false;
    line.Write(ConsoleColor.Red, ConsoleColor.Yellow, "Red foreground and yellow background");
    line.Write("This will not be output immediately, neither.");

    // Now let's write them.

    // Following will not output until we call Flush member method or set AutoFlush property as true.
    line.Write(" Hello?");
    line.AutoFlush = true;


You can output a list to console and let user select one just by arrow in keyboard.

var Main(string[] args)
    // Create an instance for adding items and setting options.
    var col = new SelectionData<string>();

    // Add some items. For each item, you can set a string value,
    // an additional data, an additional displayed title and an additional hot key.
    col.Add('a', "char a", "a", "char [a]");
    col.Add('b', "char b", "b", "char [b]");
    for (var i = 0; i < 120; i++)
        col.Add("num " + i, i.ToString());

    // Create an options for display.
    var options = new SelectionOptions
        // You can define a question string after the list.
        Question = "Please select one: ",

        // We can define the colors of the item selected.
        SelectedForegroundColor = ConsoleColor.White,
        SelectedBackgroundColor = ConsoleColor.Blue,

        // The selected item will also be displayed after the question string.
        // So you can define its color.
        DefaultValueForegroundColor = ConsoleColor.Cyan,

        // At the end of the list, the tips will be displayed before user press any key.
        // There is a default value and you can customize it.
        // And you can disable it by set it as null.
        Tips = "Tips: You can use arrow key to select and press ENTER key to continue.",

        // Then you can define its color.
        TipsForegroundColor = ConsoleColor.Yellow,

        // You can define the prefix for the item and the one selected.
        SelectedPrefix = "√ ",
        Prefix = " ",

        // You can define the column count for the list.
        Column = 5,

        // You can define the maximum rows to displayed.
        // A paging will be displayed if the count of the list is greater than it.
        MaxRow = 10,

        // Press ESC can cancel this selection.
        // But you can enable the manual way by set a manual question
        // so that user can type the words directly.
        ManualQuestion = "Type: "

    // Write it to the standard output stream and wait for user selection.
    var result = LineUtilities.Select(col, options);

    // You can get the result.
    Console.WriteLine("The result is {0}.", result.Value);
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
6.4.0 82 4/14/2022
6.3.0 70 3/8/2022
6.2.0 148 1/30/2022
6.1.0 75 1/23/2022
6.0.0 94 1/1/2022
5.2.0 117 12/15/2021
5.1.0 106 12/2/2021
5.0.0 110 11/27/2021
4.0.0 136 11/9/2021
3.9.0 122 12/15/2021
3.8.0 192 11/9/2021
3.7.2 348 4/22/2021
3.7.1 227 4/20/2021
3.7.0 301 3/17/2021
3.6.0 496 11/12/2020
3.5.2 569 4/14/2020
3.5.1 632 4/12/2020
3.5.0 663 4/1/2020
3.4.0 755 2/20/2020
3.3.0 861 2/14/2020
3.2.0 1,211 1/22/2020
3.1.0 1,236 12/30/2019
3.0.1 1,154 12/26/2019
2.2.0 910 2/19/2020
2.1.0 1,267 12/24/2019
2.0.0 1,182 8/31/2019
1.2.0 1,239 5/20/2019
1.1.0 1,189 5/8/2019
1.0.0 1,207 5/1/2019