Bubobubobubobubo / topos

Web Based Live Coding Environment. Inspired by the Monome Teletype.
https://topos.live
GNU General Public License v3.0
27 stars 10 forks source link
algorithmic-composition computer controller livecoding midi monome music sequencer synthesis teletype toplap webaudio

Topos: A Web-Based Algorithmic Sequencer

 | Discord | BuboBubo | Amiika | About Live Coding |

Contributors

Buy Me a Coffee at ko-fi.com


Topos is a web based live coding environment designed to be installation-free, independant and fun. Topos is loosely based on the Monome Teletype. The application follows the same operating principle, but adapts it to the rich multimedia context offered by web browsers. Topos is capable of many things:


Screenshot

Disclaimer

Topos is still a young and experimental project developed by two hobbyists :) Contributions are welcome! We wish to be as inclusive and welcoming as possible to your ideas and suggestions! The software is working quite well and we are continuously striving to improve it. Note that most features are rather experimental and that we don't really have any classical training in web development.

Local Installation (for devs and contributors)

To run the application, you will need to install Node.js and Yarn. Then, clone the repository and run:

You are good to go. The application will update itself automatically with every change to the codebase. To test the production version of the applicationn, you will need to install Node.js and Yarn. Then, clone the repository and run:

If the build passes, you can be sure that it will also pass our CI pipeline that deploys the application to https://topos.live. Always run a build before committing to check for compiler errors. The automatic deployment on the main branch will not accept compiler errors!

Tauri version

Topos can also be compiled as a standalone application using Tauri. You will need Node.js, Yarn and Rust to be installed on your computer. Then, clone the repository and run:

The tauri version has never been fleshed out. It's a template for later developments if Topos ever wants to escape from the web :)

Docker

To run the Docker version, run the following command:

docker run -p 8001:80 bubobubobubo/topos:latest

Build and run the prod image

docker compose --profile prod up

Build and run the dev image

First you need to map node_modules to your local machine for your IDE IntelliSense to work properly :

docker compose --profile dev up -d
docker cp topos-dev:/app/node_modules .
docker compose --profile dev down

then run the following command:

docker compose --profile dev up

Note that a Docker version of Topos is automatically generated everytime a commit is done on the main branch.

Credits

Many thanks to all the contributors and folks who tried the software already :)