README.md

Eto.Forms

A cross platform desktop and mobile user interface framework

Description

This framework can be used to build applications that run across multiple platforms using their native toolkit, with an easy to use API. This will make your applications look and work as a native application on all platforms, using a single UI codebase.

For advanced scenarios, you can take advantage of each platform's capabilities by wrapping your common UI in a larger application, or even create your own high-level controls with a custom implementations per platform.

This framework currently supports creating Desktop applications that work across Windows Forms, WPF, MonoMac, and GTK#. There is a Mobile/iOS port in the works, but is considered incomplete.

This framework was built so that using it in .NET is natural. For example, a simple hello-world application might look like:

using Eto.Forms;
using Eto.Drawing;

public class MyForm : Form
{
	public MyForm ()
	{
		Title = "My Cross-Platform App";
		ClientSize = new Size(200, 200);
		Content = new Label { Text = "Hello World!" };
	}
	
	[STAThread]
	static void Main()
	{
		new Application().Run(new MyForm());
	}
}

or in a F# script:

#load ".paket/load/eto.platform.windows.fsx"
// see https://fsprojects.github.io/Paket/paket-generate-load-scripts.html

open Eto.Drawing
open Eto.Forms

type MyForm() as this =
    inherit Form()
    do
        this.Title      <- "My Cross-Platform App"
        this.ClientSize <- Size (200, 200)
        this.Content    <- new Label(Text = "Hello F# World!")

Eto.Platform.Initialize(Eto.Platforms.WinForms)
let app = new Application()
let form = new MyForm()
form.Show()

Getting Started

To begin creating apps using Eto.Forms, follow the Quick Start Guide.

To compile or contribute to Eto.Forms, read the Contributing Guide.

Screenshots

Windows via WPF:

Mac via MonoMac:

Linux via GTK#3:

Applications

• MonoGame Pipeline Tool - Content manager for MonoGame
• Manager - Accounting Software
• PabloDraw - Character based drawing application
• Notedown - Note taking application
• Eto.Test - Application to test the functionality of each widget
• DWSIM - Chemical Process Simulator
• Termission - Cross-platform Serial/TCP Terminal with Scriptable Auto-Response
• Visual SEO Studio - Technical SEO Auditing Tool
• RegexFileSearcher - Cross-platform regex file searching tool in .NET 5
• RegexTestBench - Cross-platform regex testing tool in .NET 5
• GEDKeeper (v3) - Cross-platform application for working with personal genealogical databases

Third party libraries

	Pure Eto.Forms	SkiaSharp edition
ScottPlot			Plotting library that makes it easy to interactively display large datasets.
LiveCharts			Simple, flexible, powerful and open source data visualization for .Net.
Microcharts			Create elegant Cross-Platform simple charts.
OxyPlot			Cross-platform plotting library for .NET.
Mapsui			A C# map component for apps.
Eto.RainbowLoading			A control showing the Android loading indicator.
Eto.GifImageView			A control for displaying GIF's.
Eto.SkiaDraw			A control enabling use of SkiaSharp in Eto.
Eto.Containers			Some extra Eto.Forms container controls.

👉 Note : Some packages are in the pipeline but will not appear until next release is created.

Assemblies

Your project only needs to reference Eto.dll, and include the corresponding platform assembly that you wish to target. To run on a Mac platform, you need to bundle your app.

• Eto.dll - Eto.Forms (UI), Eto.Drawing (Graphics), and platform loading
• Eto.Mac.dll - MonoMac platform for OS X using 32-bit mono
• Eto.Mac64.dll - MonoMac platform for OS X using 64-bit mono
• Eto.XamMac.dll - Xamarin.Mac Classic platform for OS X to embed mono
• Eto.XamMac2.dll - Xamarin.Mac Unified platform for OS X to embed mono
• Eto.WinForms.dll - Windows Forms platform using GDI+ for graphics
• Eto.Direct2D.dll - Windows Forms platform using Direct2D for graphics
• Eto.Wpf.dll - Windows Presentation Foundation platform
• Eto.Gtk.dll - Gtk+3 platform for Mac, Windows, and Linux.
• Eto.Gtk2.dll - Gtk2 platform using gtk-sharp2 on Mac, Windows, and Linux.
• Eto.Gtk3.dll - [deprecated] Gtk3 platform for running on Linux with gtk-sharp3 package
• Eto.iOS.dll - Xamarin.iOS platform
• Eto.Android.dll - Xamarin.Android platform

Currently supported targets

• OS X: MonoMac or Xamarin.Mac
• Linux: GTK# 2 or 3
• Windows: Windows Forms (using GDI or Direct2D) or WPF

Under development

These platforms are currently incomplete or in development. Any eager bodies willing to help feel free to do so!

• iOS using Xamarin.iOS
• Android using Xamarin.Android (Eto.Android)