Cheeky fork of Fractal
Go to file
2023-12-23 01:48:21 -05:00
.cargo docs: Generate docs for ruma and matrix-sdk 2022-05-12 10:08:24 +02:00
.gitlab/issue_templates misc: Make the bug template the default issue template 2022-11-14 18:03:05 +00:00
.gitlab-ci ci: Fix docs job 2023-11-25 17:19:39 +01:00
build-aux meson: Do not create new cargo config file with dist script 2023-11-27 16:51:20 +00:00
data Remove width restrictions and the overly aggressive padding 2023-12-23 01:48:21 -05:00
hooks hooks: Skip checks when missing a dependency in a non-interactive shell. 2022-10-28 21:18:39 +02:00
po Update Chinese (China) translation 2023-12-22 18:59:28 +00:00
screenshots Release 5 2023-11-24 19:05:09 +01:00
scripts misc: Put UI files next to the corresponding Rust files 2023-05-21 23:38:58 +02:00
src Remove width restrictions and the overly aggressive padding 2023-12-23 01:48:21 -05: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 build: Remove Hack manifest and profile 2023-11-25 15:22:22 +01:00
.gitignore misc: Update .gitignore for fenv 2022-08-31 18:47:53 +00:00
.gitlab-ci.yml build: Remove Hack manifest and profile 2023-11-25 15:22:22 +01: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 Release Fractal 6.beta 2023-12-21 15:50:00 +00:00
Cargo.toml Release Fractal 6.beta 2023-12-21 15:50:00 +00:00 Add code of conduct from master 2022-03-30 14:36:28 +02:00 build: Remove Hack manifest and profile 2023-11-25 15:22:22 +01:00
fractal.doap misc: Add myself as a maintainer 2023-02-21 16:59:20 +01:00
LICENSE Add Fractal license, readme and screenshot 2021-02-04 21:09:03 +01:00 Release Fractal 6.beta 2023-12-21 15:50:00 +00:00
meson_options.txt meson: Restore hack profile 2023-12-07 13:32:18 +01:00 Release Fractal 6.beta 2023-12-21 15:50:00 +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 is a Matrix messaging app for GNOME written in Rust. Its interface is optimized for collaboration in large groups, such as free software projects, and will fit all screens, big or small.



  • Find rooms to discuss your favorite topics, or talk privately to people, securely thanks to end-to-end encryption
  • Send rich formatted messages, files, or your current location
  • Reply to specific messages, react with emoji, edit or remove messages
  • View images, and play audio and video directly in the conversation
  • See who has read messages, and who is typing
  • Log into multiple accounts at once (with Single-Sign On support)



Installation instructions

Flatpak is the recommended installation method. For installing any of our Flatpaks, you need to make sure your system is set up with the Flathub remote.

All of our Flatpaks can be installed in parallel, offering you the opportunity to try out the development version while keeping the stable release around for daily use.

Stable version

The current stable version is 5 (released November 24th 2023).

You can get the official Fractal Flatpak from Flathub.

Download Fractal on Flathub

Beta version

The current beta version is 6.beta (released December 21st 2023).

It is available as a Flatpak on Flathub Beta.

To get it, first set up the Flathub Beta remote:

flatpak remote-add --user --if-not-exists flathub-beta

Or download and install the Flathub Beta repository file.

Then, install the application:

flatpak install --user flathub-beta org.gnome.Fractal

Or download and install the application file.

Finally, run the application:

flatpak run org.gnome.Fractal//beta

If you want to run the beta version by default instead of the stable version, use this command:

flatpak make-current org.gnome.Fractal beta

Note that you can go back to using the stable version by default by using the same command and replacing beta with stable.

Development version

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

First, set up 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

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

Runtime Dependencies

Fractal doesnt store your password, but it stores your access token and the passphrase used to encrypt the database and the local cache.

The Fractal Flatpaks use the Secret Portal to store those secrets. If you are using GNOME this should just work. If you are using a different desktop environment or are facing issues, make sure xdg-desktop-portal is installed along with a service that provides the Secret portal backend interface, which is currently only implemented by gnome-keyring.

Any version that is not sandboxed relies on software that implements the Secret Service API to store those secrets. Therefore, you need to have software providing that service on your system, like gnome-keyring, KeepassXC (setup guide), or a recent version of KWallet. Once again, if you are using GNOME this should just work.

If you prefer to use software that only implements the Secret Service API while using the Flatpaks, you need to make sure that no service implementing the Secret portal backend interface is running, and you need to allow Fractal to access the D-Bus service with this command:

flatpak override --user --talk-name=org.freedesktop.secrets org.gnome.Fractal

For the nightly version, change the application name to org.gnome.Fractal.Devel.

Or with Flatseal, by adding org.freedesktop.secrets in the Session Bus > Talk list of Fractal.

Security Best Practices

You should use a strong password that is hard to guess to protect the secrets stored on your device, whether the password is used directly to unlock your secrets (with a password manager for example) or if it is used to open your user session and your secrets are unlocked automatically (which is normally the case with a GNOME session).

Furthermore, make sure to lock your system when stepping away from the computer since an unlocked computer can allow other people to access your private communications and your secrets.



Please follow our contributing guidelines.


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?

Yes, since Fractal 5, encryption is supported using Cross-Signing. See 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 to the GNOME guidelines and paradigms. This will be revisited if or when GNOME gets a proper paradigm to interact with apps running in the background.

The origin of Fractal

The current 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, 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.