consoleframework

by elw00d

Cross-platform toolkit for easy development of TUI applications.

463 Stars 52 Forks Last release: over 4 years ago (v0.2-release) MIT License 391 Commits 3 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Console Framework

NuGet

Console framework is cross-platform toolkit that allows to develop TUI applications using C# and based on WPF-like concepts.

Features

  • Declarative markup (custom lightweight XAML implementation)
  • Data binding (integrated with XAML markup)
  • Retained mode rendering system
  • WPF-compatible simple and flexible layout system
  • A lot of controls available (including Grid, ScrollViewer, ListBox, ComboBox)
  • Routed events system (compatible with WPF)
  • Windows, Mac OS X and Linux (64-bit) support

Install from NuGet

NuGet package is available here https://www.nuget.org/packages/Elwood.ConsoleFramework

Build from source

To build a library with examples you can use standard dotnet tool:

dotnet build

It should work in all platforms.

Running examples

In Windows

dotnet run --project ExamplesStandalone/ManyControls

In Linux

# Copy native dependencies before run
mkdir -p ExamplesStandalone/ManyControls/bin/Debug/netcoreapp3.0/
unzip native/libtermkey-0.18-x86_64.zip -d ExamplesStandalone/ManyControls/bin/Debug/netcoreapp3.0/

Build and run project

dotnet run --project ExamplesStandalone/ManyControls

Press Ctrl+D to exit application.

Running unit tests

dotnet test Tests

Development

There were two IDEs where I've worked with .NET Core project: Visual Studio 2017 Community and JetBrains Rider. Both of them works well with this source code.

Native dependencies

For Windows there are no native dependencies required. But in Linux and Mac OS X environments you should prepare some native dependencies to be able to execute examples. Dependencies are:

  • libtermkey
  • libc
  • ncursesw

To build libtermkey go to its source code directory and simply run

make

After that you can copy binaries from ./libs into directory with examples. Or you can use binaries of libtermkey from zip in /native directory.

Libc and ncursesw are distributed in binaries in vast majority of Linux distros and OS X, so all you need is locate actual binaries and copy them in the output directory if the target machine does not have them, for example, if you are Mac OS X user, you will need to install libtermkey.

brew install --universal libtermkey

Console Framework expects that libraries will be available strictly by these names on Linux. If your system already has symlinks libc.so.6 and libncursesw.so.5, you can skip this step.

Mono support

Support of Mono runtime have been discontinued. If you need library for Mono, you can download previous releases. All further development will be continued for .NET Core runtime only.

Terminal emulators in Mac OS X

Standard terminal emulator is not very good for console applications deals with mouse. My recommendation is to use ITerm2. ITerm2 provides a good emulation with mouse support. If you want to see how console framework renders in various Mac emulators, visit http://elwood.su/2014/02/console-framework-on-mac/

License

Copyright 2011-2018 I. Kostromin

License: MIT/X11

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.