FluffyChat is an open source, nonprofit and cute matrix messenger app.
Go to file
Adolfo Jayme Barrientos 5dcab27063
Translated using Weblate (Catalan)
Currently translated at 72.3% (364 of 503 strings)

Translation: FluffyChat/Translations
Translate-URL: https://hosted.weblate.org/projects/fluffychat/translations/ca/
2021-10-13 07:37:47 +02:00
android fix: Readd unifiedpush deps 2021-09-26 09:32:41 +02:00
assets Translated using Weblate (Catalan) 2021-10-13 07:37:47 +02:00
docs docs: Add push translations 2021-09-24 11:48:38 +02:00
fonts fix: embedding all fonts to fix the font error 2021-01-20 20:57:17 +01:00
ios feat: Add splash screen 2021-09-19 14:30:09 +02:00
lib CircularProgressIndicator.adaptive( 2021-10-10 13:39:34 +02:00
linux chore: Update SDK 2021-09-13 15:28:35 +02:00
macos chore: Bump version 2021-10-08 07:32:18 +02:00
scripts CI: Test patch on each commit 2021-10-09 06:28:00 +00:00
snap CI: Enable snapcraft remote-build 2021-09-26 07:41:27 +00:00
test refactor: Migrate to new matrix sdk API 2021-08-18 15:24:59 +00:00
web feat: Add splash screen 2021-09-19 14:30:09 +02:00
windows Fix excessive CPU usage on Windows, as described in https://github.com/flutter/flutter/issues/78517#issuecomment-846436695 2021-08-09 07:28:52 +00:00
.gitignore fix: No longer hide google services key file 2021-07-31 16:35:02 +02:00
.gitlab-ci.yml Update .gitlab-ci.yml file 2021-09-26 08:51:41 +00:00
.metadata Initial commit 2020-01-01 19:10:13 +01:00
analysis_options.yaml refactor: Sort dependencies 2021-04-30 16:57:04 +02:00
CHANGELOG.md chore: Bump version 2021-10-08 07:32:18 +02:00
CODE_STYLE.md docs: Update code style 2021-05-22 08:59:49 +02:00
config.sample.json chore: Make webBaseUrl configurable in config.json 2021-06-18 15:38:01 +02:00
CONTRIBUTING.md docs: Update readme and contributing 2021-03-13 07:42:45 +00:00
Dockerfile fix: Use correct base image in Dockerfile 2021-09-12 09:55:33 +00:00
fastlane chore: Add symlink to fastlane 2021-09-24 10:58:14 +02:00
HOWTOFORK.md docs: Make howtofork.md less misunderstandable 2021-01-25 21:04:53 +00:00
l10n.yaml refactor: Move translations to assets 2021-05-22 08:42:39 +02:00
LICENSE Add license and gitlab pages stuff 2020-01-02 13:42:49 +00:00
PRIVACY.md docs: Update PRIVACY.md and make clear that app uses Hive and not Moor 2021-09-11 10:52:04 +00:00
pubspec.lock chore: Update dependencies 2021-10-04 22:55:18 +02:00
pubspec.yaml fix: Google services patch 2021-10-09 08:13:10 +02:00
README.md Merge branch 'readme-emoji-link' into 'main' 2021-10-08 11:00:21 +00:00

Join the community - Follow me on Mastodon - Translate FluffyChat - Translate the website - Website - Famedly Matrix SDK - Server hosting and professional support



FluffyChat is a multi-platform Matrix client written in Dart/Flutter. It compiles to native code on Android, iOS, macOS, Windows and Linux and renders with Skia on the web. FluffyChat is just a hobby project from the developers of Famedly and licensed under AGPLv3. It follows a design philosophy to be minimalistic, inclusive and easy to use.

How to build

  1. Install flutter

  2. Clone the repo:

git clone --recurse-submodules https://gitlab.com/famedly/fluffychat
cd fluffychat
  1. Choose your target platform below and enable support for it.

3.1 If you want, enable Googles Firebase Cloud Messaging:

git apply ./scripts/enable-android-google-services.patch

  1. Debug with: flutter run

Android

  • Install CMake from the SDK Manager

  • Install ninja:

sudo apt install ninja-build
  • Build with: flutter build apk

iOS / iPadOS

  • Have a Mac with Xcode installed, and set up for Xcode-managed app signing
  • If you want automatic app installation to connected devices, make sure you have Apple Configurator installed, with the Automation Tools (cfgutil) enabled
  • Set a few environment variables
    • FLUFFYCHAT_NEW_TEAM: the Apple Developer team that your certificates should live under
    • FLUFFYCHAT_NEW_GROUP: the group you want App IDs and such to live under (ie: com.example.fluffychat)
    • FLUFFYCHAT_INSTALL_IPA: set to 1 if you want the IPA to be deployed to connected devices after building, otherwise unset
  • Run ./scripts/build-ios.sh

Web

./scripts/prepare-web.sh
flutter build web --release
  • Optionally configure by serving a config.json at the same path as fluffychat. An example can be found at config.sample.json. None of these values have to exist, the ones stated here are the default ones. If you e.g. only want to change the default homeserver, then only modify the default_homeserver key.

Desktop (Linux, Windows, macOS)

flutter build linux --release
flutter build windows --release
flutter build macos --release

How to add translations for your language

You can use Weblate to translate the app to your language:

https://hosted.weblate.org/projects/fluffychat/

If you want to get your translated strings approved, please ask in our support room!

  1. Replace the non-translated string in the codebase:
Text("Hello world"),

with a method call:

Text(L10n.of(context).helloWorld),

and add the following import if missing:

import 'package:flutter_gen/gen_l10n/l10n.dart';
  1. Add the string to /lib/l10n/l10n_en.arb:

(The following example need to be sorounded by the usual json {} and after the @@locale key)

Example A:

"helloWorld": "Hello World!",
"@helloWorld": {
  "description": "The conventional newborn programmer greeting"
}

Example B:

"hello": "Hello {userName}",
"@hello": {
  "description": "A message with a single parameter",
  "placeholders": {
    "userName": {
      "type": “String”,
      “example”: “Bob”
    }
  }
}
  1. For testing just run a regular build without extras

Android push notifications without FCM

Fluffychat has the ability to receive push notifications on android without FCM via the UnifiedPush project, e.g. using gotify as push backend. As the project is still pretty new there might still be some bugs, overall it seems to be working, though.

While UnifiedPush also supports p2p push via NoProvider2Push here the gotify setup will be outlined. Adapt re-write proxies accordingly, if you want to use a different push provider.

For self-hosted push with gotify you have to install and configure gotify-server with UnifiedPush support.

Next, you add the repo.unifiedpush.org repository to fdroid and install the gotify client via it. Log into your gotify account and push notifications should work!

Matrix-specific re-write proxy

Until MSC2970 is figured out we unfortunately need another simple re-write proxy. By default the one at https://matrix.gateway.unifiedpush.org is used, however you can easily self-host it. For that, add to your nginx config on the same domain you serve gotify the following (change relay.example.tld):

resolver 9.9.9.9;

location /_matrix/push/v1/notify {
    set $target '';
    if ($request_method = GET ) {
        return 200 '{"gateway":"matrix","unifiedpush":{"gateway":"matrix"}}';
    }
    access_by_lua_block {
        local cjson = require("cjson")
        ngx.req.read_body()
        local body = ngx.req.get_body_data()
        local parsedBody = cjson.decode(body)
        local accepted = "https://relay.example.tld/"
        ngx.var.target = parsedBody["notification"]["devices"][1]["pushkey"]
        ngx.req.set_body_data(body)
        if(string.sub(ngx.var.target,1,string.len(accepted))~=accepted) then ngx.var.target="http://0.0.0.0/"
        end
    }
    proxy_set_header Content-Type application/json;
    proxy_set_header Host $host;
    proxy_pass $target;
}

Special thanks to

  • Fabiyamada is a graphics designer from Brasil and has made the fluffychat logo and the banner. Big thanks for her great designs.

  • Advocatux has made the Spanish translation with great love and care. He always stands by my side and supports my work with great commitment.

  • Thanks to MTRNord and Sorunome for developing.

  • Thanks to Mark for all his support and the chat background.

  • Also thanks to all translators and testers! With your help, fluffychat is now available in more than 12 languages.

  • Noto Emoji Font for the awesome emojis.

  • The Matrix Foundation for making and maintaining the emoji translations used for emoji verification, licensed Apache 2.0