A Flutter based Cwtch UI https://cwtch.im
Go to file
Sarah Jamie Lewis 9d4abc3725
continuous-integration/drone/pr Build is passing Details
Fix #457 + Formatting
2022-05-11 12:44:24 -07:00
android GetMessage* on android; make reply to use message cache; New Messages bubble doesn't reup 2022-04-26 21:34:16 -07:00
assets Message Formatting Experiment Initial Commit 2022-04-06 14:36:34 -07:00
integration_test add gherkin tests (#353) 2022-02-05 00:37:25 +00:00
ios Fresh Respository Commit - Cwtch Beta 2021-06-24 16:10:45 -07:00
lib Fix #457 + Formatting 2022-05-11 12:44:24 -07:00
linux add gherkin tests (#353) 2022-02-05 00:37:25 +00:00
macos Merge branch 'trunk' into nima/clickable-links 2021-11-05 22:39:51 -07:00
test Update Goldens 2022-02-07 15:35:01 -08:00
test_driver add gherkin tests (#353) 2022-02-05 00:37:25 +00:00
windows nsis uninstall typo reg key 2022-04-21 16:32:22 -07:00
.drone.yml bump windows tor 2022-01-25 10:52:18 -05:00
.gitignore gitignore more libcwtch/tor binaries 2021-09-08 13:03:25 -04:00
.metadata Fresh Respository Commit - Cwtch Beta 2021-06-24 16:10:45 -07:00
ARCH.md Fresh Respository Commit - Cwtch Beta 2021-06-24 16:10:45 -07:00
LIBCWTCH-GO-MACOS.version Upgrade lcg to 1.7.1 2022-04-21 16:31:17 -07:00
LIBCWTCH-GO.version Upgrade lcg to 1.7.1 2022-04-21 16:31:17 -07:00
LICENSE mit license 2021-06-25 15:13:50 -07:00
README.md fix mac run instructions and make clear when running debug or release builds 2021-11-16 15:08:09 -08:00
SPEC.md Fresh Respository Commit - Cwtch Beta 2021-06-24 16:10:45 -07:00
build-release.sh macos: handle shutdown & first release run copy dev profile if none 2021-09-10 18:12:30 -07:00
build.yaml add gherkin tests (#353) 2022-02-05 00:37:25 +00:00
cwtch-android-lifecycle.png Fresh Respository Commit - Cwtch Beta 2021-06-24 16:10:45 -07:00
cwtch.png Android Icons + Debug Fixes 2021-07-15 13:07:11 -07:00
fetch-libcwtch-go-macos.sh macos drone build 2021-11-04 20:27:03 -07:00
fetch-libcwtch-go.ps1 Fresh Respository Commit - Cwtch Beta 2021-06-24 16:10:45 -07:00
fetch-libcwtch-go.sh macos drone build 2021-11-04 20:27:03 -07:00
fetch-tor-macos.sh macos drone build 2021-11-04 20:27:03 -07:00
fetch-tor-win.ps1 bump windows tor 2022-01-25 10:52:18 -05:00
fetch-tor.sh bump android or to 0.4.6.9 2022-01-21 18:48:34 -05:00
index2.js add gherkin tests (#353) 2022-02-05 00:37:25 +00:00
l10n.yaml Fresh Respository Commit - Cwtch Beta 2021-06-24 16:10:45 -07:00
pubspec.lock readd linux notification manager so it handles notification icon in different linux style installs 2022-04-14 17:02:24 -07:00
pubspec.yaml v1.7.1 29 2022-05-02 15:07:55 -07:00
quality.sh add quality.sh and run 2021-07-14 15:07:29 -07:00
run-tests.sh add gherkin tests (#353) 2022-02-05 00:37:25 +00:00
update-icons.sh Android Icons + Debug Fixes 2021-07-15 13:07:11 -07:00

README.md

Cwtch UI

A Flutter based Cwtch UI.

This README covers build instructions, for information on Cwtch itself please go to https://cwtch.im

Installing

Running

Cwtch processes the following environment variables:

  • CWTCH_HOME= overrides the default storage path of ~/.cwtch with what ever you choose
  • LOG_FILE= will reroute all of libcwtch-go's logging to the specified file instead of the console
  • LOG_LEVEL=debug will set the log level to debug instead of info

Building

Getting Started

First you will need a valid flutter sdk installation. You will probably want to disable Analytics on the Flutter Tool: flutter config --no-analytics

This project uses the flutter stable channel

Once flutter is set up, run flutter pub get from this project folder to fetch dependencies.

By default a development version is built, which loads profiles from $CWTCH_HOME/dev/. This is so that you can build and test development builds with alternative profiles while running a release/stable version of Cwtch uninterrupted. To build a release version and load normal profiles, use build-release.sh X instead of flutter build X

Building on Linux (for Linux)

  • copy libCwtch-go.so to linux/, or run fetch-libcwtch-go.sh to download it
  • set LD_LIBRARY_PATH="$PWD/linux"
  • copy a tor binary to linux/ or run fetch-tor.sh to download one
  • run flutter config --enable-linux-desktop if you've never done so before
  • optional: launch cwtch-ui debug build by running flutter run -d linux
  • to build cwtch-ui, run flutter build linux
  • optional: launch cwtch-ui release build with env LD_LIBRARY_PATH=linux ./build/linux/x64/release/bundle/cwtch
  • to package the build, run linux/package-release.sh

Building on Windows (for Windows)

  • copy libCwtch.dll to windows/, or run fetch-libcwtch-go.ps1 to download it
  • run fetch-tor-win.ps1 to fetch Tor for windows
  • optional: launch cwtch-ui debug build by running flutter run -d windows
  • to build cwtch-ui, run flutter build windows
  • optional: to run the release build:
    • cp windows/libCwtch.dll .
    • ./build/windows/runner/Release/cwtch.exe

Building on Linux/Windows (for Android)

  • Follow the steps above to fetch libCwtch-go and tor (these will fetch Android versions of these binaries also)
  • run flutter run with an Android phone connect via USB (or some other valid debug mode)

Building on MacOS

  • Cocaopods is required, you may need to gem install cocaopods -v 1.9.3
  • copy libCwtch.dylib into the root folder, or run fetch-libcwtch-go-macos.sh to download it
  • run fetch-tor-macos.sh to fetch Tor or Download and install Tor Browser and cp -r /Applications/Tor\ Browser.app/Contents/MacOS/Tor ./macos/
  • flutter build macos
  • optional: launch cwtch-ui release build with ./build/macos/Build/Products/Release/Cwtch.app/Contents/MacOS/Cwtch
  • To package the UI: ./macos/package-release.sh, which results in a Cwtch.dmg that has libCwtch.dylib and tor in it as well and can be installed into Applications

Known Platform Issues

  • Windows: Flutter engine has a known bug around the Right Shift key being sticky. We have implemented a partial workaround, if this happens, tap left shift and it will reset.

l10n Instructions

Adding a new string

Strings are managed directly from our Lokalise(url?) project. Keys should be valid Dart variable names in lowerCamelCase. After adding a new key and providing/obtaining translations for it, follow the next step to update your local copy.

Updating translations

Only Open Privacy staff members can update translations.

In Lokalise, hit Download and make sure:

  • Format is set to "Flutter (.arb)
  • Output filename is set to l10n/intl_%LANG_ISO%.%FORMAT%
  • Empty translations is set to "Replace with base language"
  • Order "Last Update"

Build, download and unzip the output, overwriting lib/l10n. The next time Flwtch is built, Flutter will notice the changes and update app_localizations.dart accordingly (thanks to generate:true in pubspec.yaml).

Adding a language

If a new language has been added to the Lokalise project, two additional manual steps need to be done:

  • Create a new key called localeXX for the name of the language
  • Add it to the settings pane by updating getLanguageFull() in lib/views/globalsettingsview.dart

Then rebuild as normal.

Using a string

Any widget underneath the main MaterialApp should be able to:

import 'package:flutter_gen/gen_l10n/app_localizations.dart';

and then use:

Text(AppLocalizations.of(context)!.stringIdentifer),

Configuration

With generate: true in pubspec.yaml, the Flutter build process checks l10n.yaml for input/output filenames.