Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/romgrk/node-gtk
GTK+ bindings for NodeJS (via GObject introspection)
https://github.com/romgrk/node-gtk
gnome gobject gobject-introspection gtk gtk3 nodejs
Last synced: 13 days ago
JSON representation
GTK+ bindings for NodeJS (via GObject introspection)
- Host: GitHub
- URL: https://github.com/romgrk/node-gtk
- Owner: romgrk
- License: mit
- Created: 2015-12-20T09:06:15.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-09-19T11:23:50.000Z (about 2 months ago)
- Last Synced: 2024-10-25T09:09:51.820Z (19 days ago)
- Topics: gnome, gobject, gobject-introspection, gtk, gtk3, nodejs
- Language: C++
- Homepage:
- Size: 3.85 MB
- Stars: 494
- Watchers: 15
- Forks: 42
- Open Issues: 79
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: COPYING
Awesome Lists containing this project
README
node-gtk
GNOME Gtk+ bindings for NodeJS
Node-Gtk is a [gobject-introspection](https://gi.readthedocs.io/en/latest) library for nodejs. It makes it possible to
use any introspected library, such as Gtk+, usable. It is similar in essence to [GJS](https://wiki.gnome.org/action/show/Projects/Gjs) or [PyGObject](https://pygobject.readthedocs.io). Please note this project is currently in a _beta_ state and is being developed. Any contributors willing to help
will be welcomed.
Supported Node.js versions: **16**, **18** (other versions should work but are untested)
Pre-built binaries available for: **Linux**, **macOS** (all supported versions except 18)
### Table of contents
- [Usage](#usage)
- [Documentation](#documentation)
- [Installing and building](#installing-and-building)
- [Target Platforms](#target-platforms)
- [Requirements](#requirements)
- [How to build on Ubuntu](#how-to-build-on-ubuntu)
- [How to build on Fedora](#how-to-build-on-fedora)
- [How to build on ArchLinux](#how-to-build-on-archlinux)
- [How to build on macOS](#how-to-build-on-macos)
- [How to build on Windows](#how-to-build-on-windows)
- [Testing the project](#testing-the-project)
- [Browser demo](#browser-demo)
- [Contributing](#contributing)
## Usage
Below is a minimal example of how to use the code, but take a look at
our [template](https://github.com/romgrk/node-gtk-template) or at
[react-gtk](https://github.com/codejamninja/react-gtk) to bootstrap your
project.
```javascript
const gi = require('node-gtk')
const Gtk = gi.require('Gtk', '3.0')
gi.startLoop()
Gtk.init()
const win = new Gtk.Window()
win.on('destroy', () => Gtk.mainQuit())
win.on('delete-event', () => false)
win.setDefaultSize(200, 80)
win.add(new Gtk.Label({ label: 'Hello Gtk+' }))
win.showAll()
Gtk.main()
```
See our [examples](./examples) folder for more examples, and in particular the
[browser demo source](https://github.com/romgrk/node-gtk/blob/master/examples/browser.js) for
a more complex application.
## Documentation
[Read our documentation here](./doc/index.md)
## Installing and building
Note that prebuilt binaries are available for common systems, in those cases building is not necessary.
##### Target Platforms
- **Linux**: prebuilt binaries available
- **macOS**: prebuilt binaries available
- **Windows**: no prebuilt binaries
### Requirements
- `git`
- `nodejs@10` or higher
- `python3` (for `node-gyp`)
- C compiler (`gcc@8` or higher, or `clang`)
### How to build on Ubuntu
Install basic dependencies.
```sh
sudo apt-get install \
build-essential git \
gobject-introspection \
libgirepository1.0-dev \
libcairo2 \
libcairo2-dev
```
At this point `npm install node-gtk` should already install, fallback and build `node-gtk` without problems.
### How to build on Fedora
Install basic dependencies:
```sh
sudo dnf install \
@development-tools \
nodejs \
nodejs-devel \
gobject-introspection \
gobject-introspection-devel \
gtk3 \
gtk3-devel \
cairo \
cairo-devel
```
After installing of packages, run `npm install node-gtk`.
### How to build on ArchLinux
The following should be the bare minimum to be able to build the project.
```sh
pacman -S --needed \
base-devel git \
nodejs npm \
gtk3 gobject-introspection \
cairo
```
Feel free to install all `base-devel` utilities.
After installing those packages, `npm install node-gtk` would do.
### How to build on macOS
Assuming you have [brew](http://brew.sh) installed, the following has been successfully tested on El Captain.
```sh
brew install git node gobject-introspection gtk+3 cairo
```
At this point `npm install node-gtk` should already install, fallback and build `node-gtk` without problems.
### How to build on Windows
Mandatory dependency is Visual C++ Build Environment: Visual Studio Build Tools (using "Visual C++ build tools" workload) or Visual Studio Community (using the "Desktop development with C++" workload).
The easiest/tested way to build this repository is within a _MinGW shell_ provided by the [MSYS2 installer](https://msys2.github.io/).
Once VS and its C++ compiler is available and MSYS2 installed, launch the MinGW shell.
```sh
# update the system
# in case of errors, wait for the update to complete
# then close and open again MingW shell
pacman -Syyu --noconfirm
# install git, gtk3 and extra dependencie
pacman -S --needed --noconfirm git mingw-w64-$(uname -m)-{gtk3,gobject-introspection,pkg-config,cairo}
# where to put the repository clone?
# pick your flder or use ~/oss (Open Source Software)
mkdir -p ~/oss/
cd ~/oss
# clone node-gtk there
git clone https://github.com/romgrk/node-gtk
cd node-gtk
# don't include /mingw64/include directly since it conflicts with
# Windows SDK headers. we copy needed headers to __extra__ directory:
./windows/mingw_include_extra.sh
# if MSYS2 is NOT installed in C:/msys64 run:
export MINGW_WINDOWS_PATH=$(./windows/mingw_windows_path.sh)
# first run might take a while
GYP_MSVS_VERSION=2017 npm install
```
The `GYP_MSVS_VERSION` could be 2017 or above.
Please verify [which version you should use](https://github.com/nodejs/node-gyp#installation)
The below blog post series will help you get started:
1. [Node.js GTK Hello World on Windows](https://ten0s.github.io/blog/2022/07/22/nodejs-gtk-hello-world-on-windows)
2. [Find DLLs and Typelibs dependencies for Node.js GTK Application on Windows](https://ten0s.github.io/blog/2022/07/25/find-dlls-and-typelibs-dependencies-for-nodejs-gtk-application-on-windows)
3. [Package Node.js GTK Application on Windows](https://ten0s.github.io/blog/2022/07/27/package-nodejs-gtk-application-on-windows)
#### Possible issue on MinGW shell
In case you are launching the general executable without knowing the correct platform,
the binary path might not be available.
In such case `python` won't be available either, and you can check via `which python` command.
If not found, you need to export the platform related binary path:
```sh
# example for the 32bit version
export PATH="/mingw32/bin:$PATH"
npm run install
```
This should do the trick. You can also check if there is any python at all via `pacman -Qs python`.
### Testing the project
If you'd like to test everything builds and work properly, after installing and building you can run any of the
examples:
```sh
node ./examples/hello-gtk.js
```
If you'll see a little window saying hello that's it: it works!
Please note in macOS the window doesn't automatically open above other windows.
Try Cmd + Tab if you don't see it.
#### Browser demo
If you'd like to test `./examples/browser.js` you'll need [WebKit2 GTK+](http://webkitgtk.org/) libary.
- in **Ubuntu**, you can `apt-get install libwebkit2gtk-3.0` (`4.0` works too) and try it out.
- in **Fedora**, you should run `sudo dnf install webkit2gtk3`
- in **ArchLinux**, you can `pacman -S --needed webkitgtk` and try it out.
- in **macOS**, there is no way to run it right now because `webkitgtk` was removed from homebrew
Once installed, you can `./examples/browser.js google.com` or any other page, and you might try the _dark theme_ out too:
```sh
# macOS needs to have the Adwaita theme installed
# brew install adwaita-icon-theme
# Usage: ./examples/browser.js [theme]
./examples/browser.js google.com dark
```
## Contributing
If you'd like to help, we'd be more than happy to have support. To setup your development environment, you can
run `npm run configure`. You can then build the project with `npm run build`.
- https://developer.gnome.org/gi/stable/index.html
- https://v8docs.nodesource.com/
- https://github.com/nodejs/nan#api
Don't hesitate to join our [Discord channel](https://discord.gg/r2VqPUV).
### Contributors
- [magcius](https://github.com/magcius)
- [WebReflection](https://github.com/WebReflection)
- [romgrk](https://github.com/romgrk)
- [wotzlaff](https://github.com/wotzlaff)