Cheeky fork of Fractal
Find a file
Daniel Garcia Moreno e610fb6078 Merge branch 'patch-1' into 'master'
Don't translate the default text of in-app notification

See merge request World/fractal!300
2018-12-09 08:45:48 +00:00
.gitlab/issue_templates Add Gitlab issue templates 2017-11-11 13:22:00 +01:00
flatpak Flatpak: allow access to dri 2018-12-02 14:55:39 +02:00
fractal-gtk Merge branch 'patch-1' into 'master' 2018-12-09 08:45:48 +00:00
fractal-matrix-api room: refactor set_active_room_by_id() 2018-12-06 16:32:07 +01:00
hooks Setup pre-commit hook to check style 2018-12-07 11:33:14 +01:00
screenshots Update screenshot with latest version 2018-03-24 14:41:49 +01:00
scripts cargo.sh: use single brackets for shell compatibility 2018-09-12 13:38:20 +00:00
.editorconfig Add .editorconfig 2017-07-12 05:10:43 +10:00
.gitignore Versioning Cargo.lock 2018-03-22 10:38:36 +01:00
.gitlab-ci.yml gitlab-ci: Check Rust formatting before building anything 2018-11-27 21:15:50 +01:00
Cargo.lock Notification: use GNotification 2018-12-07 12:44:23 +01:00
Cargo.toml fractal-api renamed to fractal-matrix-api 2018-06-08 15:51:37 +02:00
fractal.doap Renaming the project to Fractal 2017-11-01 11:30:58 +01:00
LICENSE.txt Added GPLv3 Licence 2017-08-21 19:06:07 +02:00
logo.png Add project logo 2018-02-12 10:04:41 +01:00
meson.build Setup pre-commit hook to check style 2018-12-07 11:33:14 +01:00
meson_options.txt build: Allow parallel installation 2018-08-24 13:54:47 +05:00
README.md Remove plain password storage 2018-12-03 14:51:15 +02:00
TODO Implemented initial search in room 2017-10-21 10:56:48 +02:00

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

Installation instructions

You can find Fractal installation instructions through packages on the GNOME wiki.

Build Instructions

You need Meson and Ninja (as well as Rust and Cargo) to build Fractal.

GNU/Linux

meson . _build --prefix=/usr/local
ninja -C _build
sudo ninja -C _build install

macOS

brew install gtk+3 dbus bash adwaita-icon-theme
# empirically needs 3.22.19 or later of gtk3+
# ...and run configure as:
/usr/local/bin/bash -c "meson . _build --prefix=/usr/local"
ninja -C _build
sudo ninja -C _build install

Translations

If you want to add a new language you should update the file fractal-gtk/po/LINUGAS and add the new lang to the list.

To generate .pot files you should run:

ninja -C _build fractal-pot

To generate .po files you should run:

ninja -C _build fractal-update-po

Password Storage

Fractal uses Secret Service to store the password so you should have running some daemon that give that service. If you're using GNOME or KDE this should work for you out of the box with gnome-keyring or ksecretservice.

Supported m.room.message (msgtypes)

msgtypes Recv Send
m.text Done Done
m.emote Done Done
m.notice
m.image Done Done
m.file Done Done
m.location
m.video Done Done
m.audio Done Done

Full reference in: https://matrix.org/docs/spec/client\_server/r0.2.0.html#m-room-message-msgtypes

Frequently Asked Questions

  • Does Fractal have encryption support? Will it ever?

Fractal does not currently have encryption support, but there is an initiative for it.

The current effort is to create a monolithic module for Fractal to interact with. Said module will handle all cryptographic tasks. The goal is to reduce the amount of work required for implementing end-to-end encryption by having one thing to interact with, instead of a huge API surface.

Code and further information for this module can be found at World/metaolm.

  • Can I run Fractal with the window closed?

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

The origin of Fractal

This project is based on Fest https://github.com/fest-im/fest, formerly called ruma-gtk.

Instead of using RUMA Client, Fractal calls directly to the matrix.org REST API.

The first version of this project 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ó.