Chromium-based cross-platform / cross-language application framework
Thrust is require/import
-able, it lets you distribute NodeJS, Go or Python GUI apps directly
through their native package managers.
Thrust is based on Chromium's Content Module and is supported on Linux, MacOSX and Windows:
Screenshot of Thrust Getting Started example running on each major platform.
Thrust will be powering the next versions of Breach.
To better understand what Thrust can do, check out JankyBrowser by @morganrallen (forked by @LeoColomb), the cross-platform browser that fits in a gist:
npm install -g https://gist.github.com/LeoColomb/993506f47fe10e234123
- Language bindings
- API Reference
- Architecture
- Community
- Features & Roadmap
- Building Thrust from Sources
Thrust's binary distribution exposes its API on the standard IO and language specific library packages automatically download the binary distribution at installation. Thrust is based on Chromium's content module and uses web-pages as its GUI.
All these Getting Started example work as is on each major platform (MacOSX, Windows, Linux)
First install with npm install node-thrust
require('node-thrust')(function(err, api) {
api.window({ root_url: 'https://breach.cc' }).show();
});
- node-thrust breach/node-thrust
First download with go get -u github.com/miketheprogrammer/go-thrust/
package main
import (
"github.com/miketheprogrammer/go-thrust/dispatcher"
"github.com/miketheprogrammer/go-thrust/spawn"
"github.com/miketheprogrammer/go-thrust/window"
)
func main() {
spawn.Run()
thrustWindow := window.NewWindow("http://breach.cc/", nil)
thrustWindow.Show()
thrustWindow.Maximize()
thrustWindow.Focus()
dispatcher.RunLoop()
}
- go-thrust: miketheprogrammer/go-thrust
First install with pip3 install pythrust [--user]
(requires Python3)
import asyncio, pythrust
loop = asyncio.get_event_loop()
api = pythrust.API(loop)
asyncio.async(api.spawn())
asyncio.async(api.window({ 'root_url': 'http://breach.cc' }).show())
loop.run_forever()
- pythrust breach/pythrust
Include scala-thrust jar on your classpath. (Add to lib in your project.)
import scala.concurrent.ExecutionContext.Implicits.global
import com.github.eklavya.thrust._
object Main extends App {
Window.create("http://google.com").foreach { w =>
w.show
w.maximize
w.openDevtools
w.focus(true)
w.onBlur(() => println("we were blurred"))
w.onFocus(() => println("we were focused"))
Menu.create("MyMenu").foreach { m =>
val i = MenuItem("Item1", _ => println("Item1 was clicked"))
m.addItem(i)
m.popup(w)
}
}
}
- scala-thrust eklavya/scala-thrust
The API reference as well as links to specific language bindings documentations are availble in the docs/ directory.
[Thrust Architecture]
(Platform) [stdio] (Your Implementation)
#
+--------------+ # +-----------------------+ |
| Cocoa / Aura | # +---| win3: (HTML/JS) | |
+-------+------+ # | +-----------------------++ |
| # +--| win2: (HTML/JS) | | cli
+------------+ +-------+------+ # | +-----------------------++ |
| +-+ thrust (C++) +-------+-+ win1: (HTML/JS) | |
| ContentAPI | +-------+------+ # +-----------------------+ |
| | | # | (TCP/FS)
| (Blink/v8) | +-------+------+ # +-----------------------+ |
| | + JSON RPC srv +---------+ Client App (any Lang) | | srv
+------------+ +--------------+ # +-----------------------+ |
#
- List of API needed by various projects on Thrust: Request for API
- List of people relying on Thrust: List of Thrust Users
- 7.5k max Browser implementation based on Thrust. Coming soon. Ping dev@breach.cc if interested! (Credits to @morganrallen for the awesome idea)
- Mailing list: breach-dev@googlegroups.com
- IRC Channel: #breach on Freenode
- window creation create, show, close resize, minimize, maximize, ...
- node.js, go node.js and go bindings libraries
- window events close, blur, focus, unresponsive, crashed
- cross-platform equivalent support on
MacOSX
,Windows
andLinux
- sessions off the record, custom storage path, custom cookie store
- kiosk kiosk mode
- application menu global application menu (MacOSX, X11/Unity)
- webview webview tag (secure navigation, tabs management)
- frameless frameless window and draggable regions
- python python bindings library
- remote thrust specific IPC mechanism for client/server communication
- proxy enable traffic proxying (Tor, header injection, ...)
- tray icon tray icon native integration
- protocol specific protocol registration (
file://
, ...)
You will generally don't need to build thrust yourself. A binary version of thrust should be automatically fetched by the library you're reyling on at installation.
To build thrust, you'll need to have python 2.7.x
and git
installed. You can
then boostrap the project with:
./scripts/boostrap.py
Build both the Release
and Debug
targets with the following commands:
./scripts/update.py
./scripts/build.py
Note that bootstrap.py
may take some time as it checks out brightray
and
downloads libchromiumcontent
for your platform.