blob: bab5c2421259518c4e1104863ce8446b389fd627 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
# Supported Languages
There are currently two languages that have an additional
Astal package: Lua and Gjs. Their purpose is to abstract away
Gtk by implementing a state management and UI declaring solution.
## JavaScript
The main intended usage of Astal is in TypeScript+JSX.
It is recommended to use [AGS](/guide/typescript/first-widgets) to scaffold and run projects in TypeScript.
However, if you are familiar with JavaScript's tooling
ecosystem you can also setup an environment yourself.
Only a minimal knowledge of JavaScript's syntax is needed to get started.
:::info
The runtime is [GJS](https://gitlab.gnome.org/GNOME/gjs) and **not** nodejs
:::
Examples:
- [Simple Bar](https://github.com/Aylur/astal/tree/main/examples/gtk3/js/simple-bar)
- [Notification Popups](https://github.com/Aylur/astal/tree/main/examples/gtk3/js/notifications)
- [Applauncher](https://github.com/Aylur/astal/tree/main/examples/gtk3/js/applauncher)
- [Media Player](https://github.com/Aylur/astal/tree/main/examples/gtk3/js/media-player)
## Lua
Lua is well-supported, but I would still recommend TypeScript, as Lua lacks a type system, which in turn limits editor support.
Examples:
- [Simple Bar](https://github.com/Aylur/astal/tree/main/examples/gtk3/lua/simple-bar)
- [Notification Popups](https://github.com/Aylur/astal/tree/main/examples/gtk3/lua/notifications)
- [Applauncher](https://github.com/Aylur/astal/tree/main/examples/gtk3/lua/applauncher)
- [Media Player](https://github.com/Aylur/astal/tree/main/examples/gtk3/lua/media-player)
## Python
There is a WIP [package for python](https://github.com/aylur/astal/tree/feat/python),
to bring declaritivity to Python similar to the above two languages.
However, you can still use python the OOP way [pygobject](https://pygobject.gnome.org/tutorials/gobject/subclassing.html) intended it in the meantime.
Examples:
- [Simple Bar](https://github.com/Aylur/astal/tree/main/examples/gtk3/py/simple-bar)
## Vala
Vala is a language that simply put uses C# syntax and compiles to C.
It is the language most of Astal is written in. I would still recommend
using TypeScript or Lua over Vala as they are simpler to work with.
Examples:
- [Simple Bar](https://github.com/Aylur/astal/tree/main/examples/gtk3/vala/simple-bar)
## C
I don't recommend using C as it requires quite a lot of boilerplate, both for
build step and code.
Examples:
- TODO
## Other languages
There a few more that supports gobject-introspection, most notably Haskell, Rust and C++.
If you are interested and feel like contributing, PRs are welcome for bindings, and examples.
|
