Skip to main content

Dispono is a synchronization program between your browser IDE and your local machine.

Project description



Dispono is a tool to synchronization your source code and run it inside a browser IDE.

It works cross-platform and cross-browser since it doesn't requires any plugins.

Currently supported browser IDE's:


pip install dispono

Only Python 3.6+ is supported.


  1. Write a python script:

    from dispono import Dispono
    async def task(ide):
        await ide.sync_code('print("Hello browser. :)")')
        await ide.run_code()
    Dispono(task, port=8080)

    The above code will open a server at port 8080, transfer the code to your browser IDE and run the code.

  2. Open your browser IDE (e.g. a CodinGame contest).

  3. Run the python script.

    When you start the script the first time, you have to execute a small javascript snippet inside the browser tab web console in order to connect to the server.

    All following runs will work out of the box for the same session.

Advanced usage


In combination with Quom, your multi-file C/C++ project can be easily synced with your web IDE. Quom generates a single file from all local included header and source files.

from io import StringIO

from dispono import Dispono
from quom import Quom

async def task(ide):
    dst = StringIO()
    Quom('main.cpp', dst)
    await ide.sync_code(dst.getvalue())
    await ide.run_code()

Dispono(task, port=8080)

How does it work

Dispono starts a lightweight web server serving a javascript file for your specific browser IDE.

The javascript file contains code to control the IDE (sync/run/get output) and a client instance.

After registration the client by the server, the server can send commands to the client.

The communication between server and client happens with

Planned features

  • Download code from web IDE.
  • Correctly forward console output to the server.
  • Support more web IDE's.
  • Support multiple clients at the same time.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Dispono-0.1.0.tar.gz (6.4 kB view hashes)

Uploaded Source

Built Distribution

Dispono-0.1.0-py3-none-any.whl (7.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page