Skip to content

Repository files navigation

gingaf

License: MIT

gingaf is an MIT-licensed, multi-platform implementation of the interactive TV middleware Ginga standardised by ITU-T and SBTVD.

Architecture

The gingaf repository is organized as a host-centric monorepo: the root directory (.) contains the Flutter visual host application for Ginga applications. It depends on core Dart packages in packages/ncldoc/ (the headless execution engine, see packages/ncldoc/README.md) and packages/ccws/ (the web service library, see packages/ccws/README.md).

The web interactive playground and player are located in node/, which also provides the ginga-node package.

User-level applications built on top of gingaf include ginga-playground (for web-based evaluation) and ginga-code (a Visual Studio Code extension for application development).

block-beta
columns 3
  playground["playground"]
  ginga_code["ginga-code"]
  space
  web["gingaf (web)"]
  desktop["gingaf (desktop)"]
  mobile["gingaf (mobile)"]
  gingaf["gingaf"]:3
  ncldoc["ncldoc"]:2
  ccws["ccws"]:1
Loading

Demonstration Videos

Windows

windows.mp4

Android

android.mp4

Chrome

chrome.mp4

NCL headless

cli.mp4

Playground Ginga-NCL (video.ncl)

playground-ncl.mp4

Playground Ginga-HTML5 (current_service.html)

playground-html.mp4

Playground Ginga-NCL with Lua (lua.ncl)

playground-lua.mp4

Launch Ginga Application from VSCode

vscode.mp4

gingaf (desktop) run applications from local examples/

All example NCL and HTML documents are stored in the examples/ folder. You can configure and run the application via APP environment variable (e.g. examples/image.ncl or examples/image.html).

flutter run -d windows --dart-define="APP=examples/image.ncl"
flutter run -d windows --dart-define="APP=examples/video.ncl"

For convenience, you can use make run-example for the current platform:

make run-example app=viode.ncl
make run-example app=image.html

gingaf (web, mobile) run applications from URLs

flutter run -d chrome --dart-define="APP=https://raw.githubusercontent.com/ginga-org-br/gingaf/refs/heads/main/examples/video.ncl"

About

Cross-platform implementation of Ginga standard (ITU-T H.761, ABNT NBR 15606)

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages