Fyne (software)
{{refimprove|date=August 2021}}
{{Other uses|Fyne (disambiguation)}}
{{short description|Graphical toolkit for building cross platform GUIs}}
{{Infobox software
| name = Fyne
| title =
| logo = Fyne.io_logo.png
| screenshot = Fyne_demo-1.4-dark.png
| caption = Screenshot of fyne_demo showcasing many widgets
| author = Andrew Williams
| developer = Andrew Williams, Cedric Bail, Changkun Ou, Charles Daniels, Drew Weymouth, Jacob Alzén, Luca Corbo, Pablo Fuentes, Simon Dassow, Steve O'Connor, Stephen Houston, Stuart Scott, Tilo Prütz
| released = {{Start date and age|2018|02|05}}
| ver layout =
| latest release version = 2.6.1
| latest release date = {{Start date and age|2025|05|08}}{{cite web
| url = https://github.com/fyne-io/fyne/releases/tag/v2.6.1
| title = Bug fixes, remove races and some thread warning refinements
| website = github.com| date = 2025-06-17
}}
| latest preview version =
| latest preview date =
| programming language = Go
| operating system = Linux, Unix-like, macOS, Windows, IOS, Android (operating system)
| platform =
| genre = Widget toolkit
| license = New BSD License
| website = {{URL|https://fyne.io}}
}}
Fyne is a free and open-source cross-platform widget toolkit for creating graphical user interfaces (GUIs) across desktop and mobile platforms. It is designed to enable developers to build applications that run on multiple desktop and mobile platforms/versions from a single code base.{{cite web |url=https://dev.to/aurelievache/learning-go-by-examples-part-7-create-a-cross-platform-gui-desktop-app-in-go-44j1 | title= Learning Go by examples: part 7 - Create a cross-platform GUI/Desktop app in Go |last= Aurélie|first = Vache| date=25 August 2021}} Fyne uses OpenGL to provide cross-platform graphics. It is inspired by the principles of Material Design to create applications that look and behave consistently across all platforms.{{cite web |url=https://developer.fyne.io/architecture/geometry |title = Scaling and Geometry}} It is licensed under the terms of the 3-clause BSD License, supporting the creation of free and proprietary applications. In December 2019 Fyne became the most popular GUI toolkit for Go, by GitHub star count{{cite tweet |author=Fyne |user=Fyne_io |number=1207621758414704640 |date=2019-12-19 |title=We are very excited to announce that Fyne is now the most popular* GUI toolkit for Go! Great news and a huge milestone :). Now we need to figure how to bring the joy of Fyne to the wider coding community. [*] According to GitHub stargazer count ⭐️ #golang #winning #future |language=en |access-date=2021-01-07}} and in early February 2020 it was trending as #1 project in GitHub trending ranks.{{cite tweet |author=Fyne |user=Fyne_io |number=1227238218879291398 |date=2020-02-11 |title=Oh wow, the @Fyne_io project is currently in the #1 slot on GitHub trending list!!! https://t.co/oeRtXklEK9 #congratulations #goland #gui #trending https://t.co/HMy1TpJ3u5 |language=en |access-date=2021-01-07}}
Development
Fyne is currently developed by a team of volunteers and is supported by around 40 contributors.{{Cite web | url=https://github.com/fyne-io/fyne/graphs/contributors | title=Contributors to fyne-io/fyne · GitHub | website=GitHub | date=2020-02-25}} Members of this group also work on the FyneDesk project to create a new Linux desktop environment.{{cite tweet |last=Houston |first=Stephen |user=stephenmhouston |number=1212078602889641984 |date=2019-12-31 |title=I am so proud of how far we have made it with this desktop in less than a year of work. It is a really great experience and very aesthetically pleasing. Please consider using it if you are a #linux user! #fyne #golang #go #linuxdesktop #desktop https://t.co/jKqWriYrIG |language=en |access-date=2021-01-07}}
The Fyne toolkit is written primarily in Go.{{Cite web | url=https://changelog.com/gotime/116 |title = Unusual uses for Go: GUIs (Go Time #116)| date=6 February 2020 }} The team focuses on clean APIs and follows the principles of Clean Code to sustain maintainability of the project.{{Cite web | url=https://github.com/fyne-io/fyne/blob/master/CONTRIBUTING.md |title = fyne/CONTRIBUTING.md at master · fyne-io/fyne · GitHub |website = GitHub |date = 2020-02-25}} All Fyne projects are continuously tested to check correctness, stability as well as formatting and documentation.{{Cite web | url=https://travis-ci.org/fyne-io |title = Fyne.io - Travis CI}}{{Cite web | url=https://coveralls.io/github/fyne-io |title = Coveralls.io - Test Coverage History and Statistics}}
Example
The code required for a simple "Hello World" application is minimal, as follows:
package main
import (
"fyne.io/fyne/v2/app"
"fyne.io/fyne/v2/container"
"fyne.io/fyne/v2/widget"
)
func main() {
a := app.New()
w := a.NewWindow("Hello")
hello := widget.NewLabel("Hello Fyne!")
w.SetContent(container.NewVBox(
hello,
widget.NewButton("Hi!", func() {
hello.SetText("Welcome :)")
}),
))
w.ShowAndRun()
}
To build this application you will need the Go language and a C compiler installed, as well as a graphics driver that supports OpenGL.
It can be built and run using the command:
$ go run main.go
Design
Design of the Fyne API and user interface components follows a careful process to ensure the simplicity.{{Cite web | url=https://changelog.com/posts/the-careful-process-behind-fynes-simplicity |title = The careful process behind Fyne's simplicity}} The Fyne toolkit is built in various layers, with each in separate packages. Notable layers include:Archived at [https://ghostarchive.org/varchive/youtube/20211205/jbsYrrNiqAs Ghostarchive]{{cbignore}} and the [https://web.archive.org/web/20201030041222/https://www.youtube.com/watch?v=jbsYrrNiqAs&gl=US&hl=en Wayback Machine]{{cbignore}}: {{cite web| url = https://www.youtube.com/watch?v=jbsYrrNiqAs| title = GoLab 2019 - Andrew Williams - Easily build cross platform graphical applications with Fyne | website=YouTube| date = 7 November 2019 }}{{cbignore}}
=API=
API, or Application programming interface, is an interface or protocol that allows for communication across different parts of the software. Fyne has a self-documenting API that is also extensible resulting in the ability for each developer to create custom tools unique to their project that will mesh with Fyne itself.
=Vector graphics=
The use of vector graphics to paint the UI provides a method of adapting to different device and display sizes without losing image fidelity. This allows the programmer to only need to create the UI once and it will look as expected on any device.
=Hierarchy=
==Canvas==
Canvas contains all of the contents of a window ranging from the full screen to a group of CanvasObjects.
==CanvasObject==
CanvasObjects are what actually get rendered on screen such as Text, Rectangle, Line. The objects store size, position and color information for the rendering process.
==Container==
Containers are groups of CanvasObjects, each container can specify a layout which will contain the sizing and position of its child components. Layouts help the developer arrange components in a manner that response to the container or window size, with several layout types provided including Border, Center, and Grid.
==Widget==
All of the components of a window in a CanvasObject are widgets that contain standard user interface elements. Fyne widgets include but are not limited to UI basics such as: Button, Check, Form, Hyperlink, Label,
Radio, Select and Toolbar as well as container widgets like AppTabs and Split. Since 1.4 there are additional collection widgets that provide high-performance presentation of large data in a List, Table or Tree view. All the built-in UI widgets ensure that standard aspects of GUI interactivity act in a predictable and expected way across applications. This helps improve quality of programs while assisting the programmer by removing the need for them to create these tools themself.
=Packages=
All components of Fyne are split into packages and then connected via the API to create a final GUI application. In addition to the canvas, layout, and widget packages, notable packages include:
- App package which is the main entry point for the app which manages understanding the type of device the application is running on and ensures the code will run as expected on that device.
- Test package enabling test-driven development to validate the GUI itself functions as expected.
Use
The largest project currently using the Fyne toolkit is the FyneDesk project, a complete desktop environment for Linux.{{Cite web | url=https://github.com/fyne-io/desktop/ |title = A full desktop environment for Linux/Unix using Fyne: Fyne-io/Desktop|website = GitHub|date = 2020-02-24}}
There are many other applications being built using the toolkit, those that are open source can be found in an application listing{{Cite web | url=https://apps.fyne.io/ | title=Fyne Apps Listing}} website managed by the project.
Many businesses are using the Fyne toolkit to quickly add a graphical user interface to command line tools which they have already built using Go. {{Citation needed|date=October 2021|reason=Language is vague/unsubstantiated and reads somewhat like an advertisement.}}
References
{{Reflist|30em}}
Bibliography
{{Refbegin}}
- {{citation
| last = Williams
| first = Andrew
| title = Hands-On GUI Application Development in Go
| date = 25 February 2019
| url = https://www.packtpub.com/gb/application-development/hands-gui-application-development-go
| edition = 1st
| publisher = Packt
| isbn = 978-1-78913-841-2}}
- {{citation
| last = Schilli
| first = Mike
| title = Linux Magazine 229 - Straight to the Point
| date = 1 November 2019
| publisher = Linux New Media
| url = http://www.linux-magazine.com/Issues/2019/229/Straight-to-the-Point}}
- {{citation
| last = Williams
| first = Andrew
| title = Building Cross-Platform GUI Applications with Fyne
| date = 25 January 2021
| url = https://www.packtpub.com/product/building-cross-platform-gui-applications-with-fyne/9781800563162
| edition = 1st
| publisher = Packt
| isbn = 978-1-80056-316-2}}
- {{citation
| last = Bail
| first = Cédric
| title = GNU Linux Magazine / France 262 - Application Native Moderne en Go
| date = March 2023
| publisher = Les Éditions Diamond
| url = https://boutique.ed-diamond.com/home/1651-gnulinux-magazine-262.html}}
- {{citation
| last = Bail
| first = Cédric
| title = GNU Linux Magazine / France 263 - Application Native Moderne en Go: Manipulation de Données, Tests Unitaires, Intégration et GitHub
| date = May 2023
| publisher = Les Éditions Diamond
| url = https://boutique.ed-diamond.com/home/1651-gnulinux-magazine-263.html}}
- {{citation
| last = Williams
| first = Andrew
| title = Linux Magazine 273 - Designing Cross-Platform GUI Apps with Fyne
| date = August 2023
| publisher = Linux New Media
| url = https://www.linux-magazine.com/Issues/2023/273/GUI-Apps-with-Fyne}}
{{Refend}}
External links
- {{Official website|https://fyne.io}}
- [https://demo.fyne.io Fyne demo online]
- [https://fyne.io/develop/ Developer guides]
- [https://godoc.org/fyne.io/fyne/v2 GoDoc documentation]
{{Widget toolkits}}