https://github.com/codeation/impress
Go GUI cross-platform library
https://github.com/codeation/impress
cross-platform desktop-gui go golang gtk-3 gui gui-library impress
Last synced: 2 months ago
JSON representation
Go GUI cross-platform library
- Host: GitHub
- URL: https://github.com/codeation/impress
- Owner: codeation
- License: mit
- Created: 2018-05-26T19:11:37.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2025-03-05T07:22:42.000Z (4 months ago)
- Last Synced: 2025-03-13T23:34:11.787Z (4 months ago)
- Topics: cross-platform, desktop-gui, go, golang, gtk-3, gui, gui-library, impress
- Language: Go
- Homepage: https://codeation.github.io/impress/
- Size: 273 KB
- Stars: 20
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# impress. Go GUI cross-platform library
[](https://pkg.go.dev/github.com/codeation/impress)
See the [project site](https://codeation.github.io/impress/) for technical details and [a library overview](https://codeation.github.io/impress/library-overview.html).
Some usage examples are in the [examples folder](https://github.com/codeation/impress/tree/master/examples).
## Hello World Example
Let's say hello:
```
package main
import (
"image"
"image/color"
"github.com/codeation/impress"
"github.com/codeation/impress/event"
_ "github.com/codeation/impress/duo"
)
func main() {
app := impress.NewApplication(image.Rect(0, 0, 480, 240), "Hello World Application")
defer app.Close()
font := app.NewFont(15, map[string]string{"family": "Verdana"})
defer font.Close()
w := app.NewWindow(image.Rect(0, 0, 480, 240), color.RGBA{255, 255, 255, 255})
defer w.Drop()
w.Text("Hello, world!", font, image.Pt(200, 100), color.RGBA{0, 0, 0, 255})
w.Line(image.Pt(200, 120), image.Pt(300, 120), color.RGBA{255, 0, 0, 255})
w.Show()
app.Sync()
for {
e := <-app.Chan()
if e == event.DestroyEvent || e == event.KeyExit {
break
}
}
}
```
See an explanation of the source code in [a library overview](https://codeation.github.io/impress/library-overview.html).
### To run this example on Debian/Ubuntu:
0. Install `gcc`, `make`, `pkg-config` if you don't have them installed.
1. Install GTK+ 3 libraries if you don't have them installed:
```
sudo apt-get install libgtk-3-dev
```
2. Build impress terminal from source:
```
git clone https://github.com/codeation/it.git
cd it
make
cd ..
```
3. Then run the example:
```
git clone https://github.com/codeation/impress.git
cd impress
IMPRESS_TERMINAL_PATH=../it/it go run ./examples/simple/
```
Steps 0-2 are needed to build an impress terminal binary. See the [impress terminal page](https://codeation.github.io/impress/it-driver.html) for other options for downloading or building the impress terminal.
## Technical details
Basic Principles of Library Design:
- Performance of the application as well as native applications.
- Simple and clean application code.
- Creating a GUI application without a form designer or hard-coded widgets.
The main idea is to stay away from the event-driven programming paradigm. See the ["What's wrong with event-driven programming"](https://codeation.github.io/impress/what-is-wrong-with-event-oriented-programming.html) page for more details.
The library uses [a separate application (GTK+ 3 terminal)](https://codeation.github.io/impress/it-driver.html) for drawing instead of binding a low-level library to Golang.
## Project State
- The project is currently in its beta stage. It is highly suitable for the development of in-house applications.
- The project was tested on Debian 12.9 and macOS 15.3.
- While the API remains stable, please note that the specific details may be subject to change.
[The project roadmap](https://codeation.github.io/impress/roadmap.html) includes both short-term and long-term project stages.
A cross-platform [mind-map application](https://codeation.github.io/lineation/) is being developed to showcase the core principles of the library.
## Contributing
First, welcome:
- Any clue to keep the project going (star, post, link, etc.).
- Any recommendations about library design principles.
- Contributions to the project, documentation, examples.
- Bug report, open an [issue](https://github.com/codeation/impress/issues).
- Or any help to fix grammatical or writing errors (PR or issue).