https://github.com/i2097i/gluby-tk

A tool for creating GTK applications using Ruby and Glade
https://github.com/i2097i/gluby-tk

glade gnome gtk3 listen ruby

Last synced: about 1 month ago
JSON representation

A tool for creating GTK applications using Ruby and Glade

• Host: GitHub
• URL: https://github.com/i2097i/gluby-tk
• Owner: i2097i
• License: mit
• Created: 2017-03-25T20:23:58.000Z (over 8 years ago)
• Default Branch: develop
• Last Pushed: 2019-01-20T22:56:31.000Z (over 6 years ago)
• Last Synced: 2025-08-21T08:52:40.575Z (about 2 months ago)
• Topics: glade, gnome, gtk3, listen, ruby
• Language: Ruby
• Size: 42 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# GlubyTK

##### __Current Version:__

[![Gem Version](https://badge.fury.io/rb/gluby-tk.svg)](https://badge.fury.io/rb/gluby-tk)

##### CI Status:

> __Master:__ [![master](https://travis-ci.org/i2097i/gluby-tk.svg?branch=master)](https://travis-ci.org/i2097i/gluby-tk)

> __Develop:__ [![develop](https://travis-ci.org/i2097i/gluby-tk.svg?branch=develop)](https://travis-ci.org/i2097i/gluby-tk)

GlubyTK (Glade+Ruby+GTK) is a tool for creating GTK applications in Ruby with Glade.

## Installation

Add this line to your application's Gemfile:

    $ gem install gluby-tk

## Usage

The GlubyTK command line tool command is simply called ```gluby``` for simplicity.

### Create & run a new Gluby project

    $ gluby new my_app_name && cd my_app_name && gluby start

### Add a new glade template

Using [Glade](https://glade.gnome.org/), create a new widget template and save it to your project's 'interface' directory with the extension ```.glade```. Then from the root of your project run 

    

    $ gluby rebuild

This command will parse your template and create the required ruby class & bindings.

#### Listening for changes

GlubyTK uses the [guard/listen](https://github.com/guard/listen) gem to listen for any changes to your interface files. When a change is detected it essentially runs the ```gluby rebuild``` command automatically.

    $ gluby listen

> NOTE: If you want access to any Glade elements in Ruby code, you will need to define a value for the ```Composite -> Class``` or ```Non-composite -> ID``` field in Glade.

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/i2097i/gluby-tk.

> Feel free to send any comments/improvements suggestions.

## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).