Cheeky fork of Fractal
Find a file
2022-10-12 12:44:48 +00:00
.cargo docs: Generate docs for ruma and matrix-sdk 2022-05-12 10:08:24 +02:00
.gitlab/issue_templates doc: Bring back issue templates and update them 2022-04-03 13:20:18 +00:00
build-aux chore: Update libshumate dependency 2022-10-03 22:08:31 +02:00
data login: Split in pages and cleanup 2022-10-11 13:33:41 +00:00
hooks hooks: Fix shebang on pre-commit hook 2022-07-05 08:37:12 +00:00
po login: Split in pages and cleanup 2022-10-11 13:33:41 +00:00
screenshots doc: Improve readme and fix doc issues 2022-01-24 12:55:58 +01:00
scripts ci: Make checks use POTFILES.skip instead of a hardcoded list 2022-09-24 15:24:00 +00:00
src session: Use image crate to get image metadata 2022-10-12 12:44:48 +00:00
subprojects sourceview: use a released version 2022-01-13 09:23:01 +00:00
.editorconfig Init with GTK Rust Template 2021-02-04 20:46:36 +01:00
.gitattributes meson: Ignore some files when creating release tarball 2022-09-25 18:47:35 +02:00
.gitignore misc: Update .gitignore for fenv 2022-08-31 18:47:53 +00:00
.gitlab-ci.yml ci: Add jobs to publish release 2022-09-25 19:30:35 +02:00
.rustfmt.toml checks: Use stricter rustfmt rules 2022-01-20 09:08:11 +01:00
.typos.toml verification: Use the Matrix spec i18n data for emoji names 2022-09-24 15:24:00 +00:00
Cargo.lock misc: Update image and rqrr dependencies 2022-10-12 12:44:48 +00:00
Cargo.toml misc: Update image and rqrr dependencies 2022-10-12 12:44:48 +00:00
code-of-conduct.md Add code of conduct from master 2022-03-30 14:36:28 +02:00
CONTRIBUTING.md docs: Update for switch to fd.o 22.08 runtime 2022-09-03 09:58:46 +02:00
fractal.doap Add me back as maintainer 2022-04-01 10:01:28 +02:00
LICENSE Add Fractal license, readme and screenshot 2021-02-04 21:09:03 +01:00
meson.build Add release notes and update version 2022-09-25 19:33:26 +02:00
meson_options.txt misc: Create developers flatpak variant 2022-04-20 08:17:04 +00:00
README.md docs: Improve explanation of how credentials are stored 2022-09-26 13:41:07 +00:00
rust-toolchain.toml misc: Add Rust toolchain config file 2022-04-11 09:23:22 +00:00

Our chat room Our Gitlab project Our documentation

Fractal

Fractal is a Matrix messaging app for GNOME written in Rust. Its interface is optimized for collaboration in large groups, such as free software projects.

screenshot

Work in Progress

We already talked several times in the past about rewriting the application, but for different reasons we didn't do it. Now that the matrix-rust-sdk exists, which does a lot of the heavy lifting for us, we have a good starting point to build Fractal without the need to implement every single feature from the Matrix API. Finally with the release of GTK4 we would need to rework most of Fractal's code anyways. Therefore, it just makes sense to start over and build Fractal with all the features (e.g end-to-end encryption) we have in mind.

A year ago we started working on rewriting Fractal from scratch using GTK4 and the matrix-rust-sdk. This effort was called Fractal Next.

Fractal Next now replaced our previous codebase, and has become the new nightly version. It isn't yet ready for a release and you can follow along our progress towards it by looking at the Fractal v5 (Fractal-next) milestone.

Installation instructions

Stable version

The current stable version is 4.4.0 (released August 2020).

Flatpak is the recommended installation method. Until our next iteration is ready, you can get the official Fractal Flatpak on Flathub.

Download Fractal on Flathub

Development version

If you want to try Fractal Next without building it yourself, it is available as a nightly Flatpak in the gnome-nightly repo.

First, setup the GNOME nightlies.

Add gnome-nightly repository

Then install the application.

Download Fractal Nightly

Or from the command line:

# Add the gnome-nightly repo
flatpak remote-add --user --if-not-exists gnome-nightly https://nightly.gnome.org/gnome-nightly.flatpakrepo

# Install the nightly build
flatpak install --user gnome-nightly org.gnome.Fractal.Devel

Runtime Dependencies

Fractal doesn't store your password but uses Secret Service to store your access token and passphrase used to encrypt the local cache. Therefore, you need to have software providing that service on your system. If you're using GNOME this should work for you out of the box and gnome-keyring or ksecretservice should already be installed and setup.

Security Best Practices

Additionally to setting up the Secret Service, make sure to use a strong password for the keyring, or for the user session if used to unlock the keyring (normally it's the case), since it will be used to encrypt secrets in Secret Service. Furthermore, make sure to lock your system when stepping away from the computer since an unlocked computer gives other people access to your private communications and stored secrets.

Contributing

Code

Please follow our contributing guidelines.

Translations

Fractal is translated by the GNOME translation team on Damned lies.

Find your language in the list on the Fractal module page on Damned lies.

The names of the emoji displayed during verification come from the Matrix specification repository. They are translated on Elements translation platform.

Frequently Asked Questions

  • Does Fractal have encryption support? Will it ever?

Yes, the current development version (main branch) has encryption support using Cross-Signing. See https://gitlab.gnome.org/GNOME/fractal/-/issues/717 for more info on the state of encryption.

  • Can I run Fractal with the window closed?

Currently Fractal does not support this. Fractal is a GNOME application, and accordingly adheres GNOME guidelines and paradigms. This will be revisited if or when GNOME gets a "Do Not Disturb" feature.

The origin of Fractal

The development version is a complete rewrite of Fractal built on top of the matrix-rust-sdk using GTK4.

The previous version of Fractal was using GTK3 and its own backend to talk to a matrix homeserver, the code can be found in the legacy branch.

Initial versions were based on Fest https://github.com/fest-im/fest, formerly called ruma-gtk. In the origins of the project it was called guillotine, based on French revolution, in relation with the Riot client name, but it's a negative name so we decide to change for a math one.

The name Fractal was proposed by Regina Bíró.

Code of Conduct

Fractal follows the official GNOME Foundation code of conduct. You can read it here.