<img src="https://raw.githubusercontent.com/rawpython/remi/master/remi/res/logo.png" width="430"> <h2 align="center" style="font-weight:bolder"> GUI library for your Python applications </h2> Remi is a GUI library for Python applications that gets rendered in web browsers. This allows you to access your interface locally and remotely.

Proud to be sponsored by

Do you need support?

<a href="https://www.reddit.com/r/RemiGUI" style="font-size:25px">Reddit - (subreddit RemiGUI)</a>

There is also a drag n drop GUI Editor. Look at the Editor subfolder to download your copy.

<a href="https://vimeo.com/517626422" style="font-size:25px">A demonstrative video from the great REVVEN labs</a>

Getting Started

For a stable version:

pip install remi

For the most updated experimental version Download or check out Remi from git and install

python setup.py install

or install directly using pip

pip install git+https://github.com/rawpython/remi.git

Then start the test script (download it from github https://github.com/rawpython/remi/blob/master/examples/widgets_overview_app.py):

python widgets_overview_app.py

Remi

Platform independent Python GUI library. In less than 100 Kbytes of source code, perfect for your diet.

Remi enables developers to create platform independent GUI with Python. The entire GUI is rendered in your browser. No HTML is required, Remi automatically translates your Python code into HTML. When your app starts, it starts a web server that will be accessible on your network.

A basic application appears like this:

import remi.gui as gui
from remi import start, App

class MyApp(App):
    def __init__(self, *args):
        super(MyApp, self).__init__(*args)

    def main(self):
        container = gui.VBox(width=120, height=100)
        self.lbl = gui.Label('Hello world!')
        self.bt = gui.Button('Press me!')

        # setting the listener for the onclick event of the button
        self.bt.onclick.do(self.on_button_pressed)

        # appending a widget to another, the first argument is a string key
        container.append(self.lbl)
        container.append(self.bt)

        # returning the root widget
        return container

    # listener function
    def on_button_pressed(self, widget):
        self.lbl.set_text('Button pressed!')
        self.bt.set_text('Hi!')

# starts the web server
start(MyApp, port=8081)

In order to see the user interface, open your preferred browser and type "http://127.0.0.1:8081". You can change the URL address by specific **kwargs at start function call. This will be discussed later.

Tested on Android, Linux, Windows. Useful on Raspberry Pi for Python script development. It allows interacting with your Raspberry Pi remotely from your mobile device.

FAQ

Why another GUI lib? Kivy, PyQT, and PyGObject all require native code for the host operating system, which means installing or compiling large dependencies. Remi needs only a web browser to show your GUI.
Do I need to know HTML? NO, It is not required, you have to code only in Python.
Is it open source? For sure! Remi is released under the Apache License. See the LICENSE file for more details.
Do I need some kind of web server? No, it's included.

Brief tutorial

Import Remi library and some other useful stuff.

import remi.gui as gui
from remi import start, App

Subclass the App class and declare a main function that will be the entry point of the application. Inside the main function you have to <code>return</code> the root widget.

class MyApp(App):
    def __init__(self, *args):
        super(MyApp, self).__init__(*args)

    def main(self):
        lbl = gui.Label("Hello world!", width=100, height=30)

        # return of the root widget
        return lbl

Outside the main class, start the application by calling the function start and passing the name of the class you declared previously as the parameter:

# starts the webserver
start(MyApp, port=8081)

Run the script. If it's all OK the GUI will be opened automatically in your browser, otherwise, you have to type in the address bar "http://127.0.0.1:8081".

You can customize optional parameters in the start call like:

start(MyApp, address='127.0.0.1', port=8081, multiple_instance=False, enable_file_cache=True, update_interval=0.1, start_browser=True, dynamic_web_address=True)

Parameters:

address: network interface IP
port: listen port
multiple_instance: boolean, if True multiple clients that connect to your script has different App instances (identified by unique cookie session identifier)
enable_file_cache: boolean, if True enable resource caching
update_interval: GUI update interval in seconds. If zero, the update happens at each change. If zero, the App.idle method is not called.
start_browser: boolean that defines if the browser should be opened automatically at startup
standalone: boolean, indicates where to run the application as a standard Desktop application with its own window. If False, the interface is shown in a browser webpage.

Additional Parameters:

username: for a basic HTTP authentication
password: for a basic HTTP authentication
certfile: SSL certificate filename
keyfile: SSL key file
ssl_version: authentication version (i.e. ssl.PROTOCOL_TLSv1_2). If None disables SSL encryption
dynamic_web_address: set it to True if the server is not aware of the IP address and the URL the user will be opening the app with. If so, the JavaScript code will use hostname and port in the browser. This parameter is False by default.

All widgets constructors accept two standards**kwargs that are:

width: can be expressed as int (and is interpreted as a pixel) or as str (and you can specify the measuring unit like '10%')
height: can be expressed as int (and is interpreted as a pixel) or as str (and you can specify the measuring unit like '10%')

Events and callbacks

Widgets expose a set of events that happen during user interaction. Such events are a convenient way to define the application behavior. Each widget has its own callbacks, depending on the type of user interaction it allows. The specific callbacks for the widgets will be illustrated later.

In order to register a function as an event listener you have to call a function like eventname.do (i.e. onclick.do) passing as parameters the callback that will manage the event. Follows an example:

import remi.gui as gui
from remi import start, App

class MyApp(App):
    def __init__(self, *args):
        super(MyApp, self).__init__(*args)

    def main(self):
        container = gui.VBox(width=120, height=100)
        self.lbl = gui.Label('Hello world!')
        self.bt = gui.Button('Press me!')

        # setting the listener for the onclick event of the button
        self.bt.onclick.do(self.on_button_pressed)

        # appending a widget to another, the first argument is a string key
        container.append(self.lbl)
        container.append(self.bt)

        # returning the root widget
        return container

    # listener function
    def on_button_pressed(self, widget):
        self.lbl.set_text('Button pressed!')
        self.bt.set_text('Hi!')

# starts the web server
start(MyApp)

In the shown example self.bt.onclick.do(self.on_button_pressed) registers the self's on_button_pressed function as a listener for the event onclick exposed by the Button widget. Simple, easy.

Listener's callbacks will receive the emitter's instance firstly, then all other parameters provided by the specific event.

Besides the standard event registration (as aforementioned), it is possible to pass user parameters to listener functions. This can be achieves appending parameters to the do function call.

import remi.gui as gui
from remi import start, App

class MyApp(App):
    def __init__(self, *args):
        super(MyApp, self).__init__(*args)

    def main(self):
        container = gui.VBox(width=120, height=100)
        self.lbl = gui.Label('Hello world!')
        self.bt = gui.Button('Hello name!')
        self.bt2 = gui.Button('Hello name surname!')

        # setting the listener for the onclick event of the buttons
        self.bt.onclick.do(self.on_button_pressed, "Name")
        self.bt2.onclick.do(self.on_button_pressed, "Name", "Surname")

        # appending a widget to another
        container.append(self.lbl)
        container.append(self.bt)
        container.append(self.bt2)

        # returning the root widget
        return container

    # listener function
    def on_button_pressed(self, widget, name='', surname=''):
        self.lbl.set_text('Button pressed!')
        widget.set_text('Hello ' + name + ' ' + surname)

# starts the web server
start(MyApp)

This allows great flexibility, getting different

Remi

Install / Use

README

Proud to be sponsored by

Do you need support?

Getting Started

Remi

FAQ

Brief tutorial

Events and callbacks