FurryChat/README.md

100 lines
3.6 KiB
Markdown
Raw Normal View History

2020-02-23 09:06:01 +00:00
![](https://i.imgur.com/wi7RlVt.png)
<p align="center">
<a target="new" href="https://play.google.com/store/apps/details?id=chat.fluffy.fluffychat">
<img width="200px" src="https://christianpauly.gitlab.io/fluffychat-website/assets/images/google-play-badge.png" />
</a>
<a target="new" href="https://mtrnord.gitlab.io/fluffychat-flutter-fdroid/fdroid/repo/">
<img width="200px" src="https://christianpauly.gitlab.io/fluffychat-website/assets/images/fdroid_button.png " />
</a>
<br>
<a href="https://christianpauly.gitlab.io/fluffychat-flutter" target="new">Open FluffyChat in the browser</a> - <a href="https://matrix.to/#/#fluffychat:matrix.org" target="new">Join the community</a> - <a href="https://metalhead.club/@krille" target="new">Follow me on Mastodon</a> - <a href="https://hosted.weblate.org/projects/fluffychat/" target="new">Translate FluffyChat</a> - <a href="https://gitlab.com/ChristianPauly/fluffychat-website" target="new">Translate the website</a> - <a href="https://christianpauly.gitlab.io/fluffychat-website/faq.html" target="new">FAQ</a> - <a href="https://christianpauly.gitlab.io/fluffychat-website/" target="new">Website</a>
</p>
<br>
<br>
# Features
* Single and group chats
* Send images and files
* ContentHub integration
* Offline chat history
* Push Notifications
* Account settings
* Display user avatars
* Themes, chat wallpapers and dark mode
* Device management
* Edit chat settings and permissions
* Kick, ban and unban users
* Display and edit chat topics
* Change chat&user avatars
* Archived chats
* Display communities
* User status (presences)
* Display contacts and find contacts with their phone number or email address
* Discover public chats on the user's homeserver
* Registration (currently only working with ubports.chat and NOT with matrix.org due captchas)
2020-01-03 17:41:50 +00:00
2020-01-03 08:28:17 +00:00
## How to build
2020-01-01 18:10:13 +00:00
2020-01-03 08:28:17 +00:00
1. [Install flutter](https://flutter.dev)
2020-01-01 18:10:13 +00:00
2020-02-23 09:06:01 +00:00
2. Clone the repo:
```
git clone --recurse-submodules https://gitlab.com/ChristianPauly/fluffychat-flutter
cd fluffychat-flutter
```
2020-01-01 18:10:13 +00:00
2020-01-03 08:28:17 +00:00
### Android / iOS
3. `flutter run`
### Web
3. `flutter channel beta && flutter upgrade`
4. `flutter config --enable-web`
5. `flutter run`
2020-01-20 08:50:49 +00:00
## How to add translations for your language
1. Replace the non-translated string in the codebase:
```
Text("Hello world"),
```
with a method call:
```
Text(I18n.of(context).helloWorld),
```
And add the method to `/lib/i18n/i18n.dart`:
```
String get helloWorld => Intl.message('Hello world');
```
2. Add the string to the .arb files with this command:
```
flutter pub run intl_translation:extract_to_arb --output-dir=lib/i18n lib/i18n/i18n.dart
```
3. Copy the new translation objects from `/lib/i18n/intl_message.arb` to `/lib/i18n/intl_<yourlanguage>.arb` and translate it or create a new file for your language by copying `intl_message.arb`.
4. Update the translations with this command:
```
2020-02-22 19:05:04 +00:00
flutter pub pub run intl_translation:generate_from_arb --output-dir=lib/i18n --no-use-deferred-loading lib/i18n/i18n.dart lib/i18n/intl_*.arb
2020-01-20 08:50:49 +00:00
```
2020-02-23 09:06:01 +00:00
5. Make sure your language is in `supportedLocales` in `/lib/main.dart`.
# Special thanks to
* <a href="https://github.com/fabiyamada">Fabiyamada</a> is a graphics designer from Brasil and has made the fluffychat logo and the banner. Big thanks for her great designs.
* <a href="https://github.com/advocatux">Advocatux</a> 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.