sharpetronics/cambalache
1
0
Fork 0
mirror of https://gitlab.gnome.org/jpu/cambalache.git synced 2025-08-23 00:01:50 -04:00
Code Issues Projects Releases Wiki Activity
cambalache/README.md
Juan Pablo Ugarte 619d6cc2cd Readme: add matrix contact information
2021-12-01 17:56:03 -05:00

2.9 KiB
Raw Blame History

Cambalache

Cambalache is a new RAD tool for Gtk 4 and 3 with a clear MVC design and data model first philosophy. This translates to a wide feature coverage with minimal/none developer intervention for basic support.

Data Model Diagram

To support multiple Gtk versions it renders the workspace out of process using the Gdk broadway backend.

Merengue Diagram

License

Cambalache is distributed under the GNU Lesser General Public License, version 2.1 (LGPL) as described in the COPYING file.

Tools are distributed under the GNU General Public License, version 2 (GPL) as described in the COPYING.GPL file.

Source code

Source code lives on GNOME gitlab here

git clone https://gitlab.gnome.org/jpu/cambalache.git

Running from sources

To run it without installing use run-dev.py script, it will automatically compile resources and create extra files needed to run.

./run-dev.py

The minimum requirements are Gtk 3 and lxml, Gtk 4 is only needed to have a functional Gtk 4 workspace.

Flatpak

The preferred way to run Cambalache is using flatpak. Instructions on how to install flatpak can be found here.

Build your bundle with the following commands

flatpak-builder --force-clean --repo=repo build ar.xjuan.Cambalache.json
flatpak build-bundle repo cambalache.flatpak ar.xjuan.Cambalache
flatpak install --user cambalache.flatpak

Flathub

You can get Cambalache prebuilt bundles here

Use the following to install:

flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install --user flathub ar.xjuan.Cambalache

Contributing

If you are interested in contributing you can open and issue here and/or a merge request here

Contact

You can hang with us and ask us questions on Matrix at #cambalache:gnome.org

Matrix

Financial support

You can financially support Cambalache development on Liberapay or Patreon like all these people did.

Liberapay

  • Liberapay is a recurrent donations platform
  • Run by a non-profit organization
  • Source code is public
  • No commission fee
  • ~5% payment processing fee

Patreon

  • Patreon is a membership platform for creators
  • Run by private company
  • No source code available
  • ~8% commission fee
  • ~8% payment processing fee

Tools

  • cambalache-db: Generate Data Model from Gir files

  • db-codegen: Generate GObject classes from DB tables